Api

post

Takes a set of user credentials and returns an access and refresh JSON web token pair to prove the authentication of those credentials.

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body

application/json

usernamestring · min: 1Required

passwordstring · min: 1Required

Responses

201Success

application/json

post

/api/auth/jwt/

HTTPcURLJavaScriptPython

POST /api/auth/jwt/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "username": "text",
  "password": "text"
}

201Success

{
  "username": "text",
  "password": "text"
}

post

Takes a refresh type JSON web token and returns an access type JSON web token if the refresh token is valid.

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body

application/json

refreshstring · min: 1Required

accessstring · min: 1Read-onlyOptional

Responses

201Success

application/json

post

/api/auth/jwt/refresh/

HTTPcURLJavaScriptPython

POST /api/auth/jwt/refresh/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "refresh": "text"
}

201Success

{
  "refresh": "text",
  "access": "text"
}

post

Takes a token and indicates if it is valid. This view provides no information about a token's fitness for a particular use.

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Body

application/json

tokenstring · min: 1Required

Responses

201Success

application/json

post

/api/auth/jwt/verify/

HTTPcURLJavaScriptPython

POST /api/auth/jwt/verify/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "token": "text"
}

201Success

{
  "token": "text"
}

get

List all API tokens for the authenticated user

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Path parameters

team_uuidstringRequired

Responses

200Success

application/json

400

Invalid request

403

Permission denied

500

Server error

get

/api/openapi/token/{team_uuid}/

HTTPcURLJavaScriptPython

GET /api/openapi/token/{team_uuid}/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "tokens": [
    {
      "access_token": "text",
      "token_issuer_uuid": "text",
      "created_at": "text",
      "updated_at": "text",
      "expires_at": "text"
    }
  ]
}

post

Issue a new API token

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Path parameters

team_uuidstringRequired

Responses

200Success

application/json

400

Invalid request

403

Permission denied

500

Server error

post

/api/openapi/token/{team_uuid}/

HTTPcURLJavaScriptPython

POST /api/openapi/token/{team_uuid}/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "access_token": "text",
  "token_issuer_uuid": "text",
  "created_at": "text",
  "updated_at": "text",
  "expires_at": "text"
}

post

Delete API tokens

Authorizations

Bearer

AuthorizationstringRequired

'Enter your access token with Bearer prefix, e.g., "Bearer YOUR_API_KEY"'

Path parameters

team_uuidstringRequired

Responses

200Success

application/json

400

Invalid request

403

Permission denied

500

Server error

post

/api/openapi/token/{team_uuid}/delete/

HTTPcURLJavaScriptPython

POST /api/openapi/token/{team_uuid}/delete/ HTTP/1.1
Host: app.timbr.studio
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requested_count": 1,
  "deleted_count": 1
}