--- title: "Revert App" method: POST path: "/api/v2/app-builder/apps/{app_id}/revert" tags: ["App Builder"] --- # Revert App `POST /api/v2/app-builder/apps/{app_id}/revert` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/app-builder/apps/{app_id}/revert` - Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` 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. ## Path parameters - `app_id` string, uuid, required ## Query parameters - `version` string, required ## Response `200` OK - UpdateAppResponse: The response object after an app is successfully updated. - `data` UpdateAppResponseData: The data object containing the updated app definition. - `attributes` UpdateAppResponseDataAttributes, required: The updated app definition attributes, such as name, description, and components. - `components` ComponentGrid[]: The UI components that make up the app. - `events` AppBuilderEvent[]: Events to listen for on the grid component. - `name` 'pageChange' | 'tableRowClick' | '_tableRowButtonClick' | 'change' | 'submit' | 'click' | 'toggleOpen' | 'close' | 'open' | 'executionFinished': The triggering action for the event. - `type` 'custom' | 'setComponentState' | 'triggerQuery' | 'openModal' | 'closeModal' | 'openUrl' | 'downloadFile' | 'setStateVariableValue': The response to the event. - `id` string: The ID of the grid component. This property is deprecated; use `name` to identify individual components instead. - `name` string, required: A unique identifier for this grid component. This name is also visible in the app editor. - `properties` ComponentGridProperties, required: Properties of a grid component. - `backgroundColor` string: The background color of the grid. - `children` Component[]: The child components of the grid. - `events` AppBuilderEvent[]: Events to listen for on the UI component. - … - `id` string, nullable: The ID of the UI component. This property is deprecated; use `name` to identify individual components instead. - `name` string, required: A unique identifier for this UI component. This name is also visible in the app editor. - `properties` ComponentProperties, required: Properties of a UI component. Different component types can have their own additional unique properties. See the [components documentation](https://docs.datadoghq.com/service_management/app_builder/components/) for more detail on each component type and its properties. - … - `type` 'table' | 'textInput' | 'textArea' | 'button' | 'text' | 'select' | 'modal' | 'schemaForm' | 'checkbox' | 'tabs' | 'vegaChart' | 'radioButtons' | 'numberInput' | 'fileInput' | 'jsonInput' | 'gridCell' | 'dateRangePicker' | 'search' | 'container' | 'calloutValue', required: The UI component type. - `isVisible` union: Whether the grid component and its children are visible. If a string, it must be a valid JavaScript expression that evaluates to a boolean. - string - boolean - `type` 'grid', required: The grid component type. - `description` string: The human-readable description for the app. - `favorite` boolean: Whether the app is marked as a favorite by the current user. - `name` string: The name of the app. - `queries` Query[]: An array of queries, such as external actions and state variables, that the app uses. - union: A data query used by an app. This can take the form of an external action, a data transformation, or a state variable. - ActionQuery: An action query. This query type is used to trigger an action, such as sending a HTTP request. - `events` AppBuilderEvent[]: Events to listen for downstream of the action query. - … - `id` string, uuid, required: The ID of the action query. - `name` string, required: A unique identifier for this action query. This name is also used to access the query's result throughout the app. - `properties` ActionQueryProperties, required: The properties of the action query. - … - `type` 'action', required: The action query type. - DataTransform: A data transformer, which is custom JavaScript code that executes and transforms data when its inputs change. - `id` string, uuid, required: The ID of the data transformer. - `name` string, required: A unique identifier for this data transformer. This name is also used to access the transformer's result throughout the app. - `properties` DataTransformProperties, required: The properties of the data transformer. - … - `type` 'dataTransform', required: The data transform type. - StateVariable: A variable, which can be set and read by other components in the app. - `id` string, uuid, required: The ID of the state variable. - `name` string, required: A unique identifier for this state variable. This name is also used to access the variable's value throughout the app. - `properties` StateVariableProperties, required: The properties of the state variable. - … - `type` 'stateVariable', required: The state variable type. - `rootInstanceName` string: The name of the root component of the app. This must be a `grid` component that contains all other components. - `tags` string[]: A list of tags for the app, which can be used to filter apps. - `id` string, uuid, required: The ID of the updated app. - `type` 'appDefinitions', required: The app definition type. - `included` Deployment[]: Data on the version of the app that was published. - `attributes` DeploymentAttributes: The attributes object containing the version ID of the published app. - `app_version_id` string, uuid: The version ID of the app that was published. For an unpublished app, this is always the nil UUID (`00000000-0000-0000-0000-000000000000`). - `id` string, uuid: The deployment ID. - `meta` DeploymentMetadata: Metadata object containing the publication creation information. - `created_at` string, date-time: Timestamp of when the app was published. - `user_id` integer: The ID of the user who published the app. - `user_name` string: The name (or email address) of the user who published the app. - `user_uuid` string, uuid: The UUID of the user who published the app. - `type` 'deployment': The deployment type. - `meta` AppMeta: Metadata of an app. - `created_at` string, date-time: Timestamp of when the app was created. - `deleted_at` string, date-time: Timestamp of when the app was deleted. - `org_id` integer: The Datadog organization ID that owns the app. - `updated_at` string, date-time: Timestamp of when the app was last updated. - `updated_since_deployment` boolean: 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. - `user_id` integer: The ID of the user who created the app. - `user_name` string: The name (or email address) of the user who created the app. - `user_uuid` string, uuid: The UUID of the user who created the app. - `version` integer: The version number of the app. This starts at 1 and increments with each update. - `relationship` AppRelationship: The app's publication relationship and custom connections. - `connections` CustomConnection[]: Array of custom connections used by the app. - `attributes` CustomConnectionAttributes: The custom connection attributes. - `name` string: The name of the custom connection. - `onPremRunner` CustomConnectionAttributesOnPremRunner: Information about the Private Action Runner used by the custom connection, if the custom connection is associated with a Private Action Runner. - `id` string: The Private Action Runner ID. - `url` string: The URL of the Private Action Runner. - `id` string, uuid: The ID of the custom connection. - `type` 'custom_connections': The custom connection type. - `deployment` DeploymentRelationship: Information pointing to the app's publication status. - `data` DeploymentRelationshipData: Data object containing the deployment ID. - `id` string, uuid: The deployment ID. - `type` 'deployment': The deployment type. - `meta` DeploymentMetadata: Metadata object containing the publication creation information. - `created_at` string, date-time: Timestamp of when the app was published. - `user_id` integer: The ID of the user who published the app. - `user_name` string: The name (or email address) of the user who published the app. - `user_uuid` string, uuid: The UUID of the user who published the app. ## Other responses - `400`: Bad Request - `403`: Forbidden - `404`: Not Found - `429`: Too many requests --- [API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)