diff --git a/config/_default/menus/api.en.yaml b/config/_default/menus/api.en.yaml index ef45455ea28..5683c4b501c 100644 --- a/config/_default/menus/api.en.yaml +++ b/config/_default/menus/api.en.yaml @@ -6506,6 +6506,102 @@ menu: url: /api/latest/app-builder/ identifier: app-builder generated: true + - name: List App Versions + url: '#list-app-versions' + identifier: app-builder-list-app-versions + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - ListAppVersions + unstable: [] + order: 13 + - name: Name App Version + url: '#name-app-version' + identifier: app-builder-name-app-version + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - UpdateAppVersionName + unstable: [] + order: 14 + - name: Update App Tags + url: '#update-app-tags' + identifier: app-builder-update-app-tags + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - UpdateAppTags + unstable: [] + order: 12 + - name: Update App Self-Service Status + url: '#update-app-self-service-status' + identifier: app-builder-update-app-self-service-status + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - UpdateAppSelfService + unstable: [] + order: 11 + - name: Revert App + url: '#revert-app' + identifier: app-builder-revert-app + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - RevertApp + unstable: [] + order: 16 + - name: Create Publish Request + url: '#create-publish-request' + identifier: app-builder-create-publish-request + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - CreatePublishRequest + unstable: [] + order: 15 + - name: Update App Protection Level + url: '#update-app-protection-level' + identifier: app-builder-update-app-protection-level + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - UpdateProtectionLevel + unstable: [] + order: 10 + - name: Update App Favorite Status + url: '#update-app-favorite-status' + identifier: app-builder-update-app-favorite-status + parent: app-builder + generated: true + params: + versions: + - v2 + operationids: + - UpdateAppFavorite + unstable: [] + order: 9 - name: Publish App url: '#publish-app' identifier: app-builder-publish-app diff --git a/content/en/api/v2/app-builder/examples.json b/content/en/api/v2/app-builder/examples.json index 9af0f13a795..1bb20d7f14f 100644 --- a/content/en/api/v2/app-builder/examples.json +++ b/content/en/api/v2/app-builder/examples.json @@ -1263,5 +1263,1014 @@ "json": {}, "html": "" } + }, + "UpdateAppFavorite": { + "responses": { + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "favorite": true + } + } + }, + "json": { + "data": { + "attributes": { + "favorite": true + }, + "type": "favorites" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for updating an app's favorite status.

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

attributes

\n
\n

object

\n

Attributes for updating an app's favorite status.

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

favorite [required]

\n
\n

boolean

\n

Whether the app should be marked as a favorite for the current user.

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

type

\n
\n

enum

\n

The favorite resource type. \nAllowed enum values: favorites

default: favorites

\n
\n \n
\n
\n
\n
" + } + }, + "UpdateProtectionLevel": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "components": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "string", + "name": "", + "properties": { + "backgroundColor": "string", + "children": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "string", + "name": "", + "properties": { + "children": [], + "isVisible": { + "type": "undefined" + } + }, + "type": "text" + } + ], + "isVisible": { + "type": "undefined" + } + }, + "type": "grid" + } + ], + "description": "string", + "favorite": false, + "name": "string", + "queries": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "name": "fetchPendingOrders", + "properties": { + "condition": { + "type": "undefined" + }, + "debounceInMs": { + "example": "undefined", + "format": "undefined", + "type": "undefined" + }, + "mockedOutputs": { + "type": "undefined" + }, + "onlyTriggerManually": { + "type": "undefined" + }, + "outputs": "${((outputs) => {return outputs.body.data})(self.rawOutputs)}", + "pollingIntervalInMs": { + "example": "undefined", + "format": "undefined", + "minimum": "undefined", + "type": "undefined" + }, + "requiresConfirmation": { + "type": "undefined" + }, + "showToastOnError": { + "type": "undefined" + }, + "spec": { + "type": "" + } + }, + "type": "action" + } + ], + "rootInstanceName": "string", + "tags": [ + "service:webshop-backend", + "team:webshop" + ] + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "appDefinitions" + }, + "included": [ + { + "attributes": { + "app_version_id": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "type": "deployment" + } + ], + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "deleted_at": "2019-09-19T10:00:00.000Z", + "org_id": "integer", + "updated_at": "2019-09-19T10:00:00.000Z", + "updated_since_deployment": false, + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "version": "integer" + }, + "relationship": { + "connections": [ + { + "attributes": { + "name": "string", + "onPremRunner": { + "id": "string", + "url": "string" + } + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "custom_connections" + } + ], + "deployment": { + "data": { + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "deployment" + }, + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + } + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The data object containing the updated app definition.

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

attributes [required]

\n
\n

object

\n

The updated app definition attributes, such as name, description, and components.

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

components

\n
\n

[object]

\n

The UI components that make up the app.

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

events

\n
\n

[object]

\n

Events to listen for on the grid component.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id

\n
\n

string

\n

The ID of the grid component. This property is deprecated; use name to identify individual components instead.

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

name [required]

\n
\n

string

\n

A unique identifier for this grid component. This name is also visible in the app editor.

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

properties [required]

\n
\n

object

\n

Properties of a grid component.

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

backgroundColor

\n
\n

string

\n

The background color of the grid.

default: default

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

children

\n
\n

[object]

\n

The child components of the grid.

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

events

\n
\n

[object]

\n

Events to listen for on the UI component.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id

\n
\n

string

\n

The ID of the UI component. This property is deprecated; use name to identify individual components instead.

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

name [required]

\n
\n

string

\n

A unique identifier for this UI component. This name is also visible in the app editor.

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

properties [required]

\n
\n

object

\n

Properties of a UI component. Different component types can have their own additional unique properties. See the components documentation for more detail on each component type and its properties.

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

children

\n
\n

[object]

\n

The child components of the UI component.

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

isVisible

\n
\n

 <oneOf>

\n

Whether the UI component is visible. If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

type [required]

\n
\n

enum

\n

The UI component type. \nAllowed enum values: table,textInput,textArea,button,text,select,modal,schemaForm,checkbox,tabs

Show 10 more,vegaChart,radioButtons,numberInput,fileInput,jsonInput,gridCell,dateRangePicker,search,container,calloutValue

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

isVisible

\n
\n

 <oneOf>

\n

Whether the grid component and its children are visible. If a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

boolean

\n

default: true

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

type [required]

\n
\n

enum

\n

The grid component type. \nAllowed enum values: grid

default: grid

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

description

\n
\n

string

\n

The human-readable description for the app.

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

favorite

\n
\n

boolean

\n

Whether the app is marked as a favorite by the current user.

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

name

\n
\n

string

\n

The name of the app.

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

queries

\n
\n

[ <oneOf>]

\n

An array of queries, such as external actions and state variables, that the app uses.

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

Option 1

\n
\n

object

\n

An action query. This query type is used to trigger an action, such as sending a HTTP request.

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

events

\n
\n

[object]

\n

Events to listen for downstream of the action query.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id [required]

\n
\n

uuid

\n

The ID of the action query.

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

name [required]

\n
\n

string

\n

A unique identifier for this action query. This name is also used to access the query's result throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the action query.

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

condition

\n
\n

 <oneOf>

\n

Whether to run this query. If specified, the query will only run if this condition evaluates to true in JavaScript and all other conditions are also met.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

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

debounceInMs

\n
\n

 <oneOf>

\n

The minimum time in milliseconds that must pass before the query can be triggered again. This is useful for preventing accidental double-clicks from triggering the query multiple times.

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

Option 1

\n
\n

double

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a number.

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

mockedOutputs

\n
\n

 <oneOf>

\n

The mocked outputs of the action query. This is useful for testing the app without actually running the action.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The mocked outputs of the action query.

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

enabled [required]

\n
\n

 <oneOf>

\n

Whether to enable the mocked outputs for testing.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

outputs

\n
\n

string

\n

The mocked outputs of the action query, serialized as JSON.

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

onlyTriggerManually

\n
\n

 <oneOf>

\n

Determines when this query is executed. If set to false, the query will run when the app loads and whenever any query arguments change. If set to true, the query will only run when manually triggered from elsewhere in the app.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

outputs

\n
\n

string

\n

The post-query transformation function, which is a JavaScript function that changes the query's .outputs property after the query's execution.

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

pollingIntervalInMs

\n
\n

 <oneOf>

\n

If specified, the app will poll the query at the specified interval in milliseconds. The minimum polling interval is 15 seconds. The query will only poll when the app's browser tab is active.

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

Option 1

\n
\n

double

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a number.

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

requiresConfirmation

\n
\n

 <oneOf>

\n

Whether to prompt the user to confirm this query before it runs.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

showToastOnError

\n
\n

 <oneOf>

\n

Whether to display a toast to the user when the query returns an error.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

spec [required]

\n
\n

 <oneOf>

\n

The definition of the action query.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The action query spec object.

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

connectionGroup

\n
\n

object

\n

The connection group to use for an action query.

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

id

\n
\n

uuid

\n

The ID of the connection group.

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

tags

\n
\n

[string]

\n

The tags of the connection group.

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

connectionId

\n
\n

string

\n

The ID of the custom connection to use for this action query.

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

fqn [required]

\n
\n

string

\n

The fully qualified name of the action type.

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

inputs

\n
\n

 <oneOf>

\n

The inputs to the action query. These are the values that are passed to the action when it is triggered.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The inputs to the action query. See the Actions Catalog for more detail on each action and its inputs.

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

type [required]

\n
\n

enum

\n

The action query type. \nAllowed enum values: action

default: action

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

Option 2

\n
\n

object

\n

A data transformer, which is custom JavaScript code that executes and transforms data when its inputs change.

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

id [required]

\n
\n

uuid

\n

The ID of the data transformer.

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

name [required]

\n
\n

string

\n

A unique identifier for this data transformer. This name is also used to access the transformer's result throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the data transformer.

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

outputs

\n
\n

string

\n

A JavaScript function that returns the transformed data.

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

type [required]

\n
\n

enum

\n

The data transform type. \nAllowed enum values: dataTransform

default: dataTransform

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

Option 3

\n
\n

object

\n

A variable, which can be set and read by other components in the app.

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

id [required]

\n
\n

uuid

\n

The ID of the state variable.

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

name [required]

\n
\n

string

\n

A unique identifier for this state variable. This name is also used to access the variable's value throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the state variable.

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

defaultValue

\n
\n

\n

The default value of the state variable.

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

type [required]

\n
\n

enum

\n

The state variable type. \nAllowed enum values: stateVariable

default: stateVariable

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

rootInstanceName

\n
\n

string

\n

The name of the root component of the app. This must be a grid component that contains all other components.

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

tags

\n
\n

[string]

\n

A list of tags for the app, which can be used to filter apps.

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

id [required]

\n
\n

uuid

\n

The ID of the updated app.

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

type [required]

\n
\n

enum

\n

The app definition type. \nAllowed enum values: appDefinitions

default: appDefinitions

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

included

\n
\n

[object]

\n

Data on the version of the app that was published.

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

attributes

\n
\n

object

\n

The attributes object containing the version ID of the published app.

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

app_version_id

\n
\n

uuid

\n

The version ID of the app that was published. For an unpublished app, this is always the nil UUID (00000000-0000-0000-0000-000000000000).

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

id

\n
\n

uuid

\n

The deployment ID.

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

meta

\n
\n

object

\n

Metadata object containing the publication creation information.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was published.

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

user_id

\n
\n

int64

\n

The ID of the user who published the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who published the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who published the app.

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

type

\n
\n

enum

\n

The deployment type. \nAllowed enum values: deployment

default: deployment

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

meta

\n
\n

object

\n

Metadata of an app.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was created.

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

deleted_at

\n
\n

date-time

\n

Timestamp of when the app was deleted.

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

org_id

\n
\n

int64

\n

The Datadog organization ID that owns the app.

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

updated_at

\n
\n

date-time

\n

Timestamp of when the app was last updated.

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

updated_since_deployment

\n
\n

boolean

\n

Whether the app was updated since it was last published. Published apps are pinned to a specific version and do not automatically update when the app is updated.

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

user_id

\n
\n

int64

\n

The ID of the user who created the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who created the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who created the app.

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

version

\n
\n

int64

\n

The version number of the app. This starts at 1 and increments with each update.

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

relationship

\n
\n

object

\n

The app's publication relationship and custom connections.

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

connections

\n
\n

[object]

\n

Array of custom connections used by the app.

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

attributes

\n
\n

object

\n

The custom connection attributes.

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

name

\n
\n

string

\n

The name of the custom connection.

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

onPremRunner

\n
\n

object

\n

Information about the Private Action Runner used by the custom connection, if the custom connection is associated with a Private Action Runner.

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

id

\n
\n

string

\n

The Private Action Runner ID.

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

url

\n
\n

string

\n

The URL of the Private Action Runner.

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

id

\n
\n

uuid

\n

The ID of the custom connection.

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

type

\n
\n

enum

\n

The custom connection type. \nAllowed enum values: custom_connections

default: custom_connections

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

deployment

\n
\n

object

\n

Information pointing to the app's publication status.

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

data

\n
\n

object

\n

Data object containing the deployment ID.

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

id

\n
\n

uuid

\n

The deployment ID.

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

type

\n
\n

enum

\n

The deployment type. \nAllowed enum values: deployment

default: deployment

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

meta

\n
\n

object

\n

Metadata object containing the publication creation information.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was published.

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

user_id

\n
\n

int64

\n

The ID of the user who published the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who published the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who published the app.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "protectionLevel": "direct_publish" + } + } + }, + "json": { + "data": { + "attributes": { + "protectionLevel": "direct_publish" + }, + "type": "protectionLevel" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for updating an app's publication protection level.

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

attributes

\n
\n

object

\n

Attributes for updating an app's publication protection level.

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

protectionLevel [required]

\n
\n

enum

\n

The publication protection level of the app. approval_required means changes must go through an approval workflow before being published. \nAllowed enum values: direct_publish,approval_required

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

type

\n
\n

enum

\n

The protection-level resource type. \nAllowed enum values: protectionLevel

default: protectionLevel

\n
\n \n
\n
\n
\n
" + } + }, + "CreatePublishRequest": { + "responses": { + "201": { + "json": { + "data": { + "attributes": { + "app_version_id": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "type": "deployment" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The version of the app that was published.

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

attributes

\n
\n

object

\n

The attributes object containing the version ID of the published app.

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

app_version_id

\n
\n

uuid

\n

The version ID of the app that was published. For an unpublished app, this is always the nil UUID (00000000-0000-0000-0000-000000000000).

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

id

\n
\n

uuid

\n

The deployment ID.

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

meta

\n
\n

object

\n

Metadata object containing the publication creation information.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was published.

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

user_id

\n
\n

int64

\n

The ID of the user who published the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who published the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who published the app.

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

type

\n
\n

enum

\n

The deployment type. \nAllowed enum values: deployment

default: deployment

\n
\n \n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "title": "Release v1.2 to production" + } + } + }, + "json": { + "data": { + "attributes": { + "description": "Adds new dashboard widgets and a few bug fixes.", + "title": "Release v1.2 to production" + }, + "type": "publishRequest" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for creating a publish request.

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

attributes

\n
\n

object

\n

Attributes for creating a publish request.

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

description

\n
\n

string

\n

An optional description of the changes in this publish request.

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

title [required]

\n
\n

string

\n

A short title for the publish request.

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

type

\n
\n

enum

\n

The publish-request resource type. \nAllowed enum values: publishRequest

default: publishRequest

\n
\n \n
\n
\n
\n
" + } + }, + "RevertApp": { + "responses": { + "200": { + "json": { + "data": { + "attributes": { + "components": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "string", + "name": "", + "properties": { + "backgroundColor": "string", + "children": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "string", + "name": "", + "properties": { + "children": [], + "isVisible": { + "type": "undefined" + } + }, + "type": "text" + } + ], + "isVisible": { + "type": "undefined" + } + }, + "type": "grid" + } + ], + "description": "string", + "favorite": false, + "name": "string", + "queries": [ + { + "events": [ + { + "name": "click", + "type": "triggerQuery" + } + ], + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "name": "fetchPendingOrders", + "properties": { + "condition": { + "type": "undefined" + }, + "debounceInMs": { + "example": "undefined", + "format": "undefined", + "type": "undefined" + }, + "mockedOutputs": { + "type": "undefined" + }, + "onlyTriggerManually": { + "type": "undefined" + }, + "outputs": "${((outputs) => {return outputs.body.data})(self.rawOutputs)}", + "pollingIntervalInMs": { + "example": "undefined", + "format": "undefined", + "minimum": "undefined", + "type": "undefined" + }, + "requiresConfirmation": { + "type": "undefined" + }, + "showToastOnError": { + "type": "undefined" + }, + "spec": { + "type": "" + } + }, + "type": "action" + } + ], + "rootInstanceName": "string", + "tags": [ + "service:webshop-backend", + "team:webshop" + ] + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "appDefinitions" + }, + "included": [ + { + "attributes": { + "app_version_id": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + }, + "type": "deployment" + } + ], + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "deleted_at": "2019-09-19T10:00:00.000Z", + "org_id": "integer", + "updated_at": "2019-09-19T10:00:00.000Z", + "updated_since_deployment": false, + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "version": "integer" + }, + "relationship": { + "connections": [ + { + "attributes": { + "name": "string", + "onPremRunner": { + "id": "string", + "url": "string" + } + }, + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "custom_connections" + } + ], + "deployment": { + "data": { + "id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "type": "deployment" + }, + "meta": { + "created_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "string", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693" + } + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

The data object containing the updated app definition.

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

attributes [required]

\n
\n

object

\n

The updated app definition attributes, such as name, description, and components.

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

components

\n
\n

[object]

\n

The UI components that make up the app.

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

events

\n
\n

[object]

\n

Events to listen for on the grid component.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id

\n
\n

string

\n

The ID of the grid component. This property is deprecated; use name to identify individual components instead.

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

name [required]

\n
\n

string

\n

A unique identifier for this grid component. This name is also visible in the app editor.

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

properties [required]

\n
\n

object

\n

Properties of a grid component.

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

backgroundColor

\n
\n

string

\n

The background color of the grid.

default: default

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

children

\n
\n

[object]

\n

The child components of the grid.

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

events

\n
\n

[object]

\n

Events to listen for on the UI component.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id

\n
\n

string

\n

The ID of the UI component. This property is deprecated; use name to identify individual components instead.

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

name [required]

\n
\n

string

\n

A unique identifier for this UI component. This name is also visible in the app editor.

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

properties [required]

\n
\n

object

\n

Properties of a UI component. Different component types can have their own additional unique properties. See the components documentation for more detail on each component type and its properties.

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

children

\n
\n

[object]

\n

The child components of the UI component.

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

isVisible

\n
\n

 <oneOf>

\n

Whether the UI component is visible. If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

type [required]

\n
\n

enum

\n

The UI component type. \nAllowed enum values: table,textInput,textArea,button,text,select,modal,schemaForm,checkbox,tabs

Show 10 more,vegaChart,radioButtons,numberInput,fileInput,jsonInput,gridCell,dateRangePicker,search,container,calloutValue

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

isVisible

\n
\n

 <oneOf>

\n

Whether the grid component and its children are visible. If a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

boolean

\n

default: true

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

type [required]

\n
\n

enum

\n

The grid component type. \nAllowed enum values: grid

default: grid

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

description

\n
\n

string

\n

The human-readable description for the app.

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

favorite

\n
\n

boolean

\n

Whether the app is marked as a favorite by the current user.

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

name

\n
\n

string

\n

The name of the app.

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

queries

\n
\n

[ <oneOf>]

\n

An array of queries, such as external actions and state variables, that the app uses.

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

Option 1

\n
\n

object

\n

An action query. This query type is used to trigger an action, such as sending a HTTP request.

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

events

\n
\n

[object]

\n

Events to listen for downstream of the action query.

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

name

\n
\n

enum

\n

The triggering action for the event. \nAllowed enum values: pageChange,tableRowClick,_tableRowButtonClick,change,submit,click,toggleOpen,close,open,executionFinished

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

type

\n
\n

enum

\n

The response to the event. \nAllowed enum values: custom,setComponentState,triggerQuery,openModal,closeModal,openUrl,downloadFile,setStateVariableValue

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

id [required]

\n
\n

uuid

\n

The ID of the action query.

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

name [required]

\n
\n

string

\n

A unique identifier for this action query. This name is also used to access the query's result throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the action query.

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

condition

\n
\n

 <oneOf>

\n

Whether to run this query. If specified, the query will only run if this condition evaluates to true in JavaScript and all other conditions are also met.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

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

debounceInMs

\n
\n

 <oneOf>

\n

The minimum time in milliseconds that must pass before the query can be triggered again. This is useful for preventing accidental double-clicks from triggering the query multiple times.

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

Option 1

\n
\n

double

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a number.

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

mockedOutputs

\n
\n

 <oneOf>

\n

The mocked outputs of the action query. This is useful for testing the app without actually running the action.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The mocked outputs of the action query.

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

enabled [required]

\n
\n

 <oneOf>

\n

Whether to enable the mocked outputs for testing.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

outputs

\n
\n

string

\n

The mocked outputs of the action query, serialized as JSON.

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

onlyTriggerManually

\n
\n

 <oneOf>

\n

Determines when this query is executed. If set to false, the query will run when the app loads and whenever any query arguments change. If set to true, the query will only run when manually triggered from elsewhere in the app.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

outputs

\n
\n

string

\n

The post-query transformation function, which is a JavaScript function that changes the query's .outputs property after the query's execution.

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

pollingIntervalInMs

\n
\n

 <oneOf>

\n

If specified, the app will poll the query at the specified interval in milliseconds. The minimum polling interval is 15 seconds. The query will only poll when the app's browser tab is active.

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

Option 1

\n
\n

double

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a number.

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

requiresConfirmation

\n
\n

 <oneOf>

\n

Whether to prompt the user to confirm this query before it runs.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

showToastOnError

\n
\n

 <oneOf>

\n

Whether to display a toast to the user when the query returns an error.

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

Option 1

\n
\n

boolean

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

Option 2

\n
\n

string

\n

If this is a string, it must be a valid JavaScript expression that evaluates to a boolean.

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

spec [required]

\n
\n

 <oneOf>

\n

The definition of the action query.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The action query spec object.

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

connectionGroup

\n
\n

object

\n

The connection group to use for an action query.

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

id

\n
\n

uuid

\n

The ID of the connection group.

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

tags

\n
\n

[string]

\n

The tags of the connection group.

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

connectionId

\n
\n

string

\n

The ID of the custom connection to use for this action query.

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

fqn [required]

\n
\n

string

\n

The fully qualified name of the action type.

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

inputs

\n
\n

 <oneOf>

\n

The inputs to the action query. These are the values that are passed to the action when it is triggered.

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

Option 1

\n
\n

string

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

Option 2

\n
\n

object

\n

The inputs to the action query. See the Actions Catalog for more detail on each action and its inputs.

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

type [required]

\n
\n

enum

\n

The action query type. \nAllowed enum values: action

default: action

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

Option 2

\n
\n

object

\n

A data transformer, which is custom JavaScript code that executes and transforms data when its inputs change.

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

id [required]

\n
\n

uuid

\n

The ID of the data transformer.

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

name [required]

\n
\n

string

\n

A unique identifier for this data transformer. This name is also used to access the transformer's result throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the data transformer.

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

outputs

\n
\n

string

\n

A JavaScript function that returns the transformed data.

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

type [required]

\n
\n

enum

\n

The data transform type. \nAllowed enum values: dataTransform

default: dataTransform

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

Option 3

\n
\n

object

\n

A variable, which can be set and read by other components in the app.

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

id [required]

\n
\n

uuid

\n

The ID of the state variable.

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

name [required]

\n
\n

string

\n

A unique identifier for this state variable. This name is also used to access the variable's value throughout the app.

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

properties [required]

\n
\n

object

\n

The properties of the state variable.

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

defaultValue

\n
\n

\n

The default value of the state variable.

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

type [required]

\n
\n

enum

\n

The state variable type. \nAllowed enum values: stateVariable

default: stateVariable

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

rootInstanceName

\n
\n

string

\n

The name of the root component of the app. This must be a grid component that contains all other components.

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

tags

\n
\n

[string]

\n

A list of tags for the app, which can be used to filter apps.

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

id [required]

\n
\n

uuid

\n

The ID of the updated app.

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

type [required]

\n
\n

enum

\n

The app definition type. \nAllowed enum values: appDefinitions

default: appDefinitions

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

included

\n
\n

[object]

\n

Data on the version of the app that was published.

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

attributes

\n
\n

object

\n

The attributes object containing the version ID of the published app.

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

app_version_id

\n
\n

uuid

\n

The version ID of the app that was published. For an unpublished app, this is always the nil UUID (00000000-0000-0000-0000-000000000000).

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

id

\n
\n

uuid

\n

The deployment ID.

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

meta

\n
\n

object

\n

Metadata object containing the publication creation information.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was published.

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

user_id

\n
\n

int64

\n

The ID of the user who published the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who published the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who published the app.

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

type

\n
\n

enum

\n

The deployment type. \nAllowed enum values: deployment

default: deployment

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

meta

\n
\n

object

\n

Metadata of an app.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was created.

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

deleted_at

\n
\n

date-time

\n

Timestamp of when the app was deleted.

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

org_id

\n
\n

int64

\n

The Datadog organization ID that owns the app.

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

updated_at

\n
\n

date-time

\n

Timestamp of when the app was last updated.

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

updated_since_deployment

\n
\n

boolean

\n

Whether the app was updated since it was last published. Published apps are pinned to a specific version and do not automatically update when the app is updated.

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

user_id

\n
\n

int64

\n

The ID of the user who created the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who created the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who created the app.

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

version

\n
\n

int64

\n

The version number of the app. This starts at 1 and increments with each update.

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

relationship

\n
\n

object

\n

The app's publication relationship and custom connections.

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

connections

\n
\n

[object]

\n

Array of custom connections used by the app.

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

attributes

\n
\n

object

\n

The custom connection attributes.

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

name

\n
\n

string

\n

The name of the custom connection.

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

onPremRunner

\n
\n

object

\n

Information about the Private Action Runner used by the custom connection, if the custom connection is associated with a Private Action Runner.

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

id

\n
\n

string

\n

The Private Action Runner ID.

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

url

\n
\n

string

\n

The URL of the Private Action Runner.

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

id

\n
\n

uuid

\n

The ID of the custom connection.

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

type

\n
\n

enum

\n

The custom connection type. \nAllowed enum values: custom_connections

default: custom_connections

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

deployment

\n
\n

object

\n

Information pointing to the app's publication status.

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

data

\n
\n

object

\n

Data object containing the deployment ID.

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

id

\n
\n

uuid

\n

The deployment ID.

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

type

\n
\n

enum

\n

The deployment type. \nAllowed enum values: deployment

default: deployment

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

meta

\n
\n

object

\n

Metadata object containing the publication creation information.

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

created_at

\n
\n

date-time

\n

Timestamp of when the app was published.

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

user_id

\n
\n

int64

\n

The ID of the user who published the app.

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

user_name

\n
\n

string

\n

The name (or email address) of the user who published the app.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who published the app.

\n
\n \n
\n
\n
\n
\n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": "" + } + }, + "UpdateAppSelfService": { + "responses": { + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "selfService": true + } + } + }, + "json": { + "data": { + "attributes": { + "selfService": true + }, + "type": "selfService" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for updating an app's self-service status.

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

attributes

\n
\n

object

\n

Attributes for updating an app's self-service status.

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

selfService [required]

\n
\n

boolean

\n

Whether the app is enabled for self-service.

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

type

\n
\n

enum

\n

The self-service resource type. \nAllowed enum values: selfService

default: selfService

\n
\n \n
\n
\n
\n
" + } + }, + "UpdateAppTags": { + "responses": { + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "tags": [ + "team:platform", + "service:ops" + ] + } + } + }, + "json": { + "data": { + "attributes": { + "tags": [ + "team:platform", + "service:ops" + ] + }, + "type": "tags" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for replacing an app's tags.

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

attributes

\n
\n

object

\n

Attributes for replacing an app's tags.

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

tags [required]

\n
\n

[string]

\n

The full list of tags that should be set on the app. Existing tags not present in this list are removed.

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

type

\n
\n

enum

\n

The tags resource type. \nAllowed enum values: tags

default: tags

\n
\n \n
\n
\n
\n
" + } + }, + "UpdateAppVersionName": { + "responses": { + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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": { + "name": "v1.2.0 - bug fix release" + } + } + }, + "json": { + "data": { + "attributes": { + "name": "v1.2.0 - bug fix release" + }, + "type": "versionNames" + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

object

\n

Data for naming a specific app version.

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

attributes

\n
\n

object

\n

Attributes for naming a specific app version.

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

name [required]

\n
\n

string

\n

The name to assign to the app version.

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

type

\n
\n

enum

\n

The version-name resource type. \nAllowed enum values: versionNames

default: versionNames

\n
\n \n
\n
\n
\n
" + } + }, + "ListAppVersions": { + "responses": { + "200": { + "json": { + "data": [ + { + "attributes": { + "app_id": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "created_at": "2019-09-19T10:00:00.000Z", + "has_ever_been_published": true, + "name": "v1.2.0 - bug fix release", + "updated_at": "2019-09-19T10:00:00.000Z", + "user_id": "integer", + "user_name": "jane.doe@example.com", + "user_uuid": "65bb1f25-52e1-4510-9f8d-22d1516ed693", + "version": 3 + }, + "id": "9e20cbaf-68da-45a6-9ccf-54193ac29fa5", + "type": "appVersions" + } + ], + "meta": { + "page": { + "totalCount": "integer", + "totalFilteredCount": "integer" + } + } + }, + "html": "
\n
\n
\n
\n

data

\n
\n

[object]

\n

The list of app versions.

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

attributes

\n
\n

object

\n

Attributes describing an app version.

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

app_id

\n
\n

uuid

\n

The ID of the app this version belongs to.

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

created_at

\n
\n

date-time

\n

Timestamp of when the version was created.

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

has_ever_been_published

\n
\n

boolean

\n

Whether this version has ever been published.

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

name

\n
\n

string

\n

The optional human-readable name of the version.

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

updated_at

\n
\n

date-time

\n

Timestamp of when the version was last updated.

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

user_id

\n
\n

int64

\n

The ID of the user who created the version.

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

user_name

\n
\n

string

\n

The name (or email) of the user who created the version.

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

user_uuid

\n
\n

uuid

\n

The UUID of the user who created the version.

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

version

\n
\n

int64

\n

The version number of the app, starting at 1.

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

id

\n
\n

uuid

\n

The ID of the app version.

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

type

\n
\n

enum

\n

The app-version resource type. \nAllowed enum values: appVersions

default: appVersions

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

meta

\n
\n

object

\n

Pagination metadata.

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

page

\n
\n

object

\n

Information on the total number of apps, to be used for pagination.

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

totalCount

\n
\n

int64

\n

The total number of apps under the Datadog organization, disregarding any filters applied.

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

totalFilteredCount

\n
\n

int64

\n

The total number of apps that match the specified filters.

\n
\n \n
\n
\n
\n
\n
\n
" + }, + "400": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "403": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \n
\n
\n
\n
" + }, + "404": { + "json": { + "errors": [ + { + "detail": "Missing required attribute in body", + "meta": {}, + "source": { + "header": "Authorization", + "parameter": "limit", + "pointer": "/data/attributes/title" + }, + "status": "400", + "title": "Bad Request" + } + ] + }, + "html": "
\n
\n
\n
\n

errors [required]

\n
\n

[object]

\n

A list of errors.

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

detail

\n
\n

string

\n

A human-readable explanation specific to this occurrence of the error.

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

meta

\n
\n

object

\n

Non-standard meta-information about the error

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

source

\n
\n

object

\n

References to the source of the error.

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

header

\n
\n

string

\n

A string indicating the name of a single request header which caused the error.

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

parameter

\n
\n

string

\n

A string indicating which URI query parameter caused the error.

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

pointer

\n
\n

string

\n

A JSON pointer to the value in the request document that caused the error.

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

status

\n
\n

string

\n

Status code of the response.

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

title

\n
\n

string

\n

Short human-readable summary of the error.

\n
\n \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 9cc2abb9ae9..8f6ec2779e1 100644 --- a/data/api/v2/full_spec.yaml +++ b/data/api/v2/full_spec.yaml @@ -4554,6 +4554,15 @@ components: type: string x-enum-varnames: - DEPLOYMENT + AppFavoriteType: + default: favorites + description: The favorite resource type. + enum: + - favorites + example: favorites + type: string + x-enum-varnames: + - FAVORITES AppKeyRegistrationData: description: Data related to the app key registration. properties: @@ -4614,6 +4623,25 @@ components: format: int64 type: integer type: object + AppProtectionLevel: + description: The publication protection level of the app. `approval_required` means changes must go through an approval workflow before being published. + enum: + - direct_publish + - approval_required + example: direct_publish + type: string + x-enum-varnames: + - DIRECT_PUBLISH + - APPROVAL_REQUIRED + AppProtectionLevelType: + default: protectionLevel + description: The protection-level resource type. + enum: + - protectionLevel + example: protectionLevel + type: string + x-enum-varnames: + - PROTECTIONLEVEL AppRelationship: description: The app's publication relationship and custom connections. properties: @@ -4625,6 +4653,24 @@ components: deployment: $ref: "#/components/schemas/DeploymentRelationship" type: object + AppSelfServiceType: + default: selfService + description: The self-service resource type. + enum: + - selfService + example: selfService + type: string + x-enum-varnames: + - SELFSERVICE + AppTagsType: + default: tags + description: The tags resource type. + enum: + - tags + example: tags + type: string + x-enum-varnames: + - TAGS AppTriggerWrapper: description: "Schema for an App-based trigger." properties: @@ -4636,6 +4682,80 @@ components: required: - appTrigger type: object + AppVersion: + description: A version of an app. + properties: + attributes: + $ref: "#/components/schemas/AppVersionAttributes" + id: + description: The ID of the app version. + example: 9e20cbaf-68da-45a6-9ccf-54193ac29fa5 + format: uuid + type: string + type: + $ref: "#/components/schemas/AppVersionType" + type: object + AppVersionAttributes: + description: Attributes describing an app version. + properties: + app_id: + description: The ID of the app this version belongs to. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + created_at: + description: Timestamp of when the version was created. + format: date-time + type: string + has_ever_been_published: + description: Whether this version has ever been published. + example: true + type: boolean + name: + description: The optional human-readable name of the version. + example: v1.2.0 - bug fix release + type: string + updated_at: + description: Timestamp of when the version was last updated. + format: date-time + type: string + user_id: + description: The ID of the user who created the version. + format: int64 + type: integer + user_name: + description: The name (or email) of the user who created the version. + example: jane.doe@example.com + type: string + user_uuid: + description: The UUID of the user who created the version. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + version: + description: The version number of the app, starting at 1. + example: 3 + format: int64 + type: integer + type: object + AppVersionNameType: + default: versionNames + description: The version-name resource type. + enum: + - versionNames + example: versionNames + type: string + x-enum-varnames: + - VERSIONNAMES + AppVersionType: + default: appVersions + description: The app-version resource type. + enum: + - appVersions + example: appVersions + type: string + x-enum-varnames: + - APPVERSIONS ApplicationKeyCreateAttributes: description: Attributes used to create an application Key. properties: @@ -17014,6 +17134,40 @@ components: - type - number type: object + CreatePublishRequestRequest: + description: A request to ask for approval to publish an app whose protection level is `approval_required`. + example: + data: + attributes: + description: Adds new dashboard widgets and a few bug fixes. + title: Release v1.2 to production + type: publishRequest + properties: + data: + $ref: "#/components/schemas/CreatePublishRequestRequestData" + type: object + CreatePublishRequestRequestData: + description: Data for creating a publish request. + properties: + attributes: + $ref: "#/components/schemas/CreatePublishRequestRequestDataAttributes" + type: + $ref: "#/components/schemas/PublishRequestType" + type: object + CreatePublishRequestRequestDataAttributes: + description: Attributes for creating a publish request. + properties: + description: + description: An optional description of the changes in this publish request. + example: Adds new dashboard widgets and a few bug fixes. + type: string + title: + description: A short title for the publish request. + example: Release v1.2 to production + type: string + required: + - title + type: object CreateRuleRequest: description: Scorecard create rule request. properties: @@ -40586,6 +40740,17 @@ components: format: int64 type: integer type: object + ListAppVersionsResponse: + description: A paginated list of versions for an app. + properties: + data: + description: The list of app versions. + items: + $ref: "#/components/schemas/AppVersion" + type: array + meta: + $ref: "#/components/schemas/ListAppsResponseMeta" + type: object ListApplicationKeysResponse: description: Response for a list of application keys. properties: @@ -56630,6 +56795,15 @@ components: data: $ref: "#/components/schemas/Deployment" type: object + PublishRequestType: + default: publishRequest + description: The publish-request resource type. + enum: + - publishRequest + example: publishRequest + type: string + x-enum-varnames: + - PUBLISHREQUEST PutAppsDatastoreItemResponseArray: description: Response after successfully inserting multiple items into a datastore, containing the identifiers of the created items. properties: @@ -79920,6 +80094,62 @@ components: data: $ref: "#/components/schemas/ActionConnectionData" type: object + UpdateAppFavoriteRequest: + description: A request to add or remove an app from the current user's favorites. + example: + data: + attributes: + favorite: true + type: favorites + properties: + data: + $ref: "#/components/schemas/UpdateAppFavoriteRequestData" + type: object + UpdateAppFavoriteRequestData: + description: Data for updating an app's favorite status. + properties: + attributes: + $ref: "#/components/schemas/UpdateAppFavoriteRequestDataAttributes" + type: + $ref: "#/components/schemas/AppFavoriteType" + type: object + UpdateAppFavoriteRequestDataAttributes: + description: Attributes for updating an app's favorite status. + properties: + favorite: + description: Whether the app should be marked as a favorite for the current user. + example: true + type: boolean + required: + - favorite + type: object + UpdateAppProtectionLevelRequest: + description: A request to update an app's publication protection level. + example: + data: + attributes: + protectionLevel: approval_required + type: protectionLevel + properties: + data: + $ref: "#/components/schemas/UpdateAppProtectionLevelRequestData" + type: object + UpdateAppProtectionLevelRequestData: + description: Data for updating an app's publication protection level. + properties: + attributes: + $ref: "#/components/schemas/UpdateAppProtectionLevelRequestDataAttributes" + type: + $ref: "#/components/schemas/AppProtectionLevelType" + type: object + UpdateAppProtectionLevelRequestDataAttributes: + description: Attributes for updating an app's publication protection level. + properties: + protectionLevel: + $ref: "#/components/schemas/AppProtectionLevel" + required: + - protectionLevel + type: object UpdateAppRequest: description: A request object for updating an existing app. example: @@ -80079,6 +80309,99 @@ components: type: string type: array type: object + UpdateAppSelfServiceRequest: + description: A request to enable or disable self-service for an app. + example: + data: + attributes: + selfService: true + type: selfService + properties: + data: + $ref: "#/components/schemas/UpdateAppSelfServiceRequestData" + type: object + UpdateAppSelfServiceRequestData: + description: Data for updating an app's self-service status. + properties: + attributes: + $ref: "#/components/schemas/UpdateAppSelfServiceRequestDataAttributes" + type: + $ref: "#/components/schemas/AppSelfServiceType" + type: object + UpdateAppSelfServiceRequestDataAttributes: + description: Attributes for updating an app's self-service status. + properties: + selfService: + description: Whether the app is enabled for self-service. + example: true + type: boolean + required: + - selfService + type: object + UpdateAppTagsRequest: + description: A request to replace the tags on an app. + example: + data: + attributes: + tags: + - team:platform + - service:ops + type: tags + properties: + data: + $ref: "#/components/schemas/UpdateAppTagsRequestData" + type: object + UpdateAppTagsRequestData: + description: Data for replacing an app's tags. + properties: + attributes: + $ref: "#/components/schemas/UpdateAppTagsRequestDataAttributes" + type: + $ref: "#/components/schemas/AppTagsType" + type: object + UpdateAppTagsRequestDataAttributes: + description: Attributes for replacing an app's tags. + properties: + tags: + description: The full list of tags that should be set on the app. Existing tags not present in this list are removed. + example: + - team:platform + - service:ops + items: + type: string + type: array + required: + - tags + type: object + UpdateAppVersionNameRequest: + description: A request to assign a human-readable name to a specific app version. + example: + data: + attributes: + name: v1.2.0 - bug fix release + type: versionNames + properties: + data: + $ref: "#/components/schemas/UpdateAppVersionNameRequestData" + type: object + UpdateAppVersionNameRequestData: + description: Data for naming a specific app version. + properties: + attributes: + $ref: "#/components/schemas/UpdateAppVersionNameRequestDataAttributes" + type: + $ref: "#/components/schemas/AppVersionNameType" + type: object + UpdateAppVersionNameRequestDataAttributes: + description: Attributes for naming a specific app version. + properties: + name: + description: The name to assign to the app version. + example: v1.2.0 - bug fix release + type: string + required: + - name + type: object UpdateAppsDatastoreItemRequest: description: Request to update specific fields on an existing datastore item. properties: @@ -89058,6 +89381,542 @@ paths: operator: OR permissions: - apps_write + "/api/v2/app-builder/apps/{app_id}/favorite": + patch: + description: Add or remove an app from the current user's favorites. Favorited apps can be filtered for using the `filter[favorite]` query parameter on the [List Apps](https://docs.datadoghq.com/api/latest/app-builder/#list-apps) endpoint. + operationId: UpdateAppFavorite + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + favorite: true + type: favorites + schema: + $ref: "#/components/schemas/UpdateAppFavoriteRequest" + required: true + responses: + "200": + description: OK + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Update App Favorite Status + tags: + - App Builder + x-menu-order: 9 + "x-permission": + operator: OR + permissions: + - apps_run + "/api/v2/app-builder/apps/{app_id}/protection-level": + patch: + description: Update the publication protection level of an app. When set to `approval_required`, future publishes must go through an approval workflow before going live. + operationId: UpdateProtectionLevel + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + protectionLevel: approval_required + type: protectionLevel + schema: + $ref: "#/components/schemas/UpdateAppProtectionLevelRequest" + required: true + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + attributes: + components: [] + description: This is a simple example app + favorite: false + name: Example App + queries: [] + rootInstanceName: grid0 + tags: [] + id: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + type: appDefinitions + schema: + $ref: "#/components/schemas/UpdateAppResponse" + description: OK + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Update App Protection Level + tags: + - App Builder + x-menu-order: 10 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/publish-request": + post: + description: Create a publish request to ask for approval to publish an app whose protection level is `approval_required`. Publishing happens automatically once the request is approved by a user with the appropriate permissions. + operationId: CreatePublishRequest + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + description: Adds new dashboard widgets and a few bug fixes. + title: Release v1.2 to production + type: publishRequest + schema: + $ref: "#/components/schemas/CreatePublishRequestRequest" + required: true + responses: + "201": + content: + application/json: + examples: + default: + value: + data: + attributes: + app_version_id: 9e20cbaf-68da-45a6-9ccf-54193ac29fa5 + id: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + meta: + created_at: "2026-04-01T12:00:00Z" + user_name: jane.doe@example.com + user_uuid: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + type: deployment + schema: + $ref: "#/components/schemas/PublishAppResponse" + description: Created + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Create Publish Request + tags: + - App Builder + x-menu-order: 15 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/revert": + post: + description: Revert an app to a previous version. The version to revert to is selected through the `version` query parameter. The reverted version becomes the new latest version of the app. + operationId: RevertApp + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + - description: The version number of the app to revert to. Cannot be `latest`. The special value `deployed` can be used to revert to the currently published version. + example: "2" + in: query + name: version + required: true + schema: + type: string + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + attributes: + components: [] + description: This is a simple example app + favorite: false + name: Example App + queries: [] + rootInstanceName: grid0 + tags: [] + id: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + type: appDefinitions + schema: + $ref: "#/components/schemas/UpdateAppResponse" + description: OK + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Revert App + tags: + - App Builder + x-menu-order: 16 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/self-service": + patch: + description: Enable or disable self-service for an app. Self-service apps can be discovered and run by users in your organization without explicit access being granted. + operationId: UpdateAppSelfService + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + selfService: true + type: selfService + schema: + $ref: "#/components/schemas/UpdateAppSelfServiceRequest" + required: true + responses: + "200": + description: OK + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Update App Self-Service Status + tags: + - App Builder + x-menu-order: 11 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/tags": + patch: + description: Replace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed. + operationId: UpdateAppTags + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + tags: + - team:platform + - service:ops + type: tags + schema: + $ref: "#/components/schemas/UpdateAppTagsRequest" + required: true + responses: + "204": + description: No Content + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Update App Tags + tags: + - App Builder + x-menu-order: 12 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/version-name": + patch: + description: Assign a human-readable name to a specific version of an app. The version is selected through the `version` query parameter. + operationId: UpdateAppVersionName + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + - description: The version number of the app to name. The special values `latest` and `deployed` can also be used to target the latest or currently published version. + example: "3" + in: query + name: version + required: true + schema: + type: string + requestBody: + content: + application/json: + examples: + default: + value: + data: + attributes: + name: v1.2.0 - bug fix release + type: versionNames + schema: + $ref: "#/components/schemas/UpdateAppVersionNameRequest" + required: true + responses: + "204": + description: No Content + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: Name App Version + tags: + - App Builder + x-menu-order: 14 + "x-permission": + operator: OR + permissions: + - apps_write + "/api/v2/app-builder/apps/{app_id}/versions": + get: + description: List the versions of an app. This endpoint is paginated. + operationId: ListAppVersions + parameters: + - description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + - description: The number of versions to return per page. + in: query + name: limit + required: false + schema: + format: int64 + type: integer + - description: The page number to return. + in: query + name: page + required: false + schema: + format: int64 + type: integer + responses: + "200": + content: + application/json: + examples: + default: + value: + data: + - attributes: + app_id: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + created_at: "2026-04-01T12:00:00Z" + has_ever_been_published: true + name: v1.2.0 - bug fix release + updated_at: "2026-04-01T12:00:00Z" + user_name: jane.doe@example.com + user_uuid: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + version: 3 + id: 9e20cbaf-68da-45a6-9ccf-54193ac29fa5 + type: appVersions + meta: + page: + totalCount: 1 + schema: + $ref: "#/components/schemas/ListAppVersionsResponse" + description: OK + "400": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Bad Request + "403": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Forbidden + "404": + content: + application/json: + schema: + $ref: "#/components/schemas/JSONAPIErrorResponse" + description: Not Found + "429": + $ref: "#/components/responses/TooManyRequestsResponse" + summary: List App Versions + tags: + - App Builder + x-menu-order: 13 + "x-permission": + operator: AND + permissions: + - apps_run + - connections_read /api/v2/application_keys: get: description: List all application keys available for your org diff --git a/data/api/v2/translate_actions.json b/data/api/v2/translate_actions.json index 333d2ba7f8a..a2718313715 100644 --- a/data/api/v2/translate_actions.json +++ b/data/api/v2/translate_actions.json @@ -416,6 +416,50 @@ "description": "Publish an app for use by other users. To ensure the app is accessible to the correct users, you also need to set a [Restriction Policy](https://docs.datadoghq.com/api/latest/restriction-policies/) on the app if a policy does not yet exist. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access).", "summary": "Publish App" }, + "UpdateAppFavorite": { + "description": "Add or remove an app from the current user's favorites. Favorited apps can be filtered for using the `filter[favorite]` query parameter on the [List Apps](https://docs.datadoghq.com/api/latest/app-builder/#list-apps) endpoint.", + "summary": "Update App Favorite Status", + "request_description": "", + "request_schema_description": "A request to add or remove an app from the current user's favorites." + }, + "UpdateProtectionLevel": { + "description": "Update the publication protection level of an app. When set to `approval_required`, future publishes must go through an approval workflow before going live.", + "summary": "Update App Protection Level", + "request_description": "", + "request_schema_description": "A request to update an app's publication protection level." + }, + "CreatePublishRequest": { + "description": "Create a publish request to ask for approval to publish an app whose protection level is `approval_required`. Publishing happens automatically once the request is approved by a user with the appropriate permissions.", + "summary": "Create Publish Request", + "request_description": "", + "request_schema_description": "A request to ask for approval to publish an app whose protection level is `approval_required`." + }, + "RevertApp": { + "description": "Revert an app to a previous version. The version to revert to is selected through the `version` query parameter. The reverted version becomes the new latest version of the app.", + "summary": "Revert App" + }, + "UpdateAppSelfService": { + "description": "Enable or disable self-service for an app. Self-service apps can be discovered and run by users in your organization without explicit access being granted.", + "summary": "Update App Self-Service Status", + "request_description": "", + "request_schema_description": "A request to enable or disable self-service for an app." + }, + "UpdateAppTags": { + "description": "Replace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed.", + "summary": "Update App Tags", + "request_description": "", + "request_schema_description": "A request to replace the tags on an app." + }, + "UpdateAppVersionName": { + "description": "Assign a human-readable name to a specific version of an app. The version is selected through the `version` query parameter.", + "summary": "Name App Version", + "request_description": "", + "request_schema_description": "A request to assign a human-readable name to a specific app version." + }, + "ListAppVersions": { + "description": "List the versions of an app. This endpoint is paginated.", + "summary": "List App Versions" + }, "ListApplicationKeys": { "description": "List all application keys available for your org", "summary": "Get all application keys"