Verify API key
curl --request GET \
--url https://versuno.ai/api/public/auth/verify \
--header 'Authorization: <api-key>'import requests
url = "https://versuno.ai/api/public/auth/verify"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://versuno.ai/api/public/auth/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://versuno.ai/api/public/auth/verify"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://versuno.ai/api/public/auth/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://versuno.ai/api/public/auth/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://versuno.ai/api/public/auth/verify")
.header("Authorization", "<api-key>")
.asString();using RestSharp;
var options = new RestClientOptions("https://versuno.ai/api/public/auth/verify");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"username": "kostek",
"fullName": "Kostek Sytnyk",
"email": "kostek@versuno.ai"
}{
"error": "Invalid API key"
}{
"error": "Not found"
}Authentication
Verify API key
Validates the API key supplied in the Authorization header and returns the caller’s identity. Use this as the first call in any CLI or integration to confirm the key is valid and retrieve the user it belongs to.
GET
/
auth
/
verify
Verify API key
curl --request GET \
--url https://versuno.ai/api/public/auth/verify \
--header 'Authorization: <api-key>'import requests
url = "https://versuno.ai/api/public/auth/verify"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://versuno.ai/api/public/auth/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://versuno.ai/api/public/auth/verify"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://versuno.ai/api/public/auth/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://versuno.ai/api/public/auth/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://versuno.ai/api/public/auth/verify")
.header("Authorization", "<api-key>")
.asString();using RestSharp;
var options = new RestClientOptions("https://versuno.ai/api/public/auth/verify");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"username": "kostek",
"fullName": "Kostek Sytnyk",
"email": "kostek@versuno.ai"
}{
"error": "Invalid API key"
}{
"error": "Not found"
}Call this endpoint after the user provides an API key to your CLI or tool to confirm it is valid
and to display who they are authenticated as.
Sensitive fields such as billing details, payment method, and social links are intentionally excluded from this response.
Authorizations
Versuno API key. Must be prefixed with Bearer. Format: Bearer uk_live_...
Response
API key is valid. Returns the caller's identity.
Unique identifier of the authenticated user.
Example:
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
The user's unique username.
Example:
"kostek"
The user's display name.
Example:
"Kostek Sytnyk"
The user's email address.
Example:
"kostek@versuno.ai"
Was this page helpful?

