Authentication

Endpoints for authenticating with the API via OAuth2 flows

Get an access token

This endpoint is used to obtain an access token by using client credentials or user credentials.

Request

Request Body schema: application/x-www-form-urlencoded
required

grant_type required	string Grant type value - currently only client_credentials is explicitly supported. Value: "client_credentials"
client_id required	string <uuid> The client's identifier.
client_secret required	string <password> The client's secret.

Responses

200

A successful response containing the access token.

400

Bad Request - Invalid request parameters.

401

Unauthorized - Invalid client credentials.

post/oauth2/token

Request samples

Payload
curl
Ruby
C#
Node.js

application/x-www-form-urlencoded

grant_type=client_credentials&client_id=your-client-id&client_secret=your-client-secret

Response samples

application/json

{"access_token": "eyJhbGciOi...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "https://slipstream.hsone.app/.default"
}

Gets the details of the current access token.

Securityazure_auth

Responses

200

A successful response containing the details of the access token.

400

Malformed Request (ProblemDetails)

get/oauth2/introspect