Board

Ask a quick question about your work

Answers from the board: tasks, plans and states, sealed reports, the conversations behind them and what their agents last wrote. It never starts work and never reaches a computer; an answer that needs work ends with "Make it a task?" (needs_work: true).

With Accept: text/event-stream the answer streams: queued (position, expected_wait_ms) while it waits its turn, delta (text) as it is written, then done (this response’s object). Otherwise the whole answer comes back as JSON.

task_id: the selected task, when the question is about it. history: the drawer’s earlier turns.

post/v1/questions

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/questions
  • Auth: HTTP bearer

Request body

textstring required
task_idstring nullable

A task id (t_…).

organization_idstring uuid

UUIDv7, lowercase canonical form.

project_idstring uuid

UUIDv7, lowercase canonical form.

Response

Default Response

textstring required
needs_workboolean required

Answering needs work: the answer ends with "Make it a task?".

answered_by'model' | 'rules' required
first_token_msinteger nullable required
total_msinteger required

Changes

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