Add a note to a deal's timeline

POST/deals/{id}/notes

Requires scope: write:deals

Parameters

Parameter	In	Type	Description
`id`required	path	string
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Request body

Field	Type	Allowed values	Description
`text`required	string	any string

Responses

Status	Description
`201`	Noted
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`404`	Deal not found
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/deals/b7c9a2e1-0000-4000-8000-000000000000/notes" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "string"
}'

Response (201)

{
  "ok": true,
  "event_id": "string"
}