Send AI tool user activity
https://api.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.us3.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.us5.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.datadoghq.eu/api/v2/ai_impact/user_activityhttps://api.ap1.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.ap2.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.uk1.datadoghq.com/api/v2/ai_impact/user_activityhttps://api.ddog-gov.com/api/v2/ai_impact/user_activityhttps://api.us2.ddog-gov.com/api/v2/ai_impact/user_activityPrésentation
Send daily AI coding tool activity for one or more users. Each entry records whether a user was active on a given day, along with the AI tools and models they used. An entry is stored once per tool, and sending the same user, day, and tool again overwrites the previous value.
Requête
Body Data (required)
data [required]A batch of daily AI tool activity entries. A batch must contain between 1 and 1,000 entries.
attributes [required]Daily AI coding tool activity for a single user. Each entry reports whether the user was active on a given day and which AI tools and models they used.
day [required]The day the activity refers to, in YYYY-MM-DD format.
is_active [required]Whether the user actively used the listed AI tools on that day.
modelsThe AI models the user used on that day, for example claude-sonnet-4.5 or gpt-5.
Values are lowercased and duplicates are removed.
tools [required]The AI coding tools the user used on that day, for example Claude Code, Cursor, or
GitHub Copilot. Known tools are normalized to a canonical name (claude_code, cursor,
copilot), and other values are converted to snake case. Entries must not be empty.
user_email [required]The email address of the user. It is case-insensitive and is matched against the email addresses of commit authors.
type [required]JSON:API type for AI Impact user activity entries.
ai_impact_user_activityai_impact_user_activity{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}Réponse
OK
Bad Request: the batch is empty, has more than 1,000 entries, or contains an invalid entry.
An entry is invalid when user_email, is_active, or day is missing, tools is missing
or an empty array, user_email is not a valid email address, day is not in YYYY-MM-DD
format, or a tool name is empty. The error message identifies the index of the first invalid
entry. Fix the payload and send the request again.
API error response.
errors [required]A list of errors.
detailA human-readable explanation specific to this occurrence of the error.
metaNon-standard meta-information about the error
sourceReferences to the source of the error.
headerA string indicating the name of a single request header which caused the error.
parameterA string indicating which URI query parameter caused the error.
pointerA JSON pointer to the value in the request document that caused the error.
statusStatus code of the response.
titleShort 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 Authorized
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Too many requests
API error response.
errors [required]A list of errors.
{
"errors": [
"Bad Request"
]
}Exemple de code
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
export DD_API_KEY="<DD_API_KEY>"
curl -X POST "https://api.${DD_SITE}/api/v2/ai_impact/user_activity" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-d @- << EOF
{
"data": [
{
"attributes": {
"day": "2026-05-26",
"is_active": true,
"models": [
"claude-sonnet-4.5",
"gpt-5"
],
"tools": [
"Claude Code",
"Cursor"
],
"user_email": "user@example.com"
},
"type": "ai_impact_user_activity"
}
]
}
EOF