Sign in
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

expectedRepoBodyRevisionstring

Required for repository-authority intents. Opaque repoBodyRevision returned by the intent API; the server atomically refuses a verdict if the body moved.

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

Changes

Changed in 2 of the 14 revisions of this API.7

  • a660c0d361481See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

  • 155c812b368b6See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added