Manage Auth Tokens

Update a specific auth token

put/api/auth-tokens/{originOrId}

Updates an auth token, or creates it when no token has the given origin (upsert by origin). The request must not carry spec.token: the secret is generated by Dash0 and a request that sends one returns 400. Changing the origin is rejected with 400. The response includes spec.token only when this request created the token. Omitting any spec field leaves its stored value unchanged. apiVersion is required; a missing or unsupported value returns 400.

Parameters 1

originOrIdpathrequired

Auth token origin or ID.

string

bash

Sample requestcurl --request PUT 'https://api.eu-west-1.aws.dash0.com/api/auth-tokens/123e4567-e89b-42d3-a456-426614174000' \
  --header "Authorization: Bearer ${DASH0_AUTH_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "apiVersion": "dash0.com/v1alpha1",
  "kind": "Dash0AuthToken",
  "metadata": {
    "name": "Example"
  },
  "spec": {}
}'

Server

Request body required

References AuthTokenUpdateRequest

References AuthTokenDefinition

stringrequired

Version of the auth token document format. Required on create and update; the only supported value is dash0.com/v1alpha1, and any other value returns 400. Returned on every read.

stringrequired

"Dash0AuthToken"

AuthTokenMetadatarequired

AuthTokenSpecrequired

A field omitted on create takes its default, except actions, which create requires. A field omitted on update keeps its stored value. Clients must accept enum values they do not recognize.

Responses

The auth token was updated.

References AuthTokenResponse

References AuthTokenResponseDefinition

stringrequired

"Dash0AuthToken"

AuthTokenMetadatarequired

AuthTokenResponseSpecrequired