research

Save drafts

Deprecated: use research.drafts.save.v2 (research_drafts_save_v2), which also takes a study video; this version takes none, leaves every video out of the document it returns, and refuses to save over a stored draft that holds one (409 PRECONDITION_FAILED, details.reason video_attachment), since replacing the document would remove it. Save one of the signed-in user's unfinished Research study drafts. Send a new draft id with revision 0 to create it, or the revision you last read to replace its document; a draft changed elsewhere since that revision is refused, never overwritten. Returns the saved revision. Drafts belong to the user who saves them, so an API key cannot save one.

post/api/v1/research/drafts/save

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/research/drafts/save
  • Auth: OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Request body

idstring uuid required

The study draft id; the client mints it for a new draft.

revisioninteger required

The revision this edit was read at, or 0 to create the draft.

Response

Success.

idstring uuid required
revisioninteger required

Compare-and-swap revision a later save must name.

Changes

No recorded changes to this operation across all 1 revision of this API.