api

Create a new api token

Create a new api token to use on behalf of the user creating it.

put/tokens

Request body

createdstring

A timestamp when this api key was created. You cannot change this value.

expires_atstring

The date when this key expires.

idinteger

The unique, numeric id of this api key.

owner_idinteger

The user ID of the token owner. When creating a token for a bot user, set this to the bot's ID. If omitted, defaults to the authenticated user.

permissionsModelsAPIPermissions
titlestring

A human-readable name for this token

tokenstring

The actual api key. Only visible after creation.

Response

The created token.

createdstring

A timestamp when this api key was created. You cannot change this value.

expires_atstring

The date when this key expires.

idinteger

The unique, numeric id of this api key.

owner_idinteger

The user ID of the token owner. When creating a token for a bot user, set this to the bot's ID. If omitted, defaults to the authenticated user.

permissionsModelsAPIPermissions
titlestring

A human-readable name for this token

tokenstring

The actual api key. Only visible after creation.

Changes

Changed in 1 of the 53 revisions of this API.11

  • b03f30dcad8e11See the full diff
    • removed the success response with the status 200

      response-success-status-removed

    • added the success response with the status 201

      response-success-status-added