v1

latestOpenAPI 3.1.02026-07-13250151.3 KB
notes

Log an implementation note against an intent.

Rate-limited by the 'general' bucket (300/h sliding window, keyed user:<userId> or ip:<ip>). The created row's created_by is set to the authenticated userId, but the POST response does NOT echo createdBy (only id, intentId, note, source, createdAt). The GET list response DOES include createdBy.

post/api/v1/intents/{id}/notes

Path parameters

idstring required

id path parameter.

Query parameters

workspace_idstring

Required ONLY for cookie-session auth; identifies the target workspace. Ignored for API-key auth.

Request body

notestring required

Non-empty after trim.

source'mcp' | 'cli' | 'github' | 'manual' | 'verification_checkpoint' | 'linear' | 'jira' | 'execution_sync'

Origin of the note; defaults to 'manual' when omitted.

Response

Created — returns { id, intentId, note, source, createdAt }

object required