--- title: "Create a change request" method: POST path: "/api/v2/change-management/change-request" tags: ["Change Management"] --- # Create a change request `POST /api/v2/change-management/change-request` Create a new change request. ## Request body - ChangeRequestCreateRequest — Request object to create a change request. - `data` ChangeRequestCreateData, required — Data object to create a change request. - `attributes` ChangeRequestCreateAttributes, required — Attributes for creating a change request. - `change_request_linked_incident_uuid` string — The UUID of an incident to link to the change request. - `change_request_maintenance_window_query` string — The maintenance window query for the change request. - `change_request_plan` string — The plan associated with the change request. - `change_request_risk` 'UNDEFINED' | 'LOW' | 'MEDIUM' | 'HIGH' — The risk level of the change request. - `change_request_type` 'NORMAL' | 'STANDARD' | 'EMERGENCY' — The type of the change request. - `description` string — The description of the change request. - `end_date` string, date-time — The planned end date of the change request. - `project_id` string — The project UUID to associate with the change request. - `requested_teams` string[] — A list of team handles to request decisions from. - `start_date` string, date-time — The planned start date of the change request. - `title` string, required — The title of the change request. - `type` 'change_request', required — Change request resource type. ## Response `201` Created - ChangeRequestResponse — Response object for a change request. - `data` ChangeRequestResponseData, required — Data object for a change request response. - `attributes` ChangeRequestResponseAttributes, required — Attributes of a change request response. - `archived_at` string, date-time, nullable — Timestamp of when the change request was archived. - `attributes` ChangeRequestObjectAttributes, required — Custom attributes of the change request as key-value pairs. - `change_request_linked_incident_uuid` string, required — The UUID of the linked incident. - `change_request_maintenance_window_query` string, required — The maintenance window query for the change request. - `change_request_plan` string, required — The plan associated with the change request. - `change_request_risk` 'UNDEFINED' | 'LOW' | 'MEDIUM' | 'HIGH', required — The risk level of the change request. - `change_request_type` 'NORMAL' | 'STANDARD' | 'EMERGENCY', required — The type of the change request. - `closed_at` string, date-time, nullable — Timestamp of when the change request was closed. - `created_at` string, date-time, required — Timestamp of when the change request was created. - `creation_source` string, required — The source from which the change request was created. - `description` string, required — The description of the change request. - `end_date` string, date-time — The planned end date of the change request. - `key` string, required — The human-readable key of the change request. - `modified_at` string, date-time, required — Timestamp of when the change request was last modified. - `plan_notebook_id` integer, required — The notebook ID associated with the change request plan. - `priority` string, required — The priority of the change request. - `project_id` string, required — The project UUID associated with the change request. - `start_date` string, date-time — The planned start date of the change request. - `status` string, required — The current status of the change request. - `title` string, required — The title of the change request. - `type` string, required — The case type. - `id` string, required — The identifier of the change request. - `relationships` ChangeRequestRelationships — Relationships of a change request. - `change_request_decisions` ChangeRequestDecisionsRelationship, required — Relationship to change request decisions. - `data` ChangeRequestDecisionRelationshipData[], required — Array of decision relationship data. - `id` string, required — The decision UUID. - `type` 'change_request_decision', required — Change request decision resource type. - `created_by` ChangeRequestUserRelationship, required — Relationship to a user. - `data` ChangeRequestUserRelationshipData, nullable, required — User relationship data. - `id` string, required — The user UUID. - `type` string, required — The user resource type. - `modified_by` ChangeRequestUserRelationship, required — Relationship to a user. - `data` ChangeRequestUserRelationshipData, nullable, required — User relationship data. - `id` string, required — The user UUID. - `type` string, required — The user resource type. - `type` 'change_request', required — Change request resource type. - `included` ChangeRequestIncludedItem[] — Included resources related to the change request. - union — An included resource item in the change request response. - ChangeRequestIncludedUser — An included user resource. - `attributes` ChangeRequestIncludedUserAttributes, required — Attributes of an included user. - `email` string, required — The email of the user. - `handle` string, required — The handle of the user. - `name` string, required — The name of the user. - `id` string, required — The user UUID. - `type` string, required — The resource type. - ChangeRequestIncludedDecision — An included change request decision resource. - `attributes` ChangeRequestDecisionResponseAttributes, required — Attributes of a change request decision in a response. - `change_request_status` 'REQUESTED' | 'APPROVED' | 'DECLINED', required — The status of a change request decision. - `decided_at` string, date-time, required — Timestamp of when the decision was made. - `decision_reason` string, required — The reason for the decision. - `deleted_at` string, date-time, required — Timestamp of when the decision was deleted. - `request_reason` string, required — The reason for requesting the decision. - `requested_at` string, date-time, required — Timestamp of when the decision was requested. - `id` string, required — The decision UUID. - `relationships` ChangeRequestDecisionRelationships — Relationships of a change request decision. - `modified_by` ChangeRequestUserRelationship, required — Relationship to a user. - `data` ChangeRequestUserRelationshipData, nullable, required — User relationship data. - … - `requested_by_user` ChangeRequestUserRelationship, required — Relationship to a user. - `data` ChangeRequestUserRelationshipData, nullable, required — User relationship data. - … - `requested_user` ChangeRequestUserRelationship, required — Relationship to a user. - `data` ChangeRequestUserRelationshipData, nullable, required — User relationship data. - … - `type` 'change_request_decision', required — Change request decision resource type. ## Other responses - `400` — Bad Request - `403` — Forbidden - `429` — Too many requests --- [API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)