Skip to content
Speccy

Mark a message as the thread's decision. A later decision is recorded as a reversal (REQ-089).

POST
/threads/{threadId}/decision
curl --request POST \
  --url https://example.com/api/v1/threads/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/decision \
  --header 'Content-Type: application/json' \
  --data '{ "message_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
threadId
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
message_id
required
string format: uuid
Examplegenerated
{
  "message_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

The thread.

Media typeapplication/json
object
id
required
string format: uuid
doc_id
string format: uuid
profile_key
string
anchor_kind
required
string
Allowed values: text section finding check
anchor
required

For text, an Anchor. For a section, {heading_path}. For a finding, {finding_id, check_slug}. For a check, {check_slug}.

object
key
additional properties
any
addressed_to
required
string
Allowed values: humans ai
title
required
string
handoff_id

The handoff a builder opened this thread from (REQ-137).

string format: uuid
handoff_version

The bundle version the builder took. 0 when no handoff opened it.

integer format: int64
blocking
required
boolean
status
required
string
Allowed values: open resolved
created_by
required
string
created_at
required
string format: date-time
last_message_at
required
string format: date-time
message_count
required
integer
messages
required
Array<object>
object
id
required
string format: uuid
seq
required
integer
author_kind
required
string
Allowed values: user guest ai
author_id
string
author_name
required
string
body
required
string
sources
required
Array<string>
decision
required
string
Allowed values: "" decision reversal
created_at
required
string format: date-time
answering
required

The AI is writing an answer.

boolean
Example
{
  "anchor_kind": "text",
  "addressed_to": "humans",
  "status": "open",
  "messages": [
    {
      "author_kind": "user",
      "decision": ""
    }
  ]
}

default

Section titled “default”

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "code": "example"
}