Requesting a Token (Deprecated)

Notice

Basic authentication and usage of the token endpoint has been deprecated in the Capella API. Usage of the Capella API will now require an API key. For more information, see Requesting an API Key.

Overview

The Capella API uses JSON Web Tokens (JWT) to validate a user’s identity. The token endpoint is used to exchange a username and password in a basic authentication header for an authentication token. You must have a valid Capella account to successfully request a token. Authentication tokens will expire after approximately 1 hour.

Requesting a Token

To request a token, you must first send a POST request to the token endpoint. Your username and password should be included in the header:

POST https://api.capellaspace.com/token
Content-Type: 'application/x-www-form-urlencoded'
Authorization: Basic <Base64 username:password>

A successful request will result in the following response:

{
    "accessToken": "eyJ...",
    "expiresIn": 3600,
    "tokenType": "Bearer"
}

Using the Token

To use the token you have requested, include it in the header of requests to other endpoints

Authorization: Bearer {{accessToken}}

The token will expire after the time denoted in expiresIn.

Additional Information

For more information, see the API reference for Access and Entitlements.