Skip to content

v1 Authentication

POST /v1/auth/token

Exchange client credentials for a bearer token.

Request

json
{
  "clientId": "ra_client_XXXX",
  "clientSecret": "YOUR_SECRET"
}

Response 200

json
{
  "accessToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "tokenType": "Bearer"
}

Errors

StatusCause
400Missing clientId or clientSecret
401Invalid credentials, or the client is disabled

Tokens are valid for 1 hour. See Authentication for the x-api-key alternative.

GET /v1/endpoints

Lists the operations your integration client is permitted to call. Useful for building a feature matrix in your own app.

bash
curl https://sandboxclient-api.roofangle.com/v1/endpoints \
  -H "Authorization: Bearer eyJhbGciOi..."

Need an API key? Contact support@roofangle.com