For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/api/latest/user-authorized-clients/get-a-user-authorized-client.md. A documentation index is available at /llms.txt.

Get a user authorized client

GET https://api.ap1.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.ap2.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.datadoghq.eu/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.ddog-gov.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.us2.ddog-gov.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.uk1.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.us3.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}https://api.us5.datadoghq.com/api/v2/user_authorized_clients/{user_authorized_client_id}

Overview

Get a single OAuth2 client authorization for the current user.

OAuth apps require the built_in_features authorization scope to access this endpoint.

Arguments

Path Parameters

Name

Type

Description

user_authorized_client_id [required]

string

The ID of the user authorized client.

Response

OK

Response containing a single user authorized client.

Expand All

Field

Type

Description

data [required]

object

Data object representing a user authorized client.

attributes [required]

object

Attributes of a user authorized client.

created_at [required]

date-time

The date and time this authorization was created.

disabled [required]

boolean

Whether the user has disabled this authorization.

last_exercised [required]

date-time

The date and time this authorization was last exercised.

modified_at [required]

date-time

The date and time this authorization was last modified.

org_disabled [required]

boolean

Whether the organization has disabled this authorization.

id [required]

string

The unique identifier of the user authorized client.

relationships [required]

object

Relationships for a user authorized client.

oauth2_client [required]

object

Relationship to the OAuth2 client that was authorized.

data [required]

object

Data identifying the OAuth2 client that was authorized.

id [required]

string

The ID of the OAuth2 client.

type [required]

enum

OAuth2 client resource type. Allowed enum values: oauth2_clients

scopes [required]

object

Relationship to the scopes granted to the OAuth2 client.

data [required]

[object]

List of scope relationship data objects.

id [required]

string

The identifier of the scope.

type [required]

enum

Scope resource type. Allowed enum values: scopes

user [required]

object

Relationship to the user who granted this authorization.

data [required]

object

Data identifying the user who granted this authorization.

id [required]

string

The ID of the user.

type [required]

enum

User resource type. Allowed enum values: users

type [required]

enum

The resource type for user authorized clients. Allowed enum values: user_authorized_clients

{
  "data": {
    "attributes": {
      "created_at": "2024-01-10T08:00:00+00:00",
      "disabled": false,
      "last_exercised": "2024-01-15T10:30:00+00:00",
      "modified_at": "2024-01-10T08:00:00+00:00",
      "org_disabled": false
    },
    "id": "00000000-0000-0000-0000-000000000001",
    "relationships": {
      "oauth2_client": {
        "data": {
          "id": "00000000-0000-0000-0000-000000000010",
          "type": "oauth2_clients"
        }
      },
      "scopes": {
        "data": [
          {
            "id": "example_scope",
            "type": "scopes"
          }
        ]
      },
      "user": {
        "data": {
          "id": "00000000-0000-9999-0000-000000000001",
          "type": "users"
        }
      }
    },
    "type": "user_authorized_clients"
  }
}

Authentication error

API error response.

Expand All

Field

Type

Description

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Not Found

API error response.

Expand All

Field

Type

Description

errors [required]

[object]

A list of errors.

detail

string

A human-readable explanation specific to this occurrence of the error.

meta

object

Non-standard meta-information about the error

source

object

References to the source of the error.

header

string

A string indicating the name of a single request header which caused the error.

parameter

string

A string indicating which URI query parameter caused the error.

pointer

string

A JSON pointer to the value in the request document that caused the error.

status

string

Status code of the response.

title

string

Short human-readable summary of the error.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Path parameters
export user_authorized_client_id="00000000-0000-0000-0000-000000000001"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/user_authorized_clients/${user_authorized_client_id}" \ -H "Accept: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}"