Team access tokens

Download schema

Read-only endpoints for team access token metadata.

List team access tokens

GET

https://account.chief.app/api

/v1/teams/{teamSlug}/tokens

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

List metadata for all access tokens belonging to a team. Token values cannot be retrieved.

List team access tokens › path Parameters

teamSlug

string · required

team slug

List team access tokens › query Parameters

page

integer · min: 1

Page number to return.

Default: 1

per_page

integer · min: 1 · max: 100

Number of items to return per page.

Default: 50

List team access tokens › Responses

Paginated set of TeamToken

TeamToken[] · required

object · required

GET/v1/teams/{teamSlug}/tokens

curl https://account.chief.app/api/v1/teams/:teamSlug/tokens \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "id",
      "name": "name",
      "scopes": [
        "string"
      ],
      "authorization_details": [
        {
          "type": "type",
          "identifier": "identifier"
        }
      ],
      "creator": {
        "id": "id",
        "name": "name",
        "email": "email"
      },
      "created_at": "2024-08-25T15:00:00Z",
      "last_used_at": "2024-08-25T15:00:00Z",
      "expires_at": "2024-08-25T15:00:00Z"
    }
  ],
  "links": {
    "first": "first",
    "last": "last",
    "prev": "prev",
    "next": "next"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "url",
        "label": "label",
        "active": true
      }
    ],
    "path": "path",
    "per_page": 0,
    "to": 1,
    "total": 0
  }
}

json

application/json

Show team access token

GET

https://account.chief.app/api

/v1/teams/{teamSlug}/tokens/{tokenId}

OpenID Connect

Bearer (ctp_*)

Bearer (ctt_*)

Retrieve metadata for a single team access token. The token value cannot be retrieved.

Show team access token › path Parameters

teamSlug

string · required

team slug

tokenId

string · required

token identifier

Show team access token › Responses

TeamToken

TeamToken · required

Members