PIpirros
Authentication

Obtain access token

Exchange client credentials for a Bearer token. The returned access token must be included in the Authorization header for the /v1/workspaces/* resource endpoints on the external API host. It is NOT used by the main-API-host endpoint /v1/workspaces/me, which requires a logged-in user session instead. Served by the Pirros auth host (not the external API host); the access token is a 1-hour, non-refreshable JWT for the client_credentials grant.

post/oauth/token

Request

  • Base URL
    https://auth.pirros.com
  • Auth
    none declared

Request body

grant_type'client_credentials' required
client_idstring uuid required
client_secretstring required

Response

Access token granted

access_tokenstring required
token_type'Bearer' required
expires_ininteger required
request_idstring uuid required

Example response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  "token_type": "Bearer",
  "expires_in": 3600,
  "request_id": "123e4567-e89b-12d3-a456-426614174000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.