From ee01899edf145d5750b65fe8c5f827cec3ff5151 Mon Sep 17 00:00:00 2001 From: "ci.datadog-api-spec" Date: Fri, 29 May 2026 14:26:49 +0000 Subject: [PATCH] Regenerate client from commit a4c8615 of spec repo --- config/_default/menus/api.en.yaml | 76 +++ .../latest/salesforce-integration/_index.md | 3 + .../api/v2/salesforce-integration/_index.md | 4 + .../v2/salesforce-integration/examples.json | 353 ++++++++++++ data/api/v2/full_spec.yaml | 538 ++++++++++++++++++ data/api/v2/translate_actions.json | 28 + data/api/v2/translate_tags.json | 4 + 7 files changed, 1006 insertions(+) create mode 100644 content/en/api/latest/salesforce-integration/_index.md create mode 100644 content/en/api/v2/salesforce-integration/_index.md create mode 100644 content/en/api/v2/salesforce-integration/examples.json diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index 1748fe7df8a..f200f3cd01a 100644 --- a/config/_default/menus/api.en.yaml +++ b/config/_default/menus/api.en.yaml @@ -16151,6 +16151,82 @@ menu: - ListSCIMGroups unstable: [] order: 7 + - name: Salesforce Integration + url: /api/latest/salesforce-integration/ + identifier: salesforce-integration + generated: true + - name: Delete a connected Salesforce organization + url: '#delete-a-connected-salesforce-organization' + identifier: salesforce-integration-delete-a-connected-salesforce-organization + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - DeleteSalesforceOrganization + unstable: [] + order: 2 + - name: Get all connected Salesforce organizations + url: '#get-all-connected-salesforce-organizations' + identifier: salesforce-integration-get-all-connected-salesforce-organizations + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - GetSalesforceOrganizations + unstable: [] + order: 1 + - name: Update a Salesforce incident template + url: '#update-a-salesforce-incident-template' + identifier: salesforce-integration-update-a-salesforce-incident-template + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - UpdateIncidentTemplate + unstable: [] + order: 5 + - name: Delete a Salesforce incident template + url: '#delete-a-salesforce-incident-template' + identifier: salesforce-integration-delete-a-salesforce-incident-template + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - DeleteIncidentTemplate + unstable: [] + order: 6 + - name: Create a Salesforce incident template + url: '#create-a-salesforce-incident-template' + identifier: salesforce-integration-create-a-salesforce-incident-template + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - CreateIncidentTemplate + unstable: [] + order: 4 + - name: Get all Salesforce incident templates + url: '#get-all-salesforce-incident-templates' + identifier: salesforce-integration-get-all-salesforce-incident-templates + parent: salesforce-integration + generated: true + params: + versions: + - v2 + operationids: + - GetIncidentTemplates + unstable: [] + order: 3 - name: Scorecards url: /api/latest/scorecards/ identifier: scorecards diff --git a/content/en/api/latest/salesforce-integration/_index.md b/content/en/api/latest/salesforce-integration/_index.md new file mode 100644 index 00000000000..1a331565474 --- /dev/null +++ b/content/en/api/latest/salesforce-integration/_index.md @@ -0,0 +1,3 @@ +--- +title: Salesforce Integration +--- diff --git a/content/en/api/v2/salesforce-integration/_index.md b/content/en/api/v2/salesforce-integration/_index.md new file mode 100644 index 00000000000..a818424615d --- /dev/null +++ b/content/en/api/v2/salesforce-integration/_index.md @@ -0,0 +1,4 @@ +--- +title: Salesforce Integration +headless: true +--- diff --git a/content/en/api/v2/salesforce-integration/examples.json b/content/en/api/v2/salesforce-integration/examples.json new file mode 100644 index 00000000000..9125414fa1e --- /dev/null +++ b/content/en/api/v2/salesforce-integration/examples.json @@ -0,0 +1,353 @@ +{ + "GetIncidentTemplates": { + "responses": { + "200": { + "json": { + "data": [ + { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-incident-template" + } + ] + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

An array of Salesforce incident templates.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Salesforce incident template attributes returned by the API.

\n
\n
\n
\n
\n
\n

description

\n
\n

string

\n

Long-form description body for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Human-readable name for this incident template.

\n
\n \n
\n
\n
\n
\n
\n

owner_id

\n
\n

string

\n

The Salesforce user ID that owns incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

priority

\n
\n

enum

\n

Priority of the Salesforce incident created from this template. \nAllowed enum values: Critical,High,Moderate,Low

\n
\n \n
\n
\n
\n
\n
\n

salesforce_org_id

\n
\n

uuid

\n

The Datadog-assigned ID of the Salesforce organization this template belongs to.

\n
\n \n
\n
\n
\n
\n
\n

subject

\n
\n

string

\n

Subject line for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The ID of the Salesforce incident template.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce incident template resource type. \nAllowed enum values: salesforce-incidents-incident-template

default: salesforce-incidents-incident-template

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": {}, + "json": {}, + "html": "" + } + }, + "CreateIncidentTemplate": { + "responses": { + "201": { + "json": { + "data": { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-incident-template" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Salesforce incident template data from a response.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Salesforce incident template attributes returned by the API.

\n
\n
\n
\n
\n
\n

description

\n
\n

string

\n

Long-form description body for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Human-readable name for this incident template.

\n
\n \n
\n
\n
\n
\n
\n

owner_id

\n
\n

string

\n

The Salesforce user ID that owns incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

priority

\n
\n

enum

\n

Priority of the Salesforce incident created from this template. \nAllowed enum values: Critical,High,Moderate,Low

\n
\n \n
\n
\n
\n
\n
\n

salesforce_org_id

\n
\n

uuid

\n

The Datadog-assigned ID of the Salesforce organization this template belongs to.

\n
\n \n
\n
\n
\n
\n
\n

subject

\n
\n

string

\n

Subject line for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The ID of the Salesforce incident template.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce incident template resource type. \nAllowed enum values: salesforce-incidents-incident-template

default: salesforce-incidents-incident-template

\n
\n \n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "409": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": { + "data": { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "type": "salesforce-incidents-incident-template" + } + }, + "json": { + "data": { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "type": "salesforce-incidents-incident-template" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Salesforce incident template data for a create request.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Salesforce incident template attributes for a create request.

\n
\n
\n
\n
\n
\n

description [required]

\n
\n

string

\n

Long-form description body for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

name [required]

\n
\n

string

\n

Human-readable name for this incident template. Must be unique within your organization.

\n
\n \n
\n
\n
\n
\n
\n

owner_id [required]

\n
\n

string

\n

The Salesforce user ID that owns incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

priority [required]

\n
\n

enum

\n

Priority of the Salesforce incident created from this template. \nAllowed enum values: Critical,High,Moderate,Low

\n
\n \n
\n
\n
\n
\n
\n

salesforce_org_id [required]

\n
\n

uuid

\n

The Datadog-assigned ID of the Salesforce organization this template belongs to.

\n
\n \n
\n
\n
\n
\n
\n

subject [required]

\n
\n

string

\n

Subject line for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce incident template resource type. \nAllowed enum values: salesforce-incidents-incident-template

default: salesforce-incidents-incident-template

\n
\n \n
\n
\n
\n
" + } + }, + "DeleteIncidentTemplate": { + "responses": { + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": {}, + "json": {}, + "html": "" + } + }, + "UpdateIncidentTemplate": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-incident-template" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Salesforce incident template data from a response.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Salesforce incident template attributes returned by the API.

\n
\n
\n
\n
\n
\n

description

\n
\n

string

\n

Long-form description body for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Human-readable name for this incident template.

\n
\n \n
\n
\n
\n
\n
\n

owner_id

\n
\n

string

\n

The Salesforce user ID that owns incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

priority

\n
\n

enum

\n

Priority of the Salesforce incident created from this template. \nAllowed enum values: Critical,High,Moderate,Low

\n
\n \n
\n
\n
\n
\n
\n

salesforce_org_id

\n
\n

uuid

\n

The Datadog-assigned ID of the Salesforce organization this template belongs to.

\n
\n \n
\n
\n
\n
\n
\n

subject

\n
\n

string

\n

Subject line for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The ID of the Salesforce incident template.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce incident template resource type. \nAllowed enum values: salesforce-incidents-incident-template

default: salesforce-incidents-incident-template

\n
\n \n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "409": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": { + "data": { + "attributes": {}, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-incident-template" + } + }, + "json": { + "data": { + "attributes": { + "description": "An incident was detected by Datadog monitors.", + "name": "production-outage", + "owner_id": "005000000000000", + "priority": "High", + "salesforce_org_id": "596da4af-0563-4097-90ff-07230c3f9db3", + "subject": "Datadog Incident: Production Outage" + }, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-incident-template" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

Salesforce incident template data for an update request.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Salesforce incident template attributes for an update request.

\n
\n
\n
\n
\n
\n

description

\n
\n

string

\n

Long-form description body for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Human-readable name for this incident template.

\n
\n \n
\n
\n
\n
\n
\n

owner_id

\n
\n

string

\n

The Salesforce user ID that owns incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n

priority

\n
\n

enum

\n

Priority of the Salesforce incident created from this template. \nAllowed enum values: Critical,High,Moderate,Low

\n
\n \n
\n
\n
\n
\n
\n

salesforce_org_id

\n
\n

uuid

\n

The Datadog-assigned ID of the Salesforce organization this template belongs to.

\n
\n \n
\n
\n
\n
\n
\n

subject

\n
\n

string

\n

Subject line for Salesforce incidents created from this template.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The ID of the Salesforce incident template being updated. Must match the path parameter.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce incident template resource type. \nAllowed enum values: salesforce-incidents-incident-template

default: salesforce-incidents-incident-template

\n
\n \n
\n
\n
\n
" + } + }, + "GetSalesforceOrganizations": { + "responses": { + "200": { + "json": { + "data": [ + { + "attributes": { + "instance_url": "https://acme.my.salesforce.com", + "name": "Acme Production Org", + "sfdc_org_id": "00D000000000000", + "sfdc_org_type": "Production" + }, + "id": "596da4af-0563-4097-90ff-07230c3f9db3", + "type": "salesforce-incidents-org" + } + ] + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

[object]

\n

An array of Salesforce organizations.

\n
\n
\n
\n
\n
\n

attributes [required]

\n
\n

object

\n

Attributes of a Salesforce organization connected to the Datadog Salesforce integration.

\n
\n
\n
\n
\n
\n

instance_url

\n
\n

string

\n

The Salesforce instance URL used to call this organization's APIs.

\n
\n \n
\n
\n
\n
\n
\n

name

\n
\n

string

\n

Human-readable name of the Salesforce organization.

\n
\n \n
\n
\n
\n
\n
\n

sfdc_org_id

\n
\n

string

\n

The Salesforce organization identifier (15- or 18-character Salesforce org ID).

\n
\n \n
\n
\n
\n
\n
\n

sfdc_org_type

\n
\n

string

\n

The Salesforce organization type (for example, Production or Sandbox).

\n
\n \n
\n
\n
\n
\n
\n
\n
\n

id [required]

\n
\n

string

\n

The Datadog-assigned ID of the connected Salesforce organization.

\n
\n \n
\n
\n
\n
\n
\n

type [required]

\n
\n

enum

\n

Salesforce organization resource type. \nAllowed enum values: salesforce-incidents-org

default: salesforce-incidents-org

\n
\n \n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": {}, + "json": {}, + "html": "" + } + }, + "DeleteSalesforceOrganization": { + "responses": { + "400": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "403": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "404": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + }, + "429": { + "json": { + "errors": [ + "Bad Request" + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[string]

\n

A list of errors.

\n
\n \n
\n
" + } + }, + "request": { + "json_curl": {}, + "json": {}, + "html": "" + } + } +} \ No newline at end of file diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml index 306ca0d990c..534fc5543f8 100644 --- a/data/api/v2/full_spec.yaml +++ b/data/api/v2/full_spec.yaml @@ -1558,6 +1558,20 @@ components: required: true schema: type: string + SalesforceIncidentsOrganizationIDPathParameter: + description: The Datadog-assigned ID of the connected Salesforce organization. + in: path + name: salesforce_org_id + required: true + schema: + type: string + SalesforceIncidentsTemplateIDPathParameter: + description: The ID of the Salesforce incident template. + in: path + name: incident_template_id + required: true + schema: + type: string SampleLogGenerationContentPackID: description: The identifier of the Cloud SIEM content pack to operate on (for example, `aws-cloudtrail`). in: path @@ -73399,6 +73413,275 @@ components: example: "report_id" type: string type: object + SalesforceIncidentsOrganizationResponseAttributes: + description: Attributes of a Salesforce organization connected to the Datadog Salesforce integration. + properties: + instance_url: + description: The Salesforce instance URL used to call this organization's APIs. + example: "https://acme.my.salesforce.com" + type: string + name: + description: Human-readable name of the Salesforce organization. + example: "Acme Production Org" + type: string + sfdc_org_id: + description: The Salesforce organization identifier (15- or 18-character Salesforce org ID). + example: "00D000000000000" + type: string + sfdc_org_type: + description: The Salesforce organization type (for example, `Production` or `Sandbox`). + example: "Production" + type: string + type: object + SalesforceIncidentsOrganizationResponseData: + description: Salesforce organization data from a response. + properties: + attributes: + $ref: "#/components/schemas/SalesforceIncidentsOrganizationResponseAttributes" + id: + description: The Datadog-assigned ID of the connected Salesforce organization. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + maxLength: 100 + minLength: 1 + type: string + type: + $ref: "#/components/schemas/SalesforceIncidentsOrganizationType" + required: + - id + - type + - attributes + type: object + SalesforceIncidentsOrganizationType: + default: salesforce-incidents-org + description: Salesforce organization resource type. + enum: + - salesforce-incidents-org + example: salesforce-incidents-org + type: string + x-enum-varnames: + - SALESFORCE_INCIDENTS_ORG + SalesforceIncidentsOrganizationsResponse: + description: |- + Response containing a list of Salesforce organizations connected to the + Datadog Salesforce integration. + properties: + data: + description: An array of Salesforce organizations. + items: + $ref: "#/components/schemas/SalesforceIncidentsOrganizationResponseData" + type: array + required: + - data + type: object + SalesforceIncidentsTemplateCreateAttributes: + description: Salesforce incident template attributes for a create request. + properties: + description: + description: Long-form description body for Salesforce incidents created from this template. + example: "An incident was detected by Datadog monitors." + maxLength: 2048 + minLength: 1 + type: string + name: + description: Human-readable name for this incident template. Must be unique within your organization. + example: "production-outage" + maxLength: 100 + minLength: 1 + type: string + owner_id: + description: The Salesforce user ID that owns incidents created from this template. + example: "005000000000000" + maxLength: 255 + minLength: 1 + type: string + priority: + $ref: "#/components/schemas/SalesforceIncidentsTemplatePriority" + salesforce_org_id: + description: The Datadog-assigned ID of the Salesforce organization this template belongs to. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + format: uuid + type: string + subject: + description: Subject line for Salesforce incidents created from this template. + example: "Datadog Incident: Production Outage" + maxLength: 255 + minLength: 1 + type: string + required: + - salesforce_org_id + - name + - subject + - description + - owner_id + - priority + type: object + SalesforceIncidentsTemplateCreateData: + description: Salesforce incident template data for a create request. + properties: + attributes: + $ref: "#/components/schemas/SalesforceIncidentsTemplateCreateAttributes" + type: + $ref: "#/components/schemas/SalesforceIncidentsTemplateType" + required: + - type + - attributes + type: object + SalesforceIncidentsTemplateCreateRequest: + description: Create request for a Salesforce incident template. + properties: + data: + $ref: "#/components/schemas/SalesforceIncidentsTemplateCreateData" + required: + - data + type: object + SalesforceIncidentsTemplatePriority: + description: Priority of the Salesforce incident created from this template. + enum: + - Critical + - High + - Moderate + - Low + example: "High" + type: string + x-enum-varnames: + - CRITICAL + - HIGH + - MODERATE + - LOW + SalesforceIncidentsTemplateResponse: + description: Response containing a Salesforce incident template. + properties: + data: + $ref: "#/components/schemas/SalesforceIncidentsTemplateResponseData" + required: + - data + type: object + SalesforceIncidentsTemplateResponseAttributes: + description: Salesforce incident template attributes returned by the API. + properties: + description: + description: Long-form description body for Salesforce incidents created from this template. + example: "An incident was detected by Datadog monitors." + type: string + name: + description: Human-readable name for this incident template. + example: "production-outage" + type: string + owner_id: + description: The Salesforce user ID that owns incidents created from this template. + example: "005000000000000" + type: string + priority: + $ref: "#/components/schemas/SalesforceIncidentsTemplatePriority" + salesforce_org_id: + description: The Datadog-assigned ID of the Salesforce organization this template belongs to. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + format: uuid + type: string + subject: + description: Subject line for Salesforce incidents created from this template. + example: "Datadog Incident: Production Outage" + type: string + type: object + SalesforceIncidentsTemplateResponseData: + description: Salesforce incident template data from a response. + properties: + attributes: + $ref: "#/components/schemas/SalesforceIncidentsTemplateResponseAttributes" + id: + description: The ID of the Salesforce incident template. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + maxLength: 100 + minLength: 1 + type: string + type: + $ref: "#/components/schemas/SalesforceIncidentsTemplateType" + required: + - id + - type + - attributes + type: object + SalesforceIncidentsTemplateType: + default: salesforce-incidents-incident-template + description: Salesforce incident template resource type. + enum: + - salesforce-incidents-incident-template + example: salesforce-incidents-incident-template + type: string + x-enum-varnames: + - SALESFORCE_INCIDENTS_INCIDENT_TEMPLATE + SalesforceIncidentsTemplateUpdateAttributes: + description: Salesforce incident template attributes for an update request. + properties: + description: + description: Long-form description body for Salesforce incidents created from this template. + example: "An incident was detected by Datadog monitors." + maxLength: 2048 + minLength: 1 + type: string + name: + description: Human-readable name for this incident template. + example: "production-outage" + maxLength: 100 + minLength: 1 + type: string + owner_id: + description: The Salesforce user ID that owns incidents created from this template. + example: "005000000000000" + maxLength: 255 + minLength: 1 + type: string + priority: + $ref: "#/components/schemas/SalesforceIncidentsTemplatePriority" + salesforce_org_id: + description: The Datadog-assigned ID of the Salesforce organization this template belongs to. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + format: uuid + type: string + subject: + description: Subject line for Salesforce incidents created from this template. + example: "Datadog Incident: Production Outage" + maxLength: 255 + minLength: 1 + type: string + type: object + SalesforceIncidentsTemplateUpdateData: + description: Salesforce incident template data for an update request. + properties: + attributes: + $ref: "#/components/schemas/SalesforceIncidentsTemplateUpdateAttributes" + id: + description: The ID of the Salesforce incident template being updated. Must match the path parameter. + example: "596da4af-0563-4097-90ff-07230c3f9db3" + maxLength: 100 + minLength: 1 + type: string + type: + $ref: "#/components/schemas/SalesforceIncidentsTemplateType" + required: + - id + - type + - attributes + type: object + SalesforceIncidentsTemplateUpdateRequest: + description: Update request for a Salesforce incident template. + properties: + data: + $ref: "#/components/schemas/SalesforceIncidentsTemplateUpdateData" + required: + - data + type: object + SalesforceIncidentsTemplatesResponse: + description: Response containing a list of Salesforce incident templates. + properties: + data: + description: An array of Salesforce incident templates. + items: + $ref: "#/components/schemas/SalesforceIncidentsTemplateResponseData" + type: array + required: + - data + type: object SampleLogGenerationBulkSubscriptionAttributes: description: The attributes for creating sample log generation subscriptions for multiple content packs. properties: @@ -127194,6 +127477,255 @@ paths: operator: OR permissions: - manage_integrations + /api/v2/integration/salesforce-incidents/incident-templates: + get: + description: Get all Salesforce incident templates configured for your organization. + operationId: GetIncidentTemplates + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + - attributes: + description: An incident was detected by Datadog monitors. + name: production-outage + owner_id: "005000000000000" + priority: High + salesforce_org_id: 596da4af-0563-4097-90ff-07230c3f9db3 + subject: "Datadog Incident: Production Outage" + id: 00000000-0000-0000-0000-000000000001 + type: salesforce-incidents-incident-template + schema: + $ref: "#/components/schemas/SalesforceIncidentsTemplatesResponse" + description: OK + "403": + $ref: "#/components/responses/ForbiddenResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Get all Salesforce incident templates + tags: + - Salesforce Integration + x-menu-order: 3 + "x-permission": + operator: OR + permissions: + - integrations_read + post: + description: |- + Create a new Salesforce incident template for your organization. Template + names must be unique within an organization. + operationId: CreateIncidentTemplate + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + description: An incident was detected by Datadog monitors. + name: production-outage + owner_id: "005000000000000" + priority: High + salesforce_org_id: 596da4af-0563-4097-90ff-07230c3f9db3 + subject: "Datadog Incident: Production Outage" + type: salesforce-incidents-incident-template + schema: + $ref: "#/components/schemas/SalesforceIncidentsTemplateCreateRequest" + description: Salesforce incident template payload. + required: true + responses: + "201": + content: + application/json: + examples: + default: + value: + data: + attributes: + description: An incident was detected by Datadog monitors. + name: production-outage + owner_id: "005000000000000" + priority: High + salesforce_org_id: 596da4af-0563-4097-90ff-07230c3f9db3 + subject: "Datadog Incident: Production Outage" + id: 00000000-0000-0000-0000-000000000002 + type: salesforce-incidents-incident-template + schema: + $ref: "#/components/schemas/SalesforceIncidentsTemplateResponse" + description: CREATED + "400": + $ref: "#/components/responses/BadRequestResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "409": + $ref: "#/components/responses/ConflictResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Create a Salesforce incident template + tags: + - Salesforce Integration + x-codegen-request-body-name: body + x-menu-order: 4 + "x-permission": + operator: OR + permissions: + - manage_integrations + /api/v2/integration/salesforce-incidents/incident-templates/{incident_template_id}: + delete: + description: Delete a single Salesforce incident template from your organization. + operationId: DeleteIncidentTemplate + parameters: + - $ref: "#/components/parameters/SalesforceIncidentsTemplateIDPathParameter" + responses: + "204": + description: OK + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Delete a Salesforce incident template + tags: + - Salesforce Integration + x-menu-order: 6 + "x-permission": + operator: OR + permissions: + - manage_integrations + patch: + description: Update a single Salesforce incident template in your organization. + operationId: UpdateIncidentTemplate + parameters: + - $ref: "#/components/parameters/SalesforceIncidentsTemplateIDPathParameter" + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + name: production-outage-renamed + id: 596da4af-0563-4097-90ff-07230c3f9db3 + type: salesforce-incidents-incident-template + schema: + $ref: "#/components/schemas/SalesforceIncidentsTemplateUpdateRequest" + description: Salesforce incident template payload. + required: true + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + attributes: + description: An incident was detected by Datadog monitors. + name: production-outage-renamed + owner_id: "005000000000000" + priority: High + salesforce_org_id: 596da4af-0563-4097-90ff-07230c3f9db3 + subject: "Datadog Incident: Production Outage" + id: 00000000-0000-0000-0000-000000000003 + type: salesforce-incidents-incident-template + schema: + $ref: "#/components/schemas/SalesforceIncidentsTemplateResponse" + description: OK + "400": + $ref: "#/components/responses/BadRequestResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "409": + $ref: "#/components/responses/ConflictResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Update a Salesforce incident template + tags: + - Salesforce Integration + x-codegen-request-body-name: body + x-menu-order: 5 + "x-permission": + operator: OR + permissions: + - manage_integrations + /api/v2/integration/salesforce-incidents/organizations: + get: + description: |- + Get all Salesforce organizations connected to your Datadog organization + through the Salesforce integration. Salesforce organizations are connected + through the OAuth setup flow in the Datadog Salesforce integration page. + operationId: GetSalesforceOrganizations + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + - attributes: + instance_url: "https://acme.my.salesforce.com" + name: "Acme Production Org" + sfdc_org_id: "00D000000000000" + sfdc_org_type: "Production" + id: 00000000-0000-0000-0000-000000000001 + type: salesforce-incidents-org + schema: + $ref: "#/components/schemas/SalesforceIncidentsOrganizationsResponse" + description: OK + "400": + $ref: "#/components/responses/BadRequestResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Get all connected Salesforce organizations + tags: + - Salesforce Integration + x-menu-order: 1 + "x-permission": + operator: OR + permissions: + - integrations_read + /api/v2/integration/salesforce-incidents/organizations/{salesforce_org_id}: + delete: + description: |- + Disconnect a Salesforce organization from your Datadog organization. + This also deletes any incident templates referencing the organization. + operationId: DeleteSalesforceOrganization + parameters: + - $ref: "#/components/parameters/SalesforceIncidentsOrganizationIDPathParameter" + responses: + "204": + description: OK + "400": + $ref: "#/components/responses/BadRequestResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Delete a connected Salesforce organization + tags: + - Salesforce Integration + x-menu-order: 2 + "x-permission": + operator: OR + permissions: + - manage_integrations /api/v2/integration/servicenow/assignment_groups/{instance_id}: get: description: |- @@ -174595,6 +175127,12 @@ tags: Note: SCIM provisioning for Datadog teams is only available for select organizations at this point. Request access by contacting Datadog support, or see the [SCIM page](https://docs.datadoghq.com/account_management/scim/) for more information. name: SCIM + - description: |- + Configure your [Datadog Salesforce integration](https://docs.datadoghq.com/integrations/salesforce/) + directly through the Datadog API. + externalDocs: + url: https://docs.datadoghq.com/api/latest/salesforce-integration + name: Salesforce Integration - description: |- API to create and update scorecard rules and outcomes. See [Scorecards](https://docs.datadoghq.com/service_catalog/scorecards) for more information. name: Scorecards diff --git a/data/api/v2/translate_actions.json b/data/api/v2/translate_actions.json index db47d9f215a..5fd0e07e228 100644 --- a/data/api/v2/translate_actions.json +++ b/data/api/v2/translate_actions.json @@ -2392,6 +2392,34 @@ "request_description": "Opsgenie service payload.", "request_schema_description": "Update request for an Opsgenie service." }, + "GetIncidentTemplates": { + "description": "Get all Salesforce incident templates configured for your organization.", + "summary": "Get all Salesforce incident templates" + }, + "CreateIncidentTemplate": { + "description": "Create a new Salesforce incident template for your organization. Template\nnames must be unique within an organization.", + "summary": "Create a Salesforce incident template", + "request_description": "Salesforce incident template payload.", + "request_schema_description": "Create request for a Salesforce incident template." + }, + "DeleteIncidentTemplate": { + "description": "Delete a single Salesforce incident template from your organization.", + "summary": "Delete a Salesforce incident template" + }, + "UpdateIncidentTemplate": { + "description": "Update a single Salesforce incident template in your organization.", + "summary": "Update a Salesforce incident template", + "request_description": "Salesforce incident template payload.", + "request_schema_description": "Update request for a Salesforce incident template." + }, + "GetSalesforceOrganizations": { + "description": "Get all Salesforce organizations connected to your Datadog organization\nthrough the Salesforce integration. Salesforce organizations are connected\nthrough the OAuth setup flow in the Datadog Salesforce integration page.", + "summary": "Get all connected Salesforce organizations" + }, + "DeleteSalesforceOrganization": { + "description": "Disconnect a Salesforce organization from your Datadog organization.\nThis also deletes any incident templates referencing the organization.", + "summary": "Delete a connected Salesforce organization" + }, "ListServiceNowAssignmentGroups": { "description": "Get all assignment groups for a ServiceNow instance.", "summary": "List ServiceNow assignment groups" diff --git a/data/api/v2/translate_tags.json b/data/api/v2/translate_tags.json index ed775bc4206..286e6e16904 100644 --- a/data/api/v2/translate_tags.json +++ b/data/api/v2/translate_tags.json @@ -371,6 +371,10 @@ "name": "SCIM", "description": "Provision Datadog users and teams using SCIM APIs.\n\nNote: SCIM provisioning for Datadog teams is only available for select organizations at this point. Request access by contacting Datadog support, or see the [SCIM page](https://docs.datadoghq.com/account_management/scim/) for more information." }, + "salesforce-integration": { + "name": "Salesforce Integration", + "description": "Configure your [Datadog Salesforce integration](https://docs.datadoghq.com/integrations/salesforce/)\ndirectly through the Datadog API." + }, "scorecards": { "name": "Scorecards", "description": "API to create and update scorecard rules and outcomes. See [Scorecards](https://docs.datadoghq.com/service_catalog/scorecards) for more information."