errors.auth-tokens.create-upload-token

A short-lived SENTRY_AUTH_TOKEN for one project: source-map upload only, at most an hour

POST /errors/api/projects/{id}/upload-tokenIAM errors:UploadSourceMapsChanges state

For builds elsewhere: a GitHub workflow exchanges its OIDC token at the STS for a temporary access key, then asks for this token, so no static secret lives in GitHub (/docs/errors/guide/upload-source-maps). Never outlives the calling key; revoked at expiry.

Request syntax

POST /errors/api/projects/{id}/upload-token
{
  "ttlSeconds": "number"
}

Path parameters

  • idRequired

    string

    Constraints: uuid

Request body

  • ttlSecondsOptional

    number

    Lifetime, at most an hour (and never beyond the caller’s own credential)

    Constraints: integer, 60-3600

    Default: 3600

Response

201 with { token, accessKeyId, expiresAt, org, project, url, dsn }: `token` the SENTRY_AUTH_TOKEN, shown only now, which may upload source maps to this project only; `expiresAt` the requested lifetime, cut to your access key’s own expiry; org, project and url what sentry-cli needs; `dsn` the project’s managed DSN, null when nothing is connected to it. 404 when the project does not exist.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow errors:UploadSourceMaps on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud errors auth-tokens create-upload-token id

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_errors_auth-tokens_create-upload-token.