For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/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

Présentation

Create an access token for a service account.

This endpoint requires the service_account_write permission.

Arguments

Paramètres du chemin

Name
Type
Description
service_account_id [required]
string

The ID of the service account.

Requête

Body Data (required)

Champ
Type
Description
data [required]
object

Object used to create a service account access token.

Réponse

Created

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

Champ
Type
Description
data
object

Datadog access token, including the token key.

Exemple de code

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