Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Body

application/json
team_id
string | null

ID of the team. When omitted, the team you belong to; required when you belong to several.

Minimum string length: 1
Example:

"abc1234"

Response

200 - application/json
token
string
required

Short-lived bearer token for the Grid gateway, scoped to you and the team. Send it as Authorization: Bearer .

expires_at
string<date-time>
required

Token expiry in ISO 8601 format. Tokens cannot be renewed; request a new one.

team_id
string
required

ID of the team the token invokes Grid routes in.

Example:

"abc1234"

team_name
string
required

Name of that team.

Example:

"Engineering"