Skip to main content
POST
/
v1
/
core
/
oauth
/
apps
/
{clientId}
/
access-token
Create a new OAuth access token for a given OAuth app.
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/core/oauth/apps/{clientId}/access-token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientSecret": "<string>",
  "userId": "<string>"
}
'
{
  "accessTokenId": "<string>",
  "accessToken": "<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.

Path Parameters

​
clientId
string
required

Body

application/json
​
clientSecret
string
required

The OAuth app client secret returned in the POST /oauth/apps response.

​
userId
string
required

The user that this token will be bound to

​
scope
enum<string>
required

One of ("read", "write"). This will restrict what HTTP verbs the token has access to.

Available options:
read,
write

Response

201 - application/json

Create a new OAuth access token for a given OAuth app.

​
accessTokenId
string
required
​
accessToken
string
required