Access Tokens API
Show an access token TokensController#show
GET /api/v1/users/:user_id/tokens/:id
Scope:
url:GET|/api/v1/users/:user_id/tokens/:id
The ID can be the actual database ID of the token, or the ‘token_hint’ value.
Create an access token TokensController#create
POST /api/v1/users/:user_id/tokens
Scope:
url:POST|/api/v1/users/:user_id/tokens
Create a new access token for the specified user. If the user is not the current user, the token will be created as “pending”, and must be activated by the user before it can be used.
Request Parameters:
| Parameter | Type | Description | |
|---|---|---|---|
| token[purpose] | Required | string |
The purpose of the token. |
| token[expires_at] | DateTime |
The time at which the token will expire. |
|
| token[scopes][] | Array |
The scopes to associate with the token. |
Update an access token TokensController#update
PUT /api/v1/users/:user_id/tokens/:id
Scope:
url:PUT|/api/v1/users/:user_id/tokens/:id
Update an existing access token.
The ID can be the actual database ID of the token, or the ‘token_hint’ value.
Request Parameters:
| Parameter | Type | Description | |
|---|---|---|---|
| token[purpose] | string |
The purpose of the token. |
|
| token[expires_at] | DateTime |
The time at which the token will expire. |
|
| token[scopes][] | Array |
The scopes to associate with the token. |
|
| token[regenerate] | boolean |
Regenerate the actual token. |
Delete an access token TokensController#destroy
DELETE /api/v1/users/:user_id/tokens/:id
Scope:
url:DELETE|/api/v1/users/:user_id/tokens/:id
The ID can be the actual database ID of the token, or the ‘token_hint’ value.