---
title: "Create request notes"
method: POST
path: "/api/v1/requests/{requestId}/notes"
tags: ["requests"]
---

# Create request notes

`POST /api/v1/requests/{requestId}/notes`

## Path parameters

- `requestId` string, required

## Headers

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

## Request body

- object
  - `user_id` integer
  - `conversation_id` integer — When set, the reply is mirrored into this conversation's thread (UAG).
  - `description` string
  - `mentions` integer[]
  - `is_private` boolean
  - `source` 'EMAIL' | 'SLACK' | 'TEAMS' | 'PORTAL' | 'WORKFLOW' | 'JOURNEY' | 'API' | 'UNIVERSAL_AGENT'
  - `type` 'ESD_NOTE' | 'SLACK_NOTE' | 'EMAIL_NOTE' | 'RATING' | 'TEMPLATE' | 'WORKFLOW_NOTE'
  - `attachments` integer[]
  - `cc_emails` string[]
  - `bcc_emails` string[]
  - `is_broadcast` boolean
  - `external_id` string
  - `external_source_type` 'SAAS_GENIE' | 'SNOW' | 'JSM_BRIDGE'
  - `email_content` string
  - `event_created_at` string, date-time — 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.

## Response `200`

Successful response

- RequestsPostapiV1RequestsRequestIdNotesResponse200 — Empty response body

## Changes

- **2026-08-12** `2ab1cf36239b` — 1 info
  - api operation id `postapi-v-1-requests-request-id-notes` removed and replaced with `postapi_v1_requests__requestId__notes`

[Change history](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/changes/api/v1/requests/:requestId/notes/post.md)

---

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