drafting

Have SwingFactor draft the question

Follow it, and stop it, as one of the workspace’s runs: GET /workspaces/{id}/runs?kind=draft&subject={questionId}.

post/workspaces/{id}/questions/{questionId}/drafts

Request

  • Base URL: https://api.swingfactor.ai/v1
  • URL: https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/drafts
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

Headers

Idempotency-Keystring

Any unique string. The same key, method, path and body within 24 hours answers with the first response instead of creating again; the same key on a different request is 409 idempotency_key_reused.

Request body

focus'requests' | 'null' nullable

requests: only what people asked for — open changes asked on challenges, and find-out requests. Absent: a whole draft.

Response

Queued — or, focused on requests while a draft runs, waiting: the requests stay open for the next.

idstring uuid required
statusstring required

queued — or, focused on requests while a draft runs, waiting.

notestring

Where nothing new started: what happens instead.

Changes

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