Skip to main content
POST
/
v1
/
core
/
auth
/
tokens
Create a new authentication token for an organization.
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/core/auth/tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokenName": "<string>",
  "organizationId": "<string>"
}
'
{
  "tokenId": "<string>",
  "tokenName": "<string>",
  "organizationId": "<string>",
  "authorizedOrgGroupId": "<string>",
  "parentOrgGroupTokenId": "<string>",
  "createdAt": "<string>",
  "createdBy": "<string>",
  "token": "<string>"
}

Authorizations

​
Authorization
string
header
default:<organization-api-token>
required

Organization integration token from Siro admin (Person icon → API Tokens). Send Authorization: Bearer . This is not the OAuth access token used with api.siro.ai user-scoped endpoints.

Body

application/json
​
tokenName
string
required
​
organizationId
string
required

Response

200 - application/json

Create a new authentication token for an organization.

​
tokenId
string
required
​
tokenName
string
required
​
organizationId
string
required
​
authorizedOrgGroupId
string | null
required

The ID of the org-group that this token is authorized to act as. Default null.

​
parentOrgGroupTokenId
string | null
required

The ID of the org-group-token that created this org-scoped token. Will be null for tokens created through the UI.

​
createdAt
string
required
​
createdBy
string | null
required

The Siro uid of the user who created the token.

​
token
string
required