POST
/api/v1/tokens
Request
Response
201
Created
Treat tokens like passwords. Anyone with one can act as your server's staff through the API.
Authorization
AuthorizationstringrequiredYour API token as
Bearer YOUR_TOKEN. Create one in your server's dashboard settings.Body
namestringrequiredToken name, 1-50 characters. Must be unique among active tokens.
expiresInDaysinteger | nullDays until it expires, from 1 to 3650. Leave it out for no expiry.
Response
201 Created
createdAtintegerrequiredWhen the token was created.
idstringrequiredToken ID.
isActivebooleanrequiredWhether the token works.
namestringrequiredToken name.
serverIdstringrequiredServer the token belongs to.
tokenstringrequiredThe bearer secret. Store it now; it cannot be retrieved again.
expiresAtinteger | nullWhen the token expires.
lastUsedAtinteger | nullWhen the token was last used, to the nearest minute.
Errors
| Status | Meaning |
|---|---|
400 | Invalid request. validation_failed lists each invalid field in details.fields. |
401 | Missing, invalid or expired token |
409 | Name taken or active token limit reached |
429 | Rate limited. See Retry-After and details. |
500 | Internal server error |