Skip to main content
GET
/
api
/
v1
/
provisioning
/
tenants
/
{tenantId}
/
{collection}
/
{docId}
Get a provisioning document by ID
curl --request GET \
  --url https://platform.crescendo.ai/api/v1/provisioning/tenants/{tenantId}/{collection}/{docId} \
  --header 'Authorization: Bearer <token>'
{}
Use this endpoint to read a single resource by document ID.

​
Example: get a user

export CRESCENDO_TENANT_ID="tenant-alpha"
export CRESCENDO_API_KEY="YOUR_API_KEY"

curl -sS \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  "https://platform.crescendo.ai/api/v1/provisioning/tenants/$CRESCENDO_TENANT_ID/users/user-001"

​
Versioned resources

Some resources support a versions.current object in the base document response. For example, bots may include a versions.current.spec object. If you need the raw current version document directly, request: 
curl -sS \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  "https://platform.crescendo.ai/api/v1/provisioning/tenants/$CRESCENDO_TENANT_ID/bots/bot-001/versions/current"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tenantId
string
required

Tenant identifier.

​
collection
string
required

Collection name under the tenant (for example: users, bots, jobs).

​
docId
string
required

Document identifier within the collection.

Response

Provisioning document

Arbitrary JSON object representing the provisioning resource.