Create Change in workspace | Atomicwork

curl -X POST https://{tenant}.atomicwork.com/api/v1/change-management/changes \
     -H "X-Workspace-Id: {{workspace_id}}" \
     -H "X-Api-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "change_template": 15,
  "subject": "Upgrade database server to latest patch",
  "created_by": 1024,
  "requester": 2048,
  "owner": 3072,
  "agent_group": 512,
  "assignee": 4096,
  "change_type": "Standard",
  "change_start_date": "2024-07-01T09:00:00Z",
  "change_completion_date": "2024-07-01T17:00:00Z",
  "planned_change_start_date": "2024-07-01T08:30:00Z",
  "planned_change_completion_date": "2024-07-01T18:00:00Z",
  "actual_change_start_date": "2024-07-01T09:15:00Z",
  "actual_change_completion_date": "2024-07-01T16:45:00Z",
  "priority": "High"
}'

Authentication

X-Api-Keystring

API Key authentication via header

Headers

X-Workspace-IdstringOptional

Query parameters

problem_display_idstringOptional

Request

This endpoint expects an object.

change_templatelongRequired

subjectstringRequired1-2000 characters

created_bylongOptional

requesterlongOptional

ownerlongOptional

agent_grouplongOptional

assigneelongOptional

change_typestringOptional

change_start_datedatetimeOptional

change_completion_datedatetimeOptional

planned_change_start_datedatetimeOptional

planned_change_completion_datedatetimeOptional

actual_change_start_datedatetimeOptional

actual_change_completion_datedatetimeOptional

prioritystringOptional

statusstringOptional

impactstringOptional

urgencystringOptional

parent_change_idlongOptional

parent_display_idstringOptional

Formatted display ID of the parent (e.g. CHG-5 or REQ-123)

parent_request_typestringOptional

Entity type of the parent (CHANGE or REQUEST)

descriptionstringOptional

attachmentslist of longsOptional

tagslist of longsOptional

workspace_idlongOptional

assetslist of longsOptional

linked_requestslist of stringsOptional

custom_fieldsobjectOptional

template_fieldsobjectOptional

created_atdatetimeOptional

updated_atdatetimeOptional

external_idstringOptional

external_sourceenumOptional

Allowed values:

external_system_entity_referenceobjectOptional

Response

Successful response