diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index e850f44d14c..57c04701654 100644 --- a/config/_default/menus/api.en.yaml +++ b/config/_default/menus/api.en.yaml @@ -3722,6 +3722,66 @@ menu: url: /api/latest/synthetics/ identifier: synthetics generated: true + - name: 'Synthetics: edit a test suite' + url: '#synthetics-edit-a-test-suite' + identifier: synthetics-synthetics-edit-a-test-suite + parent: synthetics + generated: true + params: + versions: + - v2 + operationids: + - EditSyntheticsSuite + unstable: [] + order: 35 + - name: 'Synthetics: Get a suite' + url: '#synthetics-get-a-suite' + identifier: synthetics-synthetics-get-a-suite + parent: synthetics + generated: true + params: + versions: + - v2 + operationids: + - GetSyntheticsSuite + unstable: [] + order: 25 + - name: Search Synthetics suites + url: '#search-synthetics-suites' + identifier: synthetics-search-synthetics-suites + parent: synthetics + generated: true + params: + versions: + - v2 + operationids: + - SearchSuites + unstable: [] + order: 20 + - name: 'Synthetics: Bulk delete suites' + url: '#synthetics-bulk-delete-suites' + identifier: synthetics-synthetics-bulk-delete-suites + parent: synthetics + generated: true + params: + versions: + - v2 + operationids: + - DeleteSyntheticsSuites + unstable: [] + order: 40 + - name: 'Synthetics: Create a test suite' + url: '#synthetics-create-a-test-suite' + identifier: synthetics-synthetics-create-a-test-suite + parent: synthetics + generated: true + params: + versions: + - v2 + operationids: + - CreateSyntheticsSuite + unstable: [] + order: 30 - name: Save new value for on-demand concurrency cap url: '#save-new-value-for-on-demand-concurrency-cap' identifier: synthetics-save-new-value-for-on-demand-concurrency-cap diff --git a/content/en/api/v2/dora-metrics/examples.json b/content/en/api/v2/dora-metrics/examples.json index e01719a20be..44c3105b218 100644 --- a/content/en/api/v2/dora-metrics/examples.json +++ b/content/en/api/v2/dora-metrics/examples.json @@ -183,7 +183,7 @@ } ] }, - "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

The list of DORA events.

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

attributes

\n
\n

object

\n

The attributes of the event.

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

id

\n
\n

string

\n

The ID of the event.

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

type

\n
\n

string

\n

The type of the event.

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

The list of DORA deployment events.

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

attributes

\n
\n

object

\n

The attributes of the deployment event.

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

custom_tags

\n
\n

[string]

\n

A list of user-defined tags. The tags must follow the key:value pattern. Up to 100 may be added per event.

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

env

\n
\n

string

\n

Environment name to where the service was deployed.

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

finished_at [required]

\n
\n

int64

\n

Unix timestamp when the deployment finished.

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

git

\n
\n

object

\n

Git info for DORA Metrics events.

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

commit_sha [required]

\n
\n

string

\n

Git Commit SHA.

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

repository_url [required]

\n
\n

string

\n

Git Repository URL

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

service [required]

\n
\n

string

\n

Service name.

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

started_at [required]

\n
\n

int64

\n

Unix timestamp when the deployment started.

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

team

\n
\n

string

\n

Name of the team owning the deployed service.

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

version

\n
\n

string

\n

Version to correlate with APM Deployment Tracking.

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

id

\n
\n

string

\n

The ID of the deployment event.

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

type

\n
\n

enum

\n

JSON:API type for DORA deployment events. \nAllowed enum values: dora_deployment

default: dora_deployment

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -229,16 +229,16 @@ "json": { "data": { "attributes": { - "from": "2019-09-19T10:00:00.000Z", - "limit": "integer", - "query": "string", - "sort": "string", - "to": "2019-09-19T10:00:00.000Z" + "from": "2025-01-01T00:00:00Z", + "limit": 500, + "query": "service:(shopist OR api-service OR payment-service) env:(production OR staging) team:(backend OR platform)", + "sort": "-started_at", + "to": "2025-01-31T23:59:59Z" }, - "type": "string" + "type": "dora_deployments_list_request" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

The JSON:API data.

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

attributes [required]

\n
\n

object

\n

Attributes to get a list of deployments.

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

from

\n
\n

date-time

\n

Minimum timestamp for requested events.

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

limit

\n
\n

int32

\n

Maximum number of events in the response.

default: 10

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

query

\n
\n

string

\n

Search query with event platform syntax.

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

sort

\n
\n

string

\n

Sort order (prefixed with - for descending).

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

to

\n
\n

date-time

\n

Maximum timestamp for requested events.

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

type

\n
\n

enum

\n

The definition of DORAListDeploymentsRequestDataType object. \nAllowed enum values: dora_deployments_list_request

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

The JSON:API data.

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

attributes [required]

\n
\n

object

\n

Attributes to get a list of deployments.

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

from

\n
\n

date-time

\n

Minimum timestamp for requested events.

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

limit

\n
\n

int32

\n

Maximum number of events in the response.

default: 10

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

query

\n
\n

string

\n

Search query with event platform syntax.

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

sort

\n
\n

string

\n

Sort order (prefixed with - for descending).

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

to

\n
\n

date-time

\n

Maximum timestamp for requested events.

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

type

\n
\n

enum

\n

The definition of DORAListDeploymentsRequestDataType object. \nAllowed enum values: dora_deployments_list_request

default: dora_deployments_list_request

\n
\n \n
\n
\n
\n
" } }, "GetDORADeployment": { @@ -246,12 +246,27 @@ "200": { "json": { "data": { - "attributes": {}, + "attributes": { + "custom_tags": [ + "language:java", + "department:engineering" + ], + "env": "production", + "finished_at": 1693491984000000000, + "git": { + "commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", + "repository_url": "https://github.com/organization/example-repository" + }, + "service": "shopist", + "started_at": 1693491974000000000, + "team": "backend", + "version": "v1.12.07" + }, "id": "string", - "type": "string" + "type": "dora_deployment" } }, - "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

A DORA event.

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

attributes

\n
\n

object

\n

The attributes of the event.

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

id

\n
\n

string

\n

The ID of the event.

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

type

\n
\n

string

\n

The type of the event.

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

A DORA deployment event.

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

attributes

\n
\n

object

\n

The attributes of the deployment event.

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

custom_tags

\n
\n

[string]

\n

A list of user-defined tags. The tags must follow the key:value pattern. Up to 100 may be added per event.

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

env

\n
\n

string

\n

Environment name to where the service was deployed.

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

finished_at [required]

\n
\n

int64

\n

Unix timestamp when the deployment finished.

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

git

\n
\n

object

\n

Git info for DORA Metrics events.

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

commit_sha [required]

\n
\n

string

\n

Git Commit SHA.

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

repository_url [required]

\n
\n

string

\n

Git Repository URL

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

service [required]

\n
\n

string

\n

Service name.

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

started_at [required]

\n
\n

int64

\n

Unix timestamp when the deployment started.

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

team

\n
\n

string

\n

Name of the team owning the deployed service.

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

version

\n
\n

string

\n

Version to correlate with APM Deployment Tracking.

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

id

\n
\n

string

\n

The ID of the deployment event.

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

type

\n
\n

enum

\n

JSON:API type for DORA deployment events. \nAllowed enum values: dora_deployment

default: dora_deployment

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -440,47 +455,45 @@ { "attributes": { "custom_tags": [ - "language:java", - "department:engineering", - "region:us-east-1" + "incident_type:database", + "department:engineering" ], "env": "production", - "finished_at": 1693491984000000000, - "git": { - "commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", - "repository_url": "https://github.com/organization/example-repository" - }, - "service": "shopist", - "started_at": 1693491974000000000, - "team": "backend", - "version": "v1.12.07" + "finished_at": 1693492274000000000, + "name": "Database outage", + "services": [ + "shopist" + ], + "severity": "SEV-1", + "started_at": 1693492174000000000, + "team": "backend" }, - "id": "4242fcdd31586083", - "type": "dora_deployment" + "id": "4242fcdd31586085", + "type": "dora_incident" }, { "attributes": { "custom_tags": [ - "language:go", + "incident_type:service_down", "department:platform" ], "env": "production", - "finished_at": 1693492084000000000, - "git": { - "commit_sha": "77bdc9350f2cc9b250b69abddab733dd55e1a599", - "repository_url": "https://github.com/organization/api-service" - }, - "service": "api-service", - "started_at": 1693492074000000000, - "team": "backend", - "version": "v2.1.0" + "finished_at": 1693492474000000000, + "name": "API service outage", + "services": [ + "api-service", + "payment-service" + ], + "severity": "SEV-2", + "started_at": 1693492374000000000, + "team": "backend" }, - "id": "4242fcdd31586084", - "type": "dora_deployment" + "id": "4242fcdd31586086", + "type": "dora_incident" } ] }, - "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

The list of DORA events.

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

attributes

\n
\n

object

\n

The attributes of the event.

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

id

\n
\n

string

\n

The ID of the event.

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

type

\n
\n

string

\n

The type of the event.

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

The list of DORA incident events.

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

attributes

\n
\n

object

\n

The attributes of the incident event.

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

custom_tags

\n
\n

[string]

\n

A list of user-defined tags. The tags must follow the key:value pattern. Up to 100 may be added per event.

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

env

\n
\n

string

\n

Environment name that was impacted by the incident.

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

finished_at

\n
\n

int64

\n

Unix timestamp when the incident finished.

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

git

\n
\n

object

\n

Git info for DORA Metrics events.

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

commit_sha [required]

\n
\n

string

\n

Git Commit SHA.

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

repository_url [required]

\n
\n

string

\n

Git Repository URL

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

name

\n
\n

string

\n

Incident name.

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

services

\n
\n

[string]

\n

Service names impacted by the incident.

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

severity

\n
\n

string

\n

Incident severity.

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

started_at [required]

\n
\n

int64

\n

Unix timestamp when the incident started.

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

team

\n
\n

string

\n

Name of the team owning the services impacted.

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

version

\n
\n

string

\n

Version to correlate with APM Deployment Tracking.

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

id

\n
\n

string

\n

The ID of the incident event.

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

type

\n
\n

enum

\n

JSON:API type for DORA failure events. \nAllowed enum values: dora_failure

default: dora_failure

\n
\n \n
\n
\n
\n
" }, "400": { "json": { @@ -526,16 +539,16 @@ "json": { "data": { "attributes": { - "from": "2019-09-19T10:00:00.000Z", - "limit": "integer", - "query": "string", - "sort": "string", - "to": "2019-09-19T10:00:00.000Z" + "from": "2025-01-01T00:00:00Z", + "limit": 500, + "query": "severity:(SEV-1 OR SEV-2) env:(production OR staging) service:(shopist OR api-service OR payment-service) team:(backend OR platform OR payments)", + "sort": "-started_at", + "to": "2025-01-31T23:59:59Z" }, - "type": "string" + "type": "dora_failures_list_request" } }, - "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

The JSON:API data.

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

attributes [required]

\n
\n

object

\n

Attributes to get a list of failures.

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

from

\n
\n

date-time

\n

Minimum timestamp for requested events.

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

limit

\n
\n

int32

\n

Maximum number of events in the response.

default: 10

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

query

\n
\n

string

\n

Search query with event platform syntax.

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

sort

\n
\n

string

\n

Sort order (prefixed with - for descending).

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

to

\n
\n

date-time

\n

Maximum timestamp for requested events.

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

type

\n
\n

enum

\n

The definition of DORAListFailuresRequestDataType object. \nAllowed enum values: dora_failures_list_request

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

\n

The JSON:API data.

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

attributes [required]

\n
\n

object

\n

Attributes to get a list of failures.

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

from

\n
\n

date-time

\n

Minimum timestamp for requested events.

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

limit

\n
\n

int32

\n

Maximum number of events in the response.

default: 10

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

query

\n
\n

string

\n

Search query with event platform syntax.

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

sort

\n
\n

string

\n

Sort order (prefixed with - for descending).

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

to

\n
\n

date-time

\n

Maximum timestamp for requested events.

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

type

\n
\n

enum

\n

The definition of DORAListFailuresRequestDataType object. \nAllowed enum values: dora_failures_list_request

default: dora_failures_list_request

\n
\n \n
\n
\n
\n
" } }, "GetDORAFailure": { @@ -543,12 +556,31 @@ "200": { "json": { "data": { - "attributes": {}, + "attributes": { + "custom_tags": [ + "language:java", + "department:engineering" + ], + "env": "production", + "finished_at": 1693491984000000000, + "git": { + "commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", + "repository_url": "https://github.com/organization/example-repository" + }, + "name": "Database outage", + "services": [ + "shopist" + ], + "severity": "SEV-1", + "started_at": 1693491974000000000, + "team": "backend", + "version": "v1.12.07" + }, "id": "string", - "type": "string" + "type": "dora_failure" } }, - "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

A DORA event.

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

attributes

\n
\n

object

\n

The attributes of the event.

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

id

\n
\n

string

\n

The ID of the event.

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

type

\n
\n

string

\n

The type of the event.

\n
\n \n
\n
\n
\n
" + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

A DORA incident event.

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

attributes

\n
\n

object

\n

The attributes of the incident event.

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

custom_tags

\n
\n

[string]

\n

A list of user-defined tags. The tags must follow the key:value pattern. Up to 100 may be added per event.

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

env

\n
\n

string

\n

Environment name that was impacted by the incident.

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

finished_at

\n
\n

int64

\n

Unix timestamp when the incident finished.

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

git

\n
\n

object

\n

Git info for DORA Metrics events.

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

commit_sha [required]

\n
\n

string

\n

Git Commit SHA.

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

repository_url [required]

\n
\n

string

\n

Git Repository URL

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

name

\n
\n

string

\n

Incident name.

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

services

\n
\n

[string]

\n

Service names impacted by the incident.

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

severity

\n
\n

string

\n

Incident severity.

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

started_at [required]

\n
\n

int64

\n

Unix timestamp when the incident started.

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

team

\n
\n

string

\n

Name of the team owning the services impacted.

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

version

\n
\n

string

\n

Version to correlate with APM Deployment Tracking.

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

id

\n
\n

string

\n

The ID of the incident event.

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

type

\n
\n

enum

\n

JSON:API type for DORA failure events. \nAllowed enum values: dora_failure

default: dora_failure

\n
\n \n
\n
\n
\n
" }, "400": { "json": { diff --git a/content/en/api/v2/synthetics/examples.json b/content/en/api/v2/synthetics/examples.json index c8f7dab8faa..9e33693b3f0 100644 --- a/content/en/api/v2/synthetics/examples.json +++ b/content/en/api/v2/synthetics/examples.json @@ -56,5 +56,343 @@ }, "html": "
\n
\n
\n
\n

on_demand_concurrency_cap

\n
\n

double

\n

Value of the on-demand concurrency cap.

\n
\n \n
\n
" } + }, + "CreateSyntheticsSuite": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "public_id": "123-abc-456", + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Synthetics suite response data

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

attributes

\n
\n

object

\n

Object containing details about a Synthetic suite.

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

\n
\n \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
" + }, + "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": { + "message": "Notification message", + "name": "Example suite name", + "options": {}, + "tests": [ + { + "public_id": "" + } + ], + "type": "suite" + }, + "type": "suites" + } + }, + "json": { + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + }, + "type": "suites" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

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

attributes [required]

\n
\n

object

\n

Object containing details about a Synthetic suite.

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

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

type [required]

\n
\n

enum

\n

Type for the Synthetics suites responses, suites. \nAllowed enum values: suites

default: suites

\n
\n \n
\n
\n
\n
" + } + }, + "DeleteSyntheticsSuites": { + "responses": { + "200": { + "json": { + "data": [ + { + "attributes": { + "deleted_at": "string", + "public_id": "string" + }, + "id": "string", + "type": "suites" + } + ] + }, + "html": "
\n
\n
\n
\n

data

\n
\n

[object]

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

attributes

\n
\n

object

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

deleted_at

\n
\n

string

\n

Deletion timestamp of the Synthetic suite ID.

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

public_id

\n
\n

string

\n

The Synthetic suite ID deleted.

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

id

\n
\n

string

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

type

\n
\n

enum

\n

Type for the Synthetics suites responses, suites. \nAllowed enum values: suites

default: suites

\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
" + }, + "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": { + "public_ids": [ + "" + ] + } + } + }, + "json": { + "data": { + "attributes": { + "force_delete_dependencies": false, + "public_ids": [ + "" + ] + }, + "id": "string", + "type": "delete_suites_request" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

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

attributes [required]

\n
\n

object

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

force_delete_dependencies

\n
\n

boolean

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

public_ids [required]

\n
\n

[string]

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

id

\n
\n

string

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

type

\n
\n

enum

\n

default: delete_suites_request

\n
\n \n
\n
\n
\n
" + } + }, + "SearchSuites": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "suites": [ + { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "public_id": "123-abc-456", + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + } + ], + "total": "integer" + }, + "id": "string", + "type": "suites_search" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Synthetics suite search response data

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

attributes

\n
\n

object

\n

Synthetics suite search response data attributes

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

suites

\n
\n

[object]

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

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

total

\n
\n

int32

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

id

\n
\n

uuid

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

type

\n
\n

enum

\n

default: suites_search

\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
" + }, + "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": "" + } + }, + "GetSyntheticsSuite": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "public_id": "123-abc-456", + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Synthetics suite response data

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

attributes

\n
\n

object

\n

Object containing details about a Synthetic suite.

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

\n
\n \n
\n
\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": "" + } + }, + "EditSyntheticsSuite": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "public_id": "123-abc-456", + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Synthetics suite response data

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

attributes

\n
\n

object

\n

Object containing details about a Synthetic suite.

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

\n
\n \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
" + }, + "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": { + "message": "Notification message", + "name": "Example suite name", + "options": {}, + "tests": [ + { + "public_id": "" + } + ], + "type": "suite" + }, + "type": "suites" + } + }, + "json": { + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": { + "alerting_threshold": "number" + }, + "tags": [ + "env:production" + ], + "tests": [ + { + "alerting_criticality": "critical", + "public_id": "" + } + ], + "type": "suite" + }, + "type": "suites" + } + }, + "html": "
\n
\n
\n
\n

data [required]

\n
\n

object

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

attributes [required]

\n
\n

object

\n

Object containing details about a Synthetic suite.

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

message [required]

\n
\n

string

\n

Notification message associated with the suite.

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

name [required]

\n
\n

string

\n

Name of the suite.

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

options [required]

\n
\n

object

\n

Object describing the extra options for a Synthetic suite.

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

alerting_threshold

\n
\n

double

\n

Percentage of critical tests failure needed for a suite to fail.

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

public_id

\n
\n

string

\n

The public ID for the test.

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

tags

\n
\n

[string]

\n

Array of tags attached to the suite.

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

tests [required]

\n
\n

[object]

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

alerting_criticality

\n
\n

enum

\n

Alerting criticality for each the test. \nAllowed enum values: ignore,critical

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

public_id [required]

\n
\n

string

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

type [required]

\n
\n

enum

\n

Type of the Synthetic suite, suite. \nAllowed enum values: suite

default: suite

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

type [required]

\n
\n

enum

\n

Type for the Synthetics suites responses, suites. \nAllowed enum values: suites

default: suites

\n
\n \n
\n
\n
\n
" + } } } \ No newline at end of file diff --git a/content/en/api/v2/synthetics/request.CreateSyntheticsSuite.json b/content/en/api/v2/synthetics/request.CreateSyntheticsSuite.json new file mode 100644 index 00000000000..db4478b82f9 --- /dev/null +++ b/content/en/api/v2/synthetics/request.CreateSyntheticsSuite.json @@ -0,0 +1,15 @@ +{ + "data": { + "attributes": { + "message": "Notification message", + "name": "Example suite name", + "options": {}, + "tags": [ + "env:production" + ], + "tests": [], + "type": "suite" + }, + "type": "suites" + } +} \ No newline at end of file diff --git a/data/api/v2/CodeExamples.json b/data/api/v2/CodeExamples.json index f4ce3cde6f8..3efd7aa2b08 100644 --- a/data/api/v2/CodeExamples.json +++ b/data/api/v2/CodeExamples.json @@ -1896,6 +1896,13 @@ "description": "Save new value for on-demand concurrency cap returns \"OK\" response" } ], + "CreateSyntheticsSuite": [ + { + "group": "synthetics", + "suffix": "", + "description": "Synthetics: Create a test suite returns \"OK\" response" + } + ], "AddTeamHierarchyLink": [ { "group": "teams", diff --git a/data/api/v2/full_spec.yaml b/data/api/v2/full_spec.yaml index 464fe2ee66a..5a2084891c7 100644 --- a/data/api/v2/full_spec.yaml +++ b/data/api/v2/full_spec.yaml @@ -15785,6 +15785,78 @@ components: type: string nullable: true type: array + DORADeploymentFetchResponse: + description: Response for fetching a single deployment event. + properties: + data: + $ref: '#/components/schemas/DORADeploymentObject' + type: object + DORADeploymentObject: + description: A DORA deployment event. + example: + attributes: + custom_tags: + - language:java + - department:engineering + - region:us-east-1 + env: production + finished_at: 1693491984000000000 + git: + commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 + repository_url: https://github.com/organization/example-repository + service: shopist + started_at: 1693491974000000000 + team: backend + version: v1.12.07 + id: 4242fcdd31586083 + type: dora_deployment + properties: + attributes: + $ref: '#/components/schemas/DORADeploymentObjectAttributes' + id: + description: The ID of the deployment event. + type: string + type: + $ref: '#/components/schemas/DORADeploymentType' + type: object + DORADeploymentObjectAttributes: + description: The attributes of the deployment event. + properties: + custom_tags: + $ref: '#/components/schemas/DORACustomTags' + env: + description: Environment name to where the service was deployed. + example: production + type: string + finished_at: + description: Unix timestamp when the deployment finished. + example: 1693491984000000000 + format: int64 + type: integer + git: + $ref: '#/components/schemas/DORAGitInfo' + service: + description: Service name. + example: shopist + type: string + started_at: + description: Unix timestamp when the deployment started. + example: 1693491974000000000 + format: int64 + type: integer + team: + description: Name of the team owning the deployed service. + example: backend + type: string + version: + description: Version to correlate with APM Deployment Tracking. + example: v1.12.07 + type: string + required: + - service + - started_at + - finished_at + type: object DORADeploymentRequest: description: Request to create a DORA deployment event. properties: @@ -15875,18 +15947,53 @@ components: type: string x-enum-varnames: - DORA_DEPLOYMENT - DORAEvent: - description: A DORA event. + DORADeploymentsListResponse: + description: Response for the list deployments endpoint. + example: + data: + - attributes: + custom_tags: + - language:java + - department:engineering + - region:us-east-1 + env: production + finished_at: 1693491984000000000 + git: + commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 + repository_url: https://github.com/organization/example-repository + service: shopist + started_at: 1693491974000000000 + team: backend + version: v1.12.07 + id: 4242fcdd31586083 + type: dora_deployment + - attributes: + custom_tags: + - language:go + - department:platform + env: production + finished_at: 1693492084000000000 + git: + commit_sha: 77bdc9350f2cc9b250b69abddab733dd55e1a599 + repository_url: https://github.com/organization/api-service + service: api-service + started_at: 1693492074000000000 + team: backend + version: v2.1.0 + id: 4242fcdd31586084 + type: dora_deployment properties: - attributes: - description: The attributes of the event. - type: object - id: - description: The ID of the event. - type: string - type: - description: The type of the event. - type: string + data: + description: The list of DORA deployment events. + items: + $ref: '#/components/schemas/DORADeploymentObject' + type: array + type: object + DORAFailureFetchResponse: + description: Response for fetching a single failure event. + properties: + data: + $ref: '#/components/schemas/DORAIncidentObject' type: object DORAFailureRequest: description: Request to create a DORA failure event. @@ -15990,11 +16097,45 @@ components: type: string x-enum-varnames: - DORA_FAILURE - DORAFetchResponse: - description: Response for the DORA fetch endpoints. + DORAFailuresListResponse: + description: Response for the list failures endpoint. + example: + data: + - attributes: + custom_tags: + - incident_type:database + - department:engineering + env: production + finished_at: 1693492274000000000 + name: Database outage + services: + - shopist + severity: SEV-1 + started_at: 1693492174000000000 + team: backend + id: 4242fcdd31586085 + type: dora_incident + - attributes: + custom_tags: + - incident_type:service_down + - department:platform + env: production + finished_at: 1693492474000000000 + name: API service outage + services: + - api-service + - payment-service + severity: SEV-2 + started_at: 1693492374000000000 + team: backend + id: 4242fcdd31586086 + type: dora_incident properties: data: - $ref: '#/components/schemas/DORAEvent' + description: The list of DORA incident events. + items: + $ref: '#/components/schemas/DORAIncidentObject' + type: array type: object DORAGitInfo: description: Git info for DORA Metrics events. @@ -16007,6 +16148,82 @@ components: - repository_url - commit_sha type: object + DORAIncidentObject: + description: A DORA incident event. + example: + attributes: + custom_tags: + - incident_type:database + - department:engineering + env: production + finished_at: 1693492274000000000 + git: + commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 + repository_url: https://github.com/organization/example-repository + name: Database outage + services: + - shopist + severity: SEV-1 + started_at: 1693492174000000000 + team: backend + id: 4242fcdd31586085 + type: dora_incident + properties: + attributes: + $ref: '#/components/schemas/DORAIncidentObjectAttributes' + id: + description: The ID of the incident event. + type: string + type: + $ref: '#/components/schemas/DORAFailureType' + type: object + DORAIncidentObjectAttributes: + description: The attributes of the incident event. + properties: + custom_tags: + $ref: '#/components/schemas/DORACustomTags' + env: + description: Environment name that was impacted by the incident. + example: production + type: string + finished_at: + description: Unix timestamp when the incident finished. + example: 1693491984000000000 + format: int64 + type: integer + git: + $ref: '#/components/schemas/DORAGitInfo' + name: + description: Incident name. + example: Database outage + type: string + services: + description: Service names impacted by the incident. + example: + - shopist + items: + type: string + type: array + severity: + description: Incident severity. + example: SEV-1 + type: string + started_at: + description: Unix timestamp when the incident started. + example: 1693491974000000000 + format: int64 + type: integer + team: + description: Name of the team owning the services impacted. + example: backend + type: string + version: + description: Version to correlate with APM Deployment Tracking. + example: v1.12.07 + type: string + required: + - started_at + type: object DORAListDeploymentsRequest: description: Request to get a list of deployments. example: @@ -16026,32 +16243,31 @@ components: type: object DORAListDeploymentsRequestAttributes: description: Attributes to get a list of deployments. - example: - from: '2025-01-01T00:00:00Z' - limit: 500 - query: service:(shopist OR api-service OR payment-service) env:(production - OR staging) team:(backend OR platform) - sort: -started_at - to: '2025-01-31T23:59:59Z' properties: from: description: Minimum timestamp for requested events. + example: '2025-01-01T00:00:00Z' format: date-time type: string limit: default: 10 description: Maximum number of events in the response. + example: 500 format: int32 maximum: 1000 type: integer query: description: Search query with event platform syntax. + example: service:(shopist OR api-service OR payment-service) env:(production + OR staging) team:(backend OR platform) type: string sort: description: Sort order (prefixed with `-` for descending). + example: -started_at type: string to: description: Maximum timestamp for requested events. + example: '2025-01-31T23:59:59Z' format: date-time type: string type: object @@ -16074,9 +16290,11 @@ components: - attributes type: object DORAListDeploymentsRequestDataType: + default: dora_deployments_list_request description: The definition of `DORAListDeploymentsRequestDataType` object. enum: - dora_deployments_list_request + example: dora_deployments_list_request type: string x-enum-varnames: - DORA_DEPLOYMENTS_LIST_REQUEST @@ -16099,32 +16317,31 @@ components: type: object DORAListFailuresRequestAttributes: description: Attributes to get a list of failures. - example: - from: '2025-01-01T00:00:00Z' - limit: 500 - query: severity:(SEV-1 OR SEV-2) env:(production OR staging) service:(shopist - OR api-service OR payment-service) team:(backend OR platform OR payments) - sort: -started_at - to: '2025-01-31T23:59:59Z' properties: from: description: Minimum timestamp for requested events. + example: '2025-01-01T00:00:00Z' format: date-time type: string limit: default: 10 description: Maximum number of events in the response. + example: 500 format: int32 maximum: 1000 type: integer query: description: Search query with event platform syntax. + example: severity:(SEV-1 OR SEV-2) env:(production OR staging) service:(shopist + OR api-service OR payment-service) team:(backend OR platform OR payments) type: string sort: description: Sort order (prefixed with `-` for descending). + example: -started_at type: string to: description: Maximum timestamp for requested events. + example: '2025-01-31T23:59:59Z' format: date-time type: string type: object @@ -16147,54 +16364,14 @@ components: - attributes type: object DORAListFailuresRequestDataType: + default: dora_failures_list_request description: The definition of `DORAListFailuresRequestDataType` object. enum: - dora_failures_list_request + example: dora_failures_list_request type: string x-enum-varnames: - DORA_FAILURES_LIST_REQUEST - DORAListResponse: - description: Response for the DORA list endpoints. - example: - data: - - attributes: - custom_tags: - - language:java - - department:engineering - - region:us-east-1 - env: production - finished_at: 1693491984000000000 - git: - commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 - repository_url: https://github.com/organization/example-repository - service: shopist - started_at: 1693491974000000000 - team: backend - version: v1.12.07 - id: 4242fcdd31586083 - type: dora_deployment - - attributes: - custom_tags: - - language:go - - department:platform - env: production - finished_at: 1693492084000000000 - git: - commit_sha: 77bdc9350f2cc9b250b69abddab733dd55e1a599 - repository_url: https://github.com/organization/api-service - service: api-service - started_at: 1693492074000000000 - team: backend - version: v2.1.0 - id: 4242fcdd31586084 - type: dora_deployment - properties: - data: - description: The list of DORA events. - items: - $ref: '#/components/schemas/DORAEvent' - type: array - type: object DashboardListAddItemsRequest: description: Request containing a list of dashboards to add. properties: @@ -17049,6 +17226,70 @@ components: required: - data type: object + DeletedSuiteResponseData: + properties: + attributes: + $ref: '#/components/schemas/DeletedSuiteResponseDataAttributes' + id: + type: string + type: + $ref: '#/components/schemas/SyntheticsSuiteTypes' + type: object + DeletedSuiteResponseDataAttributes: + properties: + deleted_at: + description: Deletion timestamp of the Synthetic suite ID. + type: string + public_id: + description: The Synthetic suite ID deleted. + type: string + type: object + DeletedSuitesRequestDelete: + properties: + attributes: + $ref: '#/components/schemas/DeletedSuitesRequestDeleteAttributes' + id: + type: string + type: + $ref: '#/components/schemas/DeletedSuitesRequestType' + required: + - attributes + type: object + DeletedSuitesRequestDeleteAttributes: + properties: + force_delete_dependencies: + type: boolean + public_ids: + example: + - '' + items: + type: string + type: array + required: + - public_ids + type: object + DeletedSuitesRequestDeleteRequest: + properties: + data: + $ref: '#/components/schemas/DeletedSuitesRequestDelete' + required: + - data + type: object + DeletedSuitesRequestType: + default: delete_suites_request + enum: + - delete_suites_request + example: delete_suites_request + type: string + x-enum-varnames: + - DELETE_SUITES_REQUEST + DeletedSuitesResponse: + properties: + data: + items: + $ref: '#/components/schemas/DeletedSuiteResponseData' + type: array + type: object DependencyLocation: description: Static library vulnerability location. properties: @@ -53622,6 +53863,31 @@ components: format: double type: number type: object + SuiteCreateEdit: + properties: + attributes: + $ref: '#/components/schemas/SyntheticsSuite' + type: + $ref: '#/components/schemas/SyntheticsSuiteTypes' + required: + - attributes + - type + type: object + SuiteCreateEditRequest: + properties: + data: + $ref: '#/components/schemas/SuiteCreateEdit' + required: + - data + type: object + SuiteSearchResponseType: + default: suites_search + enum: + - suites_search + example: suites_search + type: string + x-enum-varnames: + - SUITES_SEARCH SuppressionVersionHistory: description: Response object containing the version history of a suppression. properties: @@ -53648,6 +53914,137 @@ components: suppression: $ref: '#/components/schemas/SecurityMonitoringSuppressionAttributes' type: object + SyntheticsSuite: + description: Object containing details about a Synthetic suite. + properties: + message: + description: Notification message associated with the suite. + example: Notification message + type: string + name: + description: Name of the suite. + example: Example suite name + type: string + options: + $ref: '#/components/schemas/SyntheticsSuiteOptions' + public_id: + description: The public ID for the test. + example: 123-abc-456 + readOnly: true + type: string + tags: + description: Array of tags attached to the suite. + example: + - env:production + items: + description: A tag attached to the suite. + type: string + type: array + tests: + items: + $ref: '#/components/schemas/SyntheticsSuiteTest' + type: array + type: + $ref: '#/components/schemas/SyntheticsSuiteType' + required: + - name + - message + - type + - tests + - options + type: object + SyntheticsSuiteOptions: + description: Object describing the extra options for a Synthetic suite. + properties: + alerting_threshold: + description: Percentage of critical tests failure needed for a suite to + fail. + format: double + maximum: 1 + minimum: 0 + type: number + type: object + SyntheticsSuiteResponse: + description: Synthetics suite response + properties: + data: + $ref: '#/components/schemas/SyntheticsSuiteResponseData' + type: object + SyntheticsSuiteResponseData: + description: Synthetics suite response data + properties: + attributes: + $ref: '#/components/schemas/SyntheticsSuite' + type: object + SyntheticsSuiteSearchResponse: + description: Synthetics suite search response + properties: + data: + $ref: '#/components/schemas/SyntheticsSuiteSearchResponseData' + type: object + SyntheticsSuiteSearchResponseData: + description: Synthetics suite search response data + properties: + attributes: + $ref: '#/components/schemas/SyntheticsSuiteSearchResponseDataAttributes' + id: + format: uuid + type: string + type: + $ref: '#/components/schemas/SuiteSearchResponseType' + type: object + SyntheticsSuiteSearchResponseDataAttributes: + description: Synthetics suite search response data attributes + properties: + suites: + items: + $ref: '#/components/schemas/SyntheticsSuite' + type: array + total: + format: int32 + maximum: 2147483647 + type: integer + type: object + SyntheticsSuiteTest: + description: Object containing details about a Synthetic test included in a + Synthetic suite. + properties: + alerting_criticality: + $ref: '#/components/schemas/SyntheticsSuiteTestAlertingCriticality' + public_id: + example: '' + type: string + required: + - public_id + type: object + SyntheticsSuiteTestAlertingCriticality: + description: Alerting criticality for each the test. + enum: + - ignore + - critical + example: critical + type: string + x-enum-varnames: + - IGNORE + - CRITICAL + SyntheticsSuiteType: + default: suite + description: Type of the Synthetic suite, `suite`. + enum: + - suite + example: suite + type: string + x-enum-varnames: + - SUITE + SyntheticsSuiteTypes: + default: suites + description: Type for the Synthetics suites responses, `suites`. + enum: + - suites + example: suites + type: string + x-enum-varnames: + - SUITES TableResultV2: description: A reference table resource containing its full configuration and state. @@ -68083,7 +68480,7 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/DORAListResponse' + $ref: '#/components/schemas/DORADeploymentsListResponse' description: OK '400': content: @@ -68122,26 +68519,8 @@ paths: '200': content: application/json: - example: - data: - attributes: - custom_tags: - - language:java - - department:engineering - - region:us-east-1 - env: staging - finished_at: 1693491984000000000 - git: - commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 - repository_url: https://github.com/organization/example-repository - service: shopist - started_at: 1693491974000000000 - team: backend - version: v1.12.07 - id: 4242fcdd31586083 - type: dora_deployment - schema: - $ref: '#/components/schemas/DORAFetchResponse' + schema: + $ref: '#/components/schemas/DORADeploymentFetchResponse' description: OK '400': content: @@ -68261,66 +68640,8 @@ paths: '200': content: application/json: - example: - data: - - attributes: - custom_tags: - - language:java - - department:engineering - - region:us-east-1 - env: production - finished_at: 1693491984000000000 - git: - commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 - repository_url: https://github.com/organization/example-repository - name: Web server is down; all requests are failing. - services: - - shopist - severity: SEV-1 - started_at: 1693491974000000000 - team: backend - id: 4242fcdd31586085 - type: dora_failure - - attributes: - custom_tags: - - language:go - - department:platform - env: production - finished_at: 1693492084000000000 - git: - commit_sha: 77bdc9350f2cc9b250b69abddab733dd55e1a599 - repository_url: https://github.com/organization/api-service - name: Database connection timeout - services: - - api-service - - payment-service - severity: SEV-1 - started_at: 1693492074000000000 - team: platform - version: v2.1.0 - id: 4242fcdd31586086 - type: dora_failure - - attributes: - custom_tags: - - language:python - - department:payments - - region:eu-west-1 - env: staging - finished_at: 1693492204000000000 - git: - commit_sha: 99edc9350f2cc9b250b69abddab733dd55e1a601 - repository_url: https://github.com/organization/payment-service - name: Payment gateway API rate limit exceeded - services: - - payment-service - severity: SEV-2 - started_at: 1693492174000000000 - team: payments - version: v1.8.3 - id: 4242fcdd31586087 - type: dora_failure - schema: - $ref: '#/components/schemas/DORAListResponse' + schema: + $ref: '#/components/schemas/DORAFailuresListResponse' description: OK '400': content: @@ -68359,28 +68680,8 @@ paths: '200': content: application/json: - example: - data: - attributes: - custom_tags: - - language:java - - department:engineering - - region:us-east-1 - env: staging - finished_at: 1693491984000000000 - git: - commit_sha: 66adc9350f2cc9b250b69abddab733dd55e1a588 - repository_url: https://github.com/organization/example-repository - name: Web server is down; all requests are failing. - services: - - shopist - severity: High - started_at: 1693491974000000000 - team: backend - id: 4242fcdd31586085 - type: dora_failure - schema: - $ref: '#/components/schemas/DORAFetchResponse' + schema: + $ref: '#/components/schemas/DORAFailureFetchResponse' description: OK '400': content: @@ -87334,6 +87635,232 @@ paths: operator: OR permissions: - billing_edit + /api/v2/synthetics/suites: + post: + operationId: CreateSyntheticsSuite + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SuiteCreateEditRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SyntheticsSuiteResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - synthetics_write + summary: 'Synthetics: Create a test suite' + tags: + - Synthetics + x-menu-order: 30 + x-permission: + operator: OR + permissions: + - synthetics_write + - synthetics_create_edit_trigger + /api/v2/synthetics/suites/bulk-delete: + post: + operationId: DeleteSyntheticsSuites + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DeletedSuitesRequestDeleteRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DeletedSuitesResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - synthetics_write + summary: 'Synthetics: Bulk delete suites' + tags: + - Synthetics + x-menu-order: 40 + x-permission: + operator: OR + permissions: + - synthetics_write + /api/v2/synthetics/suites/search: + get: + description: Search for Synthetics suites. + operationId: SearchSuites + parameters: + - description: The search query. + in: query + name: query + required: false + schema: + type: string + - description: The sort order for the results (e.g., `name,asc` or `name,desc`). + in: query + name: sort + required: false + schema: + default: name,asc + type: string + - description: If true, return only facets instead of full test details. + in: query + name: facets_only + required: false + schema: + default: false + type: boolean + - description: The offset from which to start returning results. + in: query + name: start + required: false + schema: + default: 0 + format: int64 + type: integer + - description: The maximum number of results to return. + in: query + name: count + required: false + schema: + default: 50 + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SyntheticsSuiteSearchResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - synthetics_read + summary: Search Synthetics suites + tags: + - Synthetics + x-menu-order: 20 + x-permission: + operator: OR + permissions: + - synthetics_read + /api/v2/synthetics/suites/{public_id}: + get: + operationId: GetSyntheticsSuite + parameters: + - description: The public ID of the suite to get details from. + in: path + name: public_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SyntheticsSuiteResponse' + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - synthetics_read + summary: 'Synthetics: Get a suite' + tags: + - Synthetics + x-menu-order: 25 + x-permission: + operator: OR + permissions: + - synthetics_read + put: + operationId: EditSyntheticsSuite + parameters: + - description: The public ID of the suite to edit. + in: path + name: public_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SuiteCreateEditRequest' + description: New suite details to be saved. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SyntheticsSuiteResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - synthetics_write + summary: 'Synthetics: edit a test suite' + tags: + - Synthetics + x-menu-order: 35 + x-permission: + operator: OR + permissions: + - synthetics_write /api/v2/tags/enrichment: get: description: List all tag pipeline rulesets - Retrieve a list of all tag pipeline diff --git a/data/api/v2/translate_actions.json b/data/api/v2/translate_actions.json index 222fc7b9c11..00522e91057 100644 --- a/data/api/v2/translate_actions.json +++ b/data/api/v2/translate_actions.json @@ -3179,6 +3179,28 @@ "request_description": ".", "request_schema_description": "On-demand concurrency cap attributes." }, + "CreateSyntheticsSuite": { + "summary": "Synthetics: Create a test suite", + "request_description": "", + "request_schema_description": "" + }, + "DeleteSyntheticsSuites": { + "summary": "Synthetics: Bulk delete suites", + "request_description": "", + "request_schema_description": "" + }, + "SearchSuites": { + "description": "Search for Synthetics suites.", + "summary": "Search Synthetics suites" + }, + "GetSyntheticsSuite": { + "summary": "Synthetics: Get a suite" + }, + "EditSyntheticsSuite": { + "summary": "Synthetics: edit a test suite", + "request_description": "New suite details to be saved.", + "request_schema_description": "" + }, "ListTagPipelinesRulesets": { "description": "List all tag pipeline rulesets - Retrieve a list of all tag pipeline rulesets for the organization", "summary": "List tag pipeline rulesets"