Source: https://atomicwork-preview.docs-staging.pageloop.ai/api-reference/problems/postapi-v-1-problems # Create problem request POST `https://{tenant}.atomicwork.com/api/v1/problems` ## Authorization #### X-Api-Key (header, string, required) ## Headers #### X-Workspace-Id (header, string) ## Body #### request\_type (body, string) #### request\_source (body, enum (string)) #### description (body, string) #### email\_content (body, string) #### plain\_text\_description\_override (body, string) Internal-only override for the persisted plain-text rendering of the description. When non-empty, AbstractRequestService persists it as RequestDetail.description instead of running HTMLSanitizerUtil.getPlainText() on the HTML description. Set ONLY by the email ingestion path (EmailIntentBasedRequestCreationService), which derives it from reqDescription via normalizeHtmlToPlainText(getPlainTextForRichHtml(...)) so system-generated HTML emails (BlackLine offboarding, etc.) avoid mashed table cells and blank-line storms. Annotated @JsonIgnore so external HTTP clients cannot set it via the request body — without that annotation, any caller of POST /requests, /service-requests, /incidents could write arbitrary unsanitized text into RequestDetail.description, bypassing the getPlainText() pipeline. The Lombok @SuperBuilder still exposes a setter for in-process Java callers (the email path), since builder access does not go through Jackson. #### status (body, string) #### priority (body, string) #### parent\_request\_id (body, integer) #### agent\_group (body, integer) #### assignee (body, integer) #### subject (body, string) #### notes (body, array of object) #### properties #### user\_id (integer) #### conversation\_id (integer) When set, the reply is mirrored into this conversation's thread (UAG). #### description (string) #### mentions (array of integer) #### is\_private (boolean) #### source (enum (string)) #### type (enum (string)) #### attachments (array of integer) #### cc\_emails (array of string) #### bcc\_emails (array of string) #### is\_broadcast (boolean) #### external\_id (string) #### external\_source\_type (enum (string)) #### email\_content (string) #### event\_created\_at (string) Event creation timestamp. When provided via public API, also backdates the note's created time, SLA metrics, and activity timestamps. Must not be in the future or before the request's creation time. #### workspace\_id (body, integer) #### conversation\_info (body, object) #### properties #### channel\_name (string) #### channel\_id (string) #### start\_timestamp (string, required) #### tags (body, array of integer) #### cc\_emails (body, array of string) #### bcc\_emails (body, array of string) #### attachments (body, array of integer) #### requester (body, integer) #### to\_email (body, string) #### request\_created\_from (body, object) #### properties #### id (string) #### type (enum (string)) #### custom\_fields (body, object) #### created\_at (body, string) #### updated\_at (body, string) #### external\_id (body, string) #### external\_source (body, enum (string)) #### resolution\_time (body, string) When the ticket was resolved in the source system. Only accepted during migration (requires external\_id or external\_source). #### first\_response\_time (body, string) When the first agent response occurred in the source system. Only accepted during migration (requires external\_id or external\_source). #### first\_response\_due\_time (body, string) SLA due time for first response from the source system. Only accepted during migration (requires external\_id or external\_source). #### resolution\_due\_time (body, string) SLA due time for resolution from the source system. Only accepted during migration (requires external\_id or external\_source). #### closed\_status\_at (body, string) When the ticket was moved to closed status in the source system. Only accepted during migration (requires external\_id or external\_source). When provided with a closed status, also sets resolution\_time if not explicitly provided. #### item\_id (body, integer) #### item\_fields (body, object) #### impact (body, string) #### urgency (body, string) #### category (body, string) #### subcategory (body, string) #### assets (body, array of integer) ## Response #### 200 Successful response #### Request ```bash cURL curl -X POST 'https://{tenant}.atomicwork.com/api/v1/problems' \ -H 'X-Api-Key: ' \ -H 'Content-Type: application/json' \ -d '{"request_type": "string", "request_source": "EMAIL", "description": "string", "email_content": "string", "plain_text_description_override": "string", "status": "string", "priority": "string", "parent_request_id": 0, "agent_group": 0, "assignee": 0, "subject": "string", "notes": [{"user_id": 0, "conversation_id": 0, "description": "string", "mentions": ["\u2026"], "is_private": true, "source": "EMAIL", "type": "ESD_NOTE", "attachments": ["\u2026"], "cc_emails": ["\u2026"], "bcc_emails": ["\u2026"], "is_broadcast": true, "external_id": "string", "external_source_type": "SAAS_GENIE", "email_content": "string", "event_created_at": "date-time"}], "workspace_id": 0, "conversation_info": {"channel_name": "string", "channel_id": "string", "start_timestamp": "unix-timestamp"}, "tags": [0], "cc_emails": ["string"], "bcc_emails": ["string"], "attachments": [0], "requester": 0, "to_email": "string", "request_created_from": {"id": "string", "type": "REQUEST_SETTINGS"}, "custom_fields": {}, "created_at": "date-time", "updated_at": "date-time", "external_id": "string", "external_source": "SAAS_GENIE", "resolution_time": "date-time", "first_response_time": "date-time", "first_response_due_time": "date-time", "resolution_due_time": "date-time", "closed_status_at": "date-time", "item_id": 0, "item_fields": {}, "impact": "string", "urgency": "string", "category": "string", "subcategory": "string", "assets": [0]}' ``` ```javascript JavaScript const res = await fetch('https://{tenant}.atomicwork.com/api/v1/problems', { method: 'POST', headers: { 'X-Api-Key': '', 'Content-Type': 'application/json', }, body: JSON.stringify({"request_type": "string", "request_source": "EMAIL", "description": "string", "email_content": "string", "plain_text_description_override": "string", "status": "string", "priority": "string", "parent_request_id": 0, "agent_group": 0, "assignee": 0, "subject": "string", "notes": [{"user_id": 0, "conversation_id": 0, "description": "string", "mentions": ["\u2026"], "is_private": true, "source": "EMAIL", "type": "ESD_NOTE", "attachments": ["\u2026"], "cc_emails": ["\u2026"], "bcc_emails": ["\u2026"], "is_broadcast": true, "external_id": "string", "external_source_type": "SAAS_GENIE", "email_content": "string", "event_created_at": "date-time"}], "workspace_id": 0, "conversation_info": {"channel_name": "string", "channel_id": "string", "start_timestamp": "unix-timestamp"}, "tags": [0], "cc_emails": ["string"], "bcc_emails": ["string"], "attachments": [0], "requester": 0, "to_email": "string", "request_created_from": {"id": "string", "type": "REQUEST_SETTINGS"}, "custom_fields": {}, "created_at": "date-time", "updated_at": "date-time", "external_id": "string", "external_source": "SAAS_GENIE", "resolution_time": "date-time", "first_response_time": "date-time", "first_response_due_time": "date-time", "resolution_due_time": "date-time", "closed_status_at": "date-time", "item_id": 0, "item_fields": {}, "impact": "string", "urgency": "string", "category": "string", "subcategory": "string", "assets": [0]}), }); const data = await res.json(); ``` ```python Python import requests res = requests.post( 'https://{tenant}.atomicwork.com/api/v1/problems', headers={'X-Api-Key': ''}, json={"request_type": "string", "request_source": "EMAIL", "description": "string", "email_content": "string", "plain_text_description_override": "string", "status": "string", "priority": "string", "parent_request_id": 0, "agent_group": 0, "assignee": 0, "subject": "string", "notes": [{"user_id": 0, "conversation_id": 0, "description": "string", "mentions": ["\u2026"], "is_private": true, "source": "EMAIL", "type": "ESD_NOTE", "attachments": ["\u2026"], "cc_emails": ["\u2026"], "bcc_emails": ["\u2026"], "is_broadcast": true, "external_id": "string", "external_source_type": "SAAS_GENIE", "email_content": "string", "event_created_at": "date-time"}], "workspace_id": 0, "conversation_info": {"channel_name": "string", "channel_id": "string", "start_timestamp": "unix-timestamp"}, "tags": [0], "cc_emails": ["string"], "bcc_emails": ["string"], "attachments": [0], "requester": 0, "to_email": "string", "request_created_from": {"id": "string", "type": "REQUEST_SETTINGS"}, "custom_fields": {}, "created_at": "date-time", "updated_at": "date-time", "external_id": "string", "external_source": "SAAS_GENIE", "resolution_time": "date-time", "first_response_time": "date-time", "first_response_due_time": "date-time", "resolution_due_time": "date-time", "closed_status_at": "date-time", "item_id": 0, "item_fields": {}, "impact": "string", "urgency": "string", "category": "string", "subcategory": "string", "assets": [0]} ) data = res.json() ```