{ "opencollection": "1.0.0", "info": { "name": "Datadog Account Users API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "items": [ { "info": { "name": "Users", "type": "folder" }, "items": [ { "info": { "name": "Datadog Get All Application Keys Owned by Current User", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/current_user/application_keys", "params": [ { "name": "page[size]", "value": "", "type": "query", "description": "Size for a given page. The maximum allowed value is 100." }, { "name": "page[number]", "value": "", "type": "query", "description": "Specific page number to return." }, { "name": "sort", "value": "", "type": "query", "description": "Application key attribute used to sort results. Sort order is ascending\nby default. In order to specify a descending sort, prefix the\nattribute with a minus sign." }, { "name": "filter", "value": "", "type": "query", "description": "Filter application keys by the specified string." }, { "name": "filter[created_at][start]", "value": "", "type": "query", "description": "Only include application keys created on or after the specified date." }, { "name": "filter[created_at][end]", "value": "", "type": "query", "description": "Only include application keys created on or before the specified date." }, { "name": "include", "value": "", "type": "query", "description": "Resource path for related resources to include in the response. Only `owned_by` is supported." } ] }, "docs": "List all application keys available for current user" }, { "info": { "name": "Datadog Create an Application Key for Current User", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/current_user/application_keys", "body": { "type": "json", "data": "{}" } }, "docs": "Create an application key for current user" }, { "info": { "name": "Datadog Get One Application Key Owned by Current User", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/current_user/application_keys/:app_key_id", "params": [ { "name": "app_key_id", "value": "", "type": "path", "description": "The ID of the application key." } ] }, "docs": "Get an application key owned by current user" }, { "info": { "name": "Datadog Edit an Application Key Owned by Current User", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/current_user/application_keys/:app_key_id", "params": [ { "name": "app_key_id", "value": "", "type": "path", "description": "The ID of the application key." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Edit an application key owned by current user" }, { "info": { "name": "Datadog Delete an Application Key Owned by Current User", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/current_user/application_keys/:app_key_id", "params": [ { "name": "app_key_id", "value": "", "type": "path", "description": "The ID of the application key." } ] }, "docs": "Delete an application key owned by current user" }, { "info": { "name": "Datadog Get All Restriction Queries for a Given User", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/logs/config/restriction_queries/user/:user_id", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ] }, "docs": "Get all restriction queries for a given user." }, { "info": { "name": "Datadog Get the Schedule On-call User", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/on-call/schedules/:schedule_id/on-call", "params": [ { "name": "include", "value": "example_value", "type": "query", "description": "Specifies related resources to include in the response as a comma-separated list. Allowed value: `user`." }, { "name": "schedule_id", "value": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d", "type": "path", "description": "The ID of the schedule." }, { "name": "filter[at_ts]", "value": "2025-05-07T02:53:01Z", "type": "query", "description": "Retrieves the on-call user at the given timestamp (ISO-8601). Defaults to the current time if omitted.\"" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Retrieves the user who is on-call for the specified schedule at a given time." }, { "info": { "name": "Datadog Get Team On-call Users", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/on-call/teams/:team_id/on-call", "params": [ { "name": "include", "value": "example_value", "type": "query", "description": "Comma-separated list of included relationships to be returned. Allowed values: `responders`, `escalations`, `escalations.responders`." }, { "name": "team_id", "value": "27590dae-47be-4a7d-9abf-8f4e45124020", "type": "path", "description": "The team ID" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a team's on-call users at a given time" }, { "info": { "name": "Datadog Get All Users of a Role", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/roles/:role_id/users", "params": [ { "name": "role_id", "value": "", "type": "path", "description": "The unique identifier of the role." }, { "name": "page[size]", "value": "", "type": "query", "description": "Size for a given page. The maximum allowed value is 100." }, { "name": "page[number]", "value": "", "type": "query", "description": "Specific page number to return." }, { "name": "sort", "value": "example_value", "type": "query", "description": "User attribute to order results by. Sort order is **ascending** by default.\nSort order is **descending** if the field is prefixed by a negative sign,\nfor example `sort=-name`. Options: `name`, `email`, `status`." }, { "name": "filter", "value": "example_value", "type": "query", "description": "Filter all users by the given string. Defaults to no filtering." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Gets all users of a role." }, { "info": { "name": "Datadog Add a User to a Role", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/roles/:role_id/users", "params": [ { "name": "role_id", "value": "", "type": "path", "description": "The unique identifier of the role." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Adds a user to a role." }, { "info": { "name": "Datadog Remove a User from a Role", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/roles/:role_id/users", "params": [ { "name": "role_id", "value": "", "type": "path", "description": "The unique identifier of the role." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Removes a user from a role." }, { "info": { "name": "Datadog List Users", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/scim/Users", "params": [ { "name": "startIndex", "value": "1", "type": "query", "description": "Specifies the start index to fetch the results (1-indexed)." }, { "name": "count", "value": "20", "type": "query", "description": "Specifies the number of users to be returned." }, { "name": "filter", "value": "example_value", "type": "query", "description": "Specifies the url encoded filter to use to narrow down the results.\nFilter should be of the form `userName eq `." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "List users in the organization.\nResults are paginated by `startIndex` and `count` parameters.\nResults can be narrowed down by the `filter` parameter." }, { "info": { "name": "Datadog Create User", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/scim/Users", "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Create a new user." }, { "info": { "name": "Datadog Get User", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/scim/Users/:user_uuid", "params": [ { "name": "user_uuid", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Get a single user using the `user_uuid`." }, { "info": { "name": "Datadog Update User", "type": "http" }, "http": { "method": "PUT", "url": "https://{subdomain}.{site}/api/v2/scim/Users/:user_uuid", "params": [ { "name": "user_uuid", "value": "abc-123-def", "type": "path", "description": "None" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Update the user with the given `user_uuid`." }, { "info": { "name": "Datadog Patch User", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/scim/Users/:user_uuid", "params": [ { "name": "user_uuid", "value": "abc-123-def", "type": "path", "description": "None" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Patch the user with the given `user_uuid`." }, { "info": { "name": "Datadog Delete User", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/scim/Users/:user_uuid", "params": [ { "name": "user_uuid", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Delete the group with the given `user_uuid`." }, { "info": { "name": "Datadog Add a User to a Team", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/memberships", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Add a user to a team." }, { "info": { "name": "Datadog Remove a User from a Team", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/memberships/:user_id", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "name": "user_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Remove a user from a team." }, { "info": { "name": "Datadog Get a User Invitation", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/user_invitations/:user_invitation_uuid", "params": [ { "name": "user_invitation_uuid", "value": "00000000-0000-0000-3456-000000000000", "type": "path", "description": "The UUID of the user invitation." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Returns a single user invitation by its UUID." }, { "info": { "name": "Datadog List All Users", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/users", "params": [ { "name": "page[size]", "value": "", "type": "query", "description": "Size for a given page. The maximum allowed value is 100." }, { "name": "page[number]", "value": "", "type": "query", "description": "Specific page number to return." }, { "name": "sort", "value": "name", "type": "query", "description": "User attribute to order results by. Sort order is ascending by default.\nSort order is descending if the field\nis prefixed by a negative sign, for example `sort=-name`. Options: `name`,\n`modified_at`, `user_count`." }, { "name": "sort_dir", "value": "example_value", "type": "query", "description": "Direction of sort. Options: `asc`, `desc`." }, { "name": "filter", "value": "example_value", "type": "query", "description": "Filter all users by the given string. Defaults to no filtering." }, { "name": "filter[status]", "value": "Active", "type": "query", "description": "Filter on status attribute.\nComma separated list, with possible values `Active`, `Pending`, and `Disabled`.\nDefaults to no filtering." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get the list of all users in the organization. This list includes\nall users even if they are deactivated or unverified." }, { "info": { "name": "Datadog Create a User", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/users", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Create a user for your organization." }, { "info": { "name": "Datadog Get User Details", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/users/:user_id", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a user in the organization specified by the user’s `user_id`." }, { "info": { "name": "Datadog Update a User", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/users/:user_id", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Edit a user. Can only be used with an application key belonging\nto an administrator user." }, { "info": { "name": "Datadog Disable a User", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/users/:user_id", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Disable a user. Can only be used with an application key belonging\nto an administrator user." }, { "info": { "name": "Datadog Get a User Organization", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/users/:user_id/orgs", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a user organization. Returns the user information and all organizations\njoined by this user." }, { "info": { "name": "Datadog Get a User Permissions", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/users/:user_id/permissions", "params": [ { "name": "user_id", "value": "", "type": "path", "description": "The ID of the user." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a user permission set. Returns a list of the user’s permissions\ngranted by the associated user's roles." }, { "info": { "name": "Datadog Get User Memberships", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/users/:user_uuid/memberships", "params": [ { "name": "user_uuid", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a list of memberships for a user" } ] } ], "bundled": true }