GET https://api.ap1.datadoghq.com/api/v2/user_authorized_clientshttps://api.ap2.datadoghq.com/api/v2/user_authorized_clientshttps://api.datadoghq.eu/api/v2/user_authorized_clientshttps://api.ddog-gov.com/api/v2/user_authorized_clientshttps://api.us2.ddog-gov.com/api/v2/user_authorized_clientshttps://api.uk1.datadoghq.com/api/v2/user_authorized_clientshttps://api.datadoghq.com/api/v2/user_authorized_clientshttps://api.us3.datadoghq.com/api/v2/user_authorized_clientshttps://api.us5.datadoghq.com/api/v2/user_authorized_clients
Overview
Get a list of all OAuth2 clients authorized by the current user.
OAuth apps require the built_in_features authorization scope to access this endpoint.
Arguments
Query Strings
Size for a given page. The maximum allowed value is 100.
Specific page number to return.
Filter results by client name, app title, or app description.
Filter results by the user-level disabled status.
Comma-separated list of related resources to include. Options: oauth2_client, oauth2_client.app.
Response
OK
Response containing a list of user authorized clients.
Expand All
List of user authorized client data objects.
Attributes of a user authorized client.
The date and time this authorization was created.
Whether the user has disabled this authorization.
last_exercised [required]
The date and time this authorization was last exercised.
The date and time this authorization was last modified.
Whether the organization has disabled this authorization.
The unique identifier of the user authorized client.
Relationships for a user authorized client.
Relationship to the OAuth2 client that was authorized.
Data identifying the OAuth2 client that was authorized.
The ID of the OAuth2 client.
OAuth2 client resource type.
Allowed enum values: oauth2_clients
Relationship to the scopes granted to the OAuth2 client.
List of scope relationship data objects.
The identifier of the scope.
Scope resource type.
Allowed enum values: scopes
Relationship to the user who granted this authorization.
Data identifying the user who granted this authorization.
User resource type.
Allowed enum values: users
The resource type for user authorized clients.
Allowed enum values: user_authorized_clients
Object describing meta attributes of response.
Total count of elements matched by the filter.
{
"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"
}
],
"meta": {
"page": {
"total_count": "integer",
"total_filtered_count": "integer"
}
}
}
Authentication error
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
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
{
"errors": [
"Bad Request"
]
}
Code Example
# 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" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
