Skip to main content
POST
Create an API client
Creates a client app for the organization. The clientSecret is returned once. Store it immediately — it cannot be retrieved later. To get a new secret, rotate the existing client. Each requested scope must already be held by the caller. The client is limited to this organization. After create, exchange clientId and clientSecret at auth.siro.ai.

Authorizations

x-siro-auth-token
string
header
default:<access-token>
required

Access token from POST https://auth.siro.ai/oauth2/token (client_credentials), or a Siro OAuth access token. Send x-siro-auth-token: <access-token>.

Path Parameters

organizationId
string
required

The organization this client belongs to.

Body

application/json
name
string
required

A display name for the client.

Minimum string length: 1
scopes
string[]
required

The scopes to grant. Each one must already be held by the caller.

Minimum array length: 1

Response

Create an API client

data
object
required
cursor
pageSize
number
limit
number
total
number | null
hasNextPage
boolean