Skip to content

List the token’s teams

GET
/teams
curl --request GET \
--url https://qinto-api.blotout.io/teams \
--header 'Authorization: Bearer <token>'

Returns every team this credential may access. Start here: every other operation needs a teamId.

How it works

A team API token returns its one team. An OAuth token returns the teams selected when the session was authorized.

Required permissions

  • None beyond a valid token; the response contains only the token’s bound team

The teams this token may access.

Media typeapplication/json
object
teams
required

The teams authorized for this credential.

Array<object>

A team the authenticated credential may access.

object
teamId
required

Server-assigned unique id of the team. Every other operation addresses a team with it.

string
name
required

Display name of the team, or null when it has never been named.

string | null
createdAt
required

When the team was created, as an ISO 8601 UTC timestamp.

string format: date-time
scopes
required

The access granted specifically in this team.

Array<string>

Example

{
"teams": [
{
"teamId": "7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9",
"name": "Acme",
"createdAt": "2026-06-18T00:00:00.000Z",
"scopes": [
"team:write"
]
}
]
}

unauthenticated — The Authorization: Bearer token is missing, malformed, or no longer valid. Generate a team API token or obtain a new OAuth access token.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: unauthenticated

Example

{
"error": "unauthenticated"
}

internal — Unexpected server error. Nothing is guaranteed to have been persisted; idempotent operations are safe to retry.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: internal

Example

{
"error": "internal"
}