For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/es/api/latest/service-accounts/create-an-access-token-for-a-service-account.md. A documentation index is available at /llms.txt.
Language
Datadog site

Create an access token for a service account

POSThttps://api.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us3.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us5.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.datadoghq.eu/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ap1.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ap2.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.uk1.datadoghq.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.ddog-gov.com/api/v2/service_accounts/{service_account_id}/access_tokenshttps://api.us2.ddog-gov.com/api/v2/service_accounts/{service_account_id}/access_tokens

Descripción general

Create an access token for a service account.

This endpoint requires the service_account_write permission.

Argumentos

Parámetros de ruta

Nombre
Type
Descripción
service_account_id [required]
string

The ID of the service account.

Solicitud

Body Data (required)

Campo
Type
Descripción
data [required]
object

Object used to create a service account access token.

Respuesta

Created

Response for creating an access token. Includes the token key.

Campo
Type
Descripción
data
object

Datadog access token, including the token key.

Ejemplo de código

Create an access token for a service account returns "Created" response
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF
# Path parameters
export service_account_id="00000000-0000-1234-0000-000000000000"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/service_accounts/${service_account_id}/access_tokens" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "service_access_tokens",
    "attributes": {
      "name": "Example-Service-Account",
      "scopes": [
        "dashboards_read"
      ]
    }
  }
}
EOF