Authentication API Documentation

POST /api/v1/auth/token

Obtain an access token using client credentials.

Name	Type	Required	Description
`client_id`	string	Required	Your application client ID
`client_secret`	string	Required	Your application client secret
`grant_type`	string	Required	Must be "client_credentials"

Name	Type	Required	Description
`access_token`	string	Optional	The bearer token to use in subsequent requests
`token_type`	string	Optional	Always "Bearer"
`expires_in`	integer	Optional	Token lifetime in seconds, default 3600

{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 3600
}

POST /api/v1/auth/refresh

Refresh an expired access token.

Name	Type	Required	Description
`refresh_token`	string	Required	The refresh token from initial auth

Name	Type	Required	Description
`access_token`	string	Optional	New bearer token
`expires_in`	integer	Optional	New token lifetime in seconds

{
  "access_token": "eyJhbGciOi...",
  "expires_in": 3600
}

DELETE /api/v1/auth/revoke

Revoke an active access token.

Name	Type	Required	Description
`token`	string	Required	The token to revoke

Name	Type	Required	Description
`status`	string	Optional	"revoked"

{
  "status": "revoked"
}