Skip to main content
POST
/
v1
/
core
/
organizations
/
{orgId}
/
teams
Create a new team for an org
curl --request POST \
  --url https://functions.siro.ai/api-externalApi/v1/core/organizations/{orgId}/teams \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "coachUids": [
    "<string>"
  ],
  "memberUids": [
    "<string>"
  ],
  "newUserDefaultConversationTypes": [
    "<string>"
  ],
  "betaFeatures": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "name": "<string>",
  "organizationId": "<string>",
  "coachUids": [
    "<string>"
  ],
  "coachManifest": {},
  "memberUids": [
    "<string>"
  ],
  "memberManifest": {},
  "newUserDefaultConversationTypes": [
    "<string>"
  ],
  "createdAt": "<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

​
orgId
string
required

Organization ID

Body

application/json
​
name
string
required

Team name

​
coachUids
string[]

Array of coach user IDs

​
memberUids
string[]

Array of member user IDs

​
newUserDefaultConversationTypes
string[]

Array of conversation type IDs

​
betaFeatures
string[]

Beta features enabled for this team

Response

201 - application/json

Create a new team for an org

​
id
string
required

Team ID

​
name
string | null
required

Team name

​
organizationId
string
required

Organization this team belongs to

​
coachUids
string[]
required

Array of coach user IDs

​
coachManifest
object
required

Map of coach UIDs to their manifest data

​
memberUids
string[]
required

Array of member user IDs

​
memberManifest
object
required

Map of member UIDs to their manifest data

​
newUserDefaultConversationTypes
string[]
required

Array of conversation type IDs

​
createdAt
string | null
required

ISO 8601 date string