curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.example.com/api/admin/keys' \
--header 'Content-Type: application/json' \
--data '{
"orgId": "string",
"label": "Replacement tent pole set",
"bootstrapSecret": "YOUR_API_KEY"
}'
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"key": "string",
"orgId": "string",
"label": "Replacement tent pole set"
}
Create an admin key
With a bearer key for your own org, or — once, for a new org — bootstrapSecret (the server’s ADMIN_BOOTSTRAP_SECRET) and no bearer. The key is returned once.
POST
/
api
/
admin
/
keys
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.example.com/api/admin/keys' \
--header 'Content-Type: application/json' \
--data '{
"orgId": "string",
"label": "Replacement tent pole set",
"bootstrapSecret": "YOUR_API_KEY"
}'
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"key": "string",
"orgId": "string",
"label": "Replacement tent pole set"
}
With a bearer key for your own org, or — once, for a new org —
bootstrapSecret (the server’s ADMIN_BOOTSTRAP_SECRET) and no bearer. The key is returned once.
Request body
AdminKeyCreate
Response
AdminKey
Status codes
| Code | Meaning |
|---|---|
200 | OK |
400 | Error |
401 | Error |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.example.com/api/admin/keys' \
--header 'Content-Type: application/json' \
--data '{
"orgId": "string",
"label": "Replacement tent pole set",
"bootstrapSecret": "YOUR_API_KEY"
}'
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"key": "string",
"orgId": "string",
"label": "Replacement tent pole set"
}
Last modified on November 13, 2026