Upload Tokens

Generate an upload token

Generates an upload token that can be used to replace the API Key. More information can be found here

post/upload-tokens

Request body

ttlinteger

Time in seconds that the token will be active. A value of 0 means that the token has no exipration date. The default is to have no expiration.

Example request

{
  "ttl": 3600
}

Response

Success

tokenstring

The unique identifier for the token you will use to authenticate an upload.

ttlinteger

Time-to-live - how long the upload token is valid for.

createdAtstring date-time

When the token was created, displayed in ATOM UTC format.

expiresAtstring date-time nullable

When the token expires, displayed in ATOM UTC format.

Example response

{
  "createdAt": "2019-12-16T08:25:51Z",
  "ttl": 171976544,
  "expiresAt": "2019-12-16T09:25:51Z",
  "token": "to1tcmSFHeYY5KzyhOqVKMKb"
}

Changes

Changed in 3 of the 50 revisions of this API.66

Apr 16, 2024ec2b79bfdc8d1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Apr 28, 2022f9532dd3578c2See the full diff
- ○
  the endpoint scheme security apiKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearerAuth was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 7, 20222a4d90a64f8863See the full diff
- ●
  the optional response header X-RateLimit-Limit removed for the status 200
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Limit removed for the status 400
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Remaining removed for the status 200
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Remaining removed for the status 400
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Retry-After removed for the status 200
  optional-response-header-removed
- ●
  the optional response header X-RateLimit-Retry-After removed for the status 400
  optional-response-header-removed
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security apiKey was removed from the API
  api-security-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 32 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 50 revisions, 1 has no diff computed.

Full history