API ReferenceAuthentication

Request a new access token

The Cable API uses API keys to authenticate requests. Make sure never to share your API keys - don’t put them in repositories or leave them as human-readable in code, and always use HTTPS.

Request a new access token to authenticate requests to the API. The token will expire after the specified time. To request an access token you must use the refresh / auth token provided to you by Cable. You cannot request a new token with an existing access token.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

AuthorizationstringRequired

Request

This endpoint expects an object.
expiry_secondslongRequired

The requested expiration time in seconds for the token. Must be between 300 (5 minutes) and 86400 (24 hours).

scopesobjectRequired

Response

Token created successfully

tokenstring
expirylong

The expiration time in Unix time format.

organization_idstring

The organization ID for which the token was requested.

organization_namestring

The name of the organization for which the token was requested.

scopesobjectOptional

Errors