{ "opencollection": "1.0.0", "info": { "name": "Datadog Account Teams API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "items": [ { "info": { "name": "Teams", "type": "folder" }, "items": [ { "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 On-call Team Routing Rules", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/on-call/teams/:team_id/routing-rules", "params": [ { "name": "team_id", "value": "27590dae-47be-4a7d-9abf-8f4e45124020", "type": "path", "description": "The team ID" }, { "name": "include", "value": "example_value", "type": "query", "description": "Comma-separated list of included relationships to be returned. Allowed values: `rules`, `rules.policy`." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a team's On-Call routing rules" }, { "info": { "name": "Datadog Set On-call Team Routing Rules", "type": "http" }, "http": { "method": "PUT", "url": "https://{subdomain}.{site}/api/v2/on-call/teams/:team_id/routing-rules", "params": [ { "name": "team_id", "value": "27590dae-47be-4a7d-9abf-8f4e45124020", "type": "path", "description": "The team ID" }, { "name": "include", "value": "example_value", "type": "query", "description": "Comma-separated list of included relationships to be returned. Allowed values: `rules`, `rules.policy`." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Set a team's On-Call routing rules" }, { "info": { "name": "Datadog Get All Teams", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team", "params": [ { "name": "page[number]", "value": "", "type": "query", "description": "Specific page number to return." }, { "name": "page[size]", "value": "", "type": "query", "description": "Size for a given page. The maximum allowed value is 100." }, { "name": "sort", "value": "example_value", "type": "query", "description": "Specifies the order of the returned teams" }, { "name": "include", "value": "", "type": "query", "description": "Included related resources optionally requested. Allowed enum values: `team_links, user_team_permissions`" }, { "name": "filter[keyword]", "value": "example_value", "type": "query", "description": "Search query. Can be team name, team handle, or email of team member" }, { "name": "filter[me]", "value": "true", "type": "query", "description": "When true, only returns teams the current user belongs to" }, { "name": "fields[team]", "value": "", "type": "query", "description": "List of fields that need to be fetched." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get all teams.\nCan be used to search for teams using the `filter[keyword]` and `filter[me]` query parameters." }, { "info": { "name": "Datadog Create a Team", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/team", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Create a new team.\nUser IDs passed through the `users` relationship field are added to the team." }, { "info": { "name": "Datadog Get a Team", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team/:team_id", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a single team using the team's `id`." }, { "info": { "name": "Datadog Update a Team", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/team/:team_id", "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": "Update a team using the team's `id`.\nIf the `team_links` relationship is present, the associated links are updated to be in the order they appear in the array, and any existing team links not present are removed." }, { "info": { "name": "Datadog Remove a Team", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/team/:team_id", "params": [ { "name": "team_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 team using the team's `id`." }, { "info": { "name": "Datadog Get Links for a Team", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/links", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get all links for a given team." }, { "info": { "name": "Datadog Create a Team Link", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/links", "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 new link to a team." }, { "info": { "name": "Datadog Get a Team Link", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/links/:link_id", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "name": "link_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a single link for a team." }, { "info": { "name": "Datadog Update a Team Link", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/links/:link_id", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "name": "link_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": "Update a team link." }, { "info": { "name": "Datadog Remove a Team Link", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/links/:link_id", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "name": "link_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 link from a team." }, { "info": { "name": "Datadog Get Team Memberships", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/memberships", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "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": "Specifies the order of returned team memberships" }, { "name": "filter[keyword]", "value": "example_value", "type": "query", "description": "Search query, can be user email or name" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get a paginated list of members for a team" }, { "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 Update a User's Membership Attributes on a Team", "type": "http" }, "http": { "method": "PATCH", "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" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Update a user's membership attributes on 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 Permission Settings for a Team", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/permission-settings", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get all permission settings for a given team." }, { "info": { "name": "Datadog Update Permission Setting for Team", "type": "http" }, "http": { "method": "PUT", "url": "https://{subdomain}.{site}/api/v2/team/:team_id/permission-settings/:action", "params": [ { "name": "team_id", "value": "abc-123-def", "type": "path", "description": "None" }, { "name": "action", "value": "example_value", "type": "path", "description": "None" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Update a team permission setting for a given team." }, { "info": { "name": "Datadog Get a List of All Incident Teams", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/teams", "params": [ { "name": "include", "value": "", "type": "query", "description": "Specifies which types of related objects should be included in the response." }, { "name": "page[size]", "value": "", "type": "query", "description": "Size for a given page. The maximum allowed value is 100." }, { "name": "page[offset]", "value": "", "type": "query", "description": "Specific offset to use as the beginning of the returned page." }, { "name": "filter", "value": "", "type": "query", "description": "A search query that filters teams by name." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get all incident teams for the requesting user's organization. If the `include[users]` query parameter is provided, the included attribute will contain the users related to these incident teams." }, { "info": { "name": "Datadog Create a New Incident Team", "type": "http" }, "http": { "method": "POST", "url": "https://{subdomain}.{site}/api/v2/teams", "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Creates a new incident team." }, { "info": { "name": "Datadog Get Details of an Incident Team", "type": "http" }, "http": { "method": "GET", "url": "https://{subdomain}.{site}/api/v2/teams/:team_id", "params": [ { "name": "team_id", "value": "", "type": "path", "description": "The ID of the incident team." }, { "name": "include", "value": "", "type": "query", "description": "Specifies which types of related objects should be included in the response." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Get details of an incident team. If the `include[users]` query parameter is provided,\nthe included attribute will contain the users related to these incident teams." }, { "info": { "name": "Datadog Update an Existing Incident Team", "type": "http" }, "http": { "method": "PATCH", "url": "https://{subdomain}.{site}/api/v2/teams/:team_id", "params": [ { "name": "team_id", "value": "", "type": "path", "description": "The ID of the incident team." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Updates an existing incident team. Only provide the attributes which should be updated as this request is a partial update." }, { "info": { "name": "Datadog Delete an Existing Incident Team", "type": "http" }, "http": { "method": "DELETE", "url": "https://{subdomain}.{site}/api/v2/teams/:team_id", "params": [ { "name": "team_id", "value": "", "type": "path", "description": "The ID of the incident team." } ], "auth": { "type": "apikey", "key": "DD-API-KEY", "value": "{{DD-API-KEY}}", "placement": "header" } }, "docs": "Deletes an existing incident team." } ] } ], "bundled": true }