---
title: "Create Change in workspace"
method: POST
path: "/api/v1/change-management/changes"
tags: ["changeManagement"]
---

# Create Change in workspace

`POST /api/v1/change-management/changes`

## Query parameters

- `problem_display_id` string

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Request body

- object
  - `created_by` integer
  - `requester` integer
  - `owner` integer
  - `agent_group` integer
  - `assignee` integer
  - `change_type` string
  - `change_template` integer, required
  - `change_start_date` string, date-time
  - `change_completion_date` string, date-time
  - `planned_change_start_date` string, date-time
  - `planned_change_completion_date` string, date-time
  - `actual_change_start_date` string, date-time
  - `actual_change_completion_date` string, date-time
  - `subject` string, required
  - `priority` string
  - `status` string
  - `impact` string
  - `urgency` string
  - `parent_change_id` integer
  - `parent_display_id` string — Formatted display ID of the parent (e.g. CHG-5 or REQ-123)
  - `parent_request_type` string — Entity type of the parent (CHANGE or REQUEST)
  - `description` string
  - `attachments` integer[]
  - `tags` integer[]
  - `workspace_id` integer
  - `assets` integer[]
  - `linked_requests` string[]
  - `custom_fields` ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaCustomFields
  - `template_fields` ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaTemplateFields
  - `notes` ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaNotesItems[]
    - `user_id` integer
    - `description` string
    - `mentions` integer[]
    - `is_private` boolean
    - `source` 'EMAIL' | 'SLACK' | 'TEAMS' | 'PORTAL' | 'WORKFLOW' | 'JOURNEY' | 'API' | 'UNIVERSAL_AGENT' | 'RAPID7'
    - `type` 'ESD_NOTE' | 'SLACK_NOTE' | 'EMAIL_NOTE' | 'RATING' | 'TEMPLATE' | 'WORKFLOW_NOTE'
    - `attachments` integer[]
  - `conversation_info` ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaConversationInfo
    - `channel_name` string
    - `channel_id` string
    - `start_timestamp` string, unix-timestamp, required
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `external_id` string
  - `external_source` 'SAAS_GENIE' | 'SNOW' | 'JSM_BRIDGE'
  - `external_system_entity_reference` union
    - ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaExternalSystemEntityReference0
      - `type` string, required
      - `project_id` string
      - `build_id` string
      - `organization_id` string
      - `correlation_id` string
      - `organization_url` string
    - ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaExternalSystemEntityReference1
      - `type` string, required
      - `project_id` string
      - `release_id` string
      - `organization_id` string
      - `correlation_id` string
      - `organization_url` string
    - ApiV1ChangeManagementChangesPostRequestBodyContentApplicationJsonSchemaExternalSystemEntityReference2
      - `type` string, required
      - `issue_id` string

## Response `200`

Successful response

- ChangeManagementPostapiV1ChangeManagementChangesResponse200 — Empty response body

---

[API](https://skmtc.net/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.net/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/revisions/2e7047b35062/schema)