curl --request POST \
--url https://cloud-api.near.ai/v1/admin/access-tokens \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expires_in_hours": 123,
"name": "<string>",
"reason": "<string>",
"permission": "read_write"
}
'import requests
url = "https://cloud-api.near.ai/v1/admin/access-tokens"
payload = {
"expires_in_hours": 123,
"name": "<string>",
"reason": "<string>",
"permission": "read_write"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expires_in_hours: 123,
name: '<string>',
reason: '<string>',
permission: 'read_write'
})
};
fetch('https://cloud-api.near.ai/v1/admin/access-tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cloud-api.near.ai/v1/admin/access-tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'expires_in_hours' => 123,
'name' => '<string>',
'reason' => '<string>',
'permission' => 'read_write'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cloud-api.near.ai/v1/admin/access-tokens"
payload := strings.NewReader("{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cloud-api.near.ai/v1/admin/access-tokens")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cloud-api.near.ai/v1/admin/access-tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}"
response = http.request(request)
puts response.read_body{
"access_token": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"name": "<string>",
"permission": "read_only",
"reason": "<string>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}Create admin access token (Admin only)
Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.
Creates an access token for admin users with customizable expiration time, IP address, and user agent. This is typically used by billing services and other automated systems that need access to admin endpoints.
Security Note: These tokens can have very long expiration times and should be used with caution. Store them securely and rotate them regularly.
Admin permissions: admin session only. Both read_only and read_write admin tokens receive HTTP 403 with error.type forbidden.
curl --request POST \
--url https://cloud-api.near.ai/v1/admin/access-tokens \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expires_in_hours": 123,
"name": "<string>",
"reason": "<string>",
"permission": "read_write"
}
'import requests
url = "https://cloud-api.near.ai/v1/admin/access-tokens"
payload = {
"expires_in_hours": 123,
"name": "<string>",
"reason": "<string>",
"permission": "read_write"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expires_in_hours: 123,
name: '<string>',
reason: '<string>',
permission: 'read_write'
})
};
fetch('https://cloud-api.near.ai/v1/admin/access-tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cloud-api.near.ai/v1/admin/access-tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'expires_in_hours' => 123,
'name' => '<string>',
'reason' => '<string>',
'permission' => 'read_write'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cloud-api.near.ai/v1/admin/access-tokens"
payload := strings.NewReader("{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cloud-api.near.ai/v1/admin/access-tokens")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cloud-api.near.ai/v1/admin/access-tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expires_in_hours\": 123,\n \"name\": \"<string>\",\n \"reason\": \"<string>\",\n \"permission\": \"read_write\"\n}"
response = http.request(request)
puts response.read_body{
"access_token": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"created_by_user_id": "<string>",
"expires_at": "2023-11-07T05:31:56Z",
"id": "<string>",
"name": "<string>",
"permission": "read_only",
"reason": "<string>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>",
"param": "<string>"
}
}Authorizations
Body
Admin access token request model
Response
Admin access token created successfully
Admin access token response model
Immutable admin-token permission across organizations. Read-only tokens can invoke explicitly approved reads (including pricing/deprecation previews and database-encryption scans), but cannot mutate business state. Usage bookkeeping and audit logging remain enabled. Both permissions are forbidden from creating, listing, or revoking admin tokens; those require an admin session.
read_only, read_write