Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

A confidential OAuth client's client_id and client_secret, sent as HTTP Basic credentials. Register the client with your secret key to receive them; see POST /oauth/register.

Body

application/x-www-form-urlencoded

A token request. Its fields follow from grant_type.

grant_type
enum<string>
required

authorization_code.

Available options:
authorization_code
code
string
required

The code the redirect carried.

redirect_uri
string<uri>
required

The redirect_uri sent to the authorization page.

code_verifier
string
required

The PKCE verifier whose S256 hash was the code_challenge.

Required string length: 43 - 128
client_id
string

The client's ID. Required for a public client, which sends no secret.

resource
string<uri>

The resource the token is for, as RFC 8707 defines, https://app.reflections.ai/mcp.

Response

The access token.

An access token, as RFC 6749 returns it.

access_token
string
required

Send a Bearer token to the MCP server as Authorization: Bearer <token>. Send a License token to the content host as Authorization: License <token>.

token_type
enum<string>
required

Bearer for the MCP server. License for an RSL license token.

Available options:
Bearer,
License
expires_in
integer
required

Seconds until the access token expires: 3600 for Bearer. For License, 86400, or less when the license it draws on ends sooner.

livemode
boolean
required

true when the token acts in live mode. For Bearer tokens, the person chose the mode on the authorization page.

refresh_token
string

For authorization_code and refresh_token grants. Each use returns a new refresh token and ends the old one. A refresh token expires after 30 days unused, or when the person removes the client.

scope
string

The space-separated scopes the token carries, which the person approved. Absent for License tokens.