GET https://api.ap1.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.ap2.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.datadoghq.eu/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.ddog-gov.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.us2.ddog-gov.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.uk1.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.us3.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}https://api.us5.datadoghq.com/api/v2/org_authorized_clients/{org_authorized_client_id}
Overview
Get a single OAuth2 client authorized for the current organization.
This endpoint requires the org_authorized_apps_read permission.
OAuth apps require the org_authorized_apps_read authorization scope to access this endpoint.
Arguments
Path Parameters
org_authorized_client_id [required]
The ID of the org authorized client.
Query Strings
Comma-separated list of related resources to include.
Options: oauth2_client, oauth2_client.app, oauth2_client.scopes, user_authorized_clients.user.
filter[user_authorized_clients][disabled]
Filter included user authorized clients by disabled status.
filter[user_authorized_clients][user][disabled]
Filter included user authorized clients by user disabled status.
Response
OK
Response containing a single org authorized client.
Expand All
Data object representing an org authorized client.
Attributes of an org authorized client.
Whether the organization has disabled this client.
last_exercised [required]
The date and time this client was last exercised.
The number of users in the organization who have authorized this client.
The unique identifier of the org authorized client.
Relationships for an org authorized client.
Relationship to the OAuth2 client for this org authorized client.
Data identifying the OAuth2 client associated with this org authorized client.
The ID of the OAuth2 client.
OAuth2 client resource type.
Allowed enum values: oauth2_clients
user_authorized_clients [required]
Relationship to the user authorized clients for this org authorized client.
List of user authorized client relationship data objects.
The ID of the user authorized client.
User authorized client resource type.
Allowed enum values: user_authorized_clients
Links for the user authorized clients relationship.
Link to the user authorized clients for this org authorized client.
The resource type for org authorized clients.
Allowed enum values: org_authorized_clients
{
"data": {
"attributes": {
"disabled": false,
"last_exercised": "2024-01-15T10:30:00+00:00",
"user_count": 2
},
"id": "00000000-0000-0000-0000-000000000001",
"relationships": {
"oauth2_client": {
"data": {
"id": "00000000-0000-0000-0000-000000000010",
"type": "oauth2_clients"
}
},
"user_authorized_clients": {
"data": [
{
"id": "00000000-0000-0000-0000-000000000020",
"type": "user_authorized_clients"
}
],
"links": {
"related": "/api/v2/org_authorized_clients/00000000-0000-0000-0000-000000000001/user_authorized_clients"
}
}
},
"type": "org_authorized_clients"
}
}
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"
}
]
}
Not Found
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
# Path parameters
export org_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/org_authorized_clients/${org_authorized_client_id}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
