POST
/
teams
curl --request POST \
  --url https://api.altostrat.io/teams \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "site_limit": 1
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "email": "jsmith@example.com",
    "picture": "<string>"
  },
  "personal_team": true,
  "members": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "email": "jsmith@example.com",
      "picture": "<string>"
    }
  ],
  "invites": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "jsmith@example.com",
      "role": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "current": true,
  "site_count": 123,
  "site_limit": 123,
  "roles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "guard_name": "<string>",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Standard OAuth2 flow for user authentication. Use Authorization Code Grant or Implicit Grant. JWT Bearer tokens obtained are used for subsequent requests.

Body

application/json
Team details.
​
name
string
required

The name of the new team.

Maximum length: 200
​
site_limit
integer | null

Optional site limit specific to this team (overrides organization default if set).

Required range: x >= 0

Response

201
application/json
Team created successfully.
​
id
string
required
​
name
string
required
​
owner
object
required
​
personal_team
boolean
required

Indicates if this is the user's personal team.

​
members
object[]
required
​
invites
object[]
required
​
current
boolean
required

Indicates if this is the user's currently active team.

​
site_count
integer
required

Number of sites currently associated with this team.

​
site_limit
integer
required

Maximum number of sites allowed for this team (0 means use organization limit).

​
roles
object[]
required

Was this page helpful?