Discuss
Membership-private persistent conversation with the shared Search Agent.
Capture exact private evidence passages
/api/v1/workspaces/{workspace_id}/evidence-collectionsMembership-private native work capability. Current Workspace and resource permissions are checked on every request. Responses use Cache-Control: no-store. Requires a browser session and CSRF. Reuse Idempotency-Key only for the same request. Before retrying an uncertain write, resolve its operation receipt. Evidence collections are private, partial investigations. Hydration is required before reuse; references do not authorize shared publication. Changed, unavailable and excluded sources return no text. No inference occurs.
Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Replace the exclusion set in one investigation version
/api/v1/workspaces/{workspace_id}/evidence-collections/exclusionsMembership-private native work capability. Current Workspace and resource permissions are checked on every request. Responses use Cache-Control: no-store. Requires a browser session and CSRF. Reuse Idempotency-Key only for the same request. Before retrying an uncertain write, resolve its operation receipt. Evidence collections are private, partial investigations. Hydration is required before reuse; references do not authorize shared publication. Changed, unavailable and excluded sources return no text. No inference occurs.
Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Read an exact private evidence collection
/api/v1/workspaces/{workspace_id}/evidence-collections/{id}Membership-private native work capability. Current Workspace and resource permissions are checked on every request. Responses use Cache-Control: no-store. Exact versions never refresh or replace selected targets implicitly. Evidence collections are private, partial investigations. Hydration is required before reuse; references do not authorize shared publication. Changed, unavailable and excluded sources return no text. No inference occurs.
Path Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Read up to twenty currently authorized exact passages
/api/v1/workspaces/{workspace_id}/evidence-collections/{id}/hydrateMembership-private native work capability. Current Workspace and resource permissions are checked on every request. Responses use Cache-Control: no-store. Exact versions never refresh or replace selected targets implicitly. Evidence collections are private, partial investigations. Hydration is required before reuse; references do not authorize shared publication. Changed, unavailable and excluded sources return no text. No inference occurs.
Path Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Resolve the current membership's Discuss access state
/api/v1/workspaces/{workspace_id}/discuss/availabilityReturns a server-owned feature decision before the client loads private history. Plan labels are presentation metadata; clients must branch on access and reason.
Path Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List the current membership's private Discuss messages
/api/v1/workspaces/{workspace_id}/discuss/messagesPath Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Queue one private message for the Discuss supervisor
/api/v1/workspaces/{workspace_id}/discuss/messagesPersists the user message and pending assistant turn, then returns without waiting for inference. The same supervisor runtime, native MCP tools and streamed event projection used by POST /discuss/turns complete the turn. Reuse the same Idempotency-Key to retrieve the existing turn without starting another run.
Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Resolve a native reference with current Workspace permissions
/api/v1/workspaces/{workspace_id}/discuss/references/resolvePath Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uri>Short-lived presigned URL bound to one method, one object key, and the reserved length. Treat it as a credential: never log it, store it, or share it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Verify and complete a private upload
/api/v1/workspaces/{workspace_id}/discuss/uploads/{upload_id}/completePath Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Cancel a private upload reservation
/api/v1/workspaces/{workspace_id}/discuss/uploads/{upload_id}Path Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Delete a private file and release its storage
/api/v1/workspaces/{workspace_id}/discuss/files/{file_id}Path Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Authorize a private file download
/api/v1/workspaces/{workspace_id}/discuss/files/{file_id}/downloadPath Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Authorize a private file preview
/api/v1/workspaces/{workspace_id}/discuss/files/{file_id}/previewPath Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Persist a private turn for server-owned generation
/api/v1/workspaces/{workspace_id}/discuss/turnsAdmits the turn immediately and orders its response behind any active foreground run. Standalone greetings receive a source-independent reply after authorization. Greetings containing a substantive question or resource references use normal evidence retrieval.
Path Parameters
Header Parameters
Request Body
application/jsonobject[]·max 4Optional per-turn metadata only: task_selection with selection_id (Core freezes result_set_id/version), turn_preferences with locale and IANA timezone, evidence_collection with exact id/version, or search_result with query and result_version from the first 20 unfiltered work results. At most one of each. Evidence collection pins require current private ownership and the latest version; stale pins return revision_conflict before admission. Identical acknowledged retries recover the historical handle without granting current source authority. Core repeats and reauthorizes that lexical query before Send; a changed version returns revision_conflict without admitting a turn. Search metadata grants no action authority or exhaustive coverage. Other part types or fields are rejected.
string <uuid>[]·max 5Clean files in the caller's private stream; at most 20 MiB combined. Empty content requires at least one file.
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Create a private GPT Live WebRTC session
/api/v1/workspaces/{workspace_id}/discuss/voice/sessionsExchanges a browser WebRTC offer for a server-configured GPT Live answer. The OpenAI API key remains on the private Knowledge service. Assign selects the model, disables provider storage, supplies bounded private Discuss history, and configures client delegation back into canonical Discuss. The client must wait for session.started before treating voice as ready.
Path Parameters
Header Parameters
Request Body
application/jsonstring·default fullAccount playback policy for generated voice output.
offconfirmationsfullResponses
string·const no-storePrevents storage of error responses by clients and intermediaries.
integer·min 15·max 600Upper session lifetime enforced by client teardown and server authority checks.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
stringCurrent server-owned generation state when this message has a durable run. Omitted for messages without a run.
queuedrunningcancel_requestedcompletedfailedobject[]·max 20Extensible typed message parts. specialist_result may include delivery_mode (direct or supporting) and an author object with actor_id, definition_id, version, revision, name, initiator_actor_id and parent_run_id pinned at admission. Direct results retain that author; supporting results are presented as Discuss. Unknown or absent attribution uses the generic Agent label. runtime_text is a full pending-text snapshot with stable part_id, optional run_id/step_id/generation/revision, producer_fence, producer_sequence and a UTF-8 byte offset; snapshots replace text and never imply concatenation or provider usage. context_capsule records Core-resolved visible UI scope. tool_activity is a stable Core-sanitized user projection keyed by tool_call_id, with optional part_id/run_id/step_id/revision/producer_fence for independently versioned actual handler activity. States describe recorded execution, never effect confirmation; it excludes raw arguments/results, prompts, credentials and hidden reasoning. entity_references contains at most 20 Core-reauthorized Project/Task identities with canonical labels/locators and observed revisions for trusted client navigation. task_result identifies one exact read or committed single-Task create/update with task_id, task_code, title, observed_revision and reason; clients must hydrate current authorized Task properties rather than treating it as a frozen snapshot. Completed Discuss mutations include an immutable action_result with action/receipt IDs, before/after state, entity version, actor, timestamp, risk level and a conditional inverse when reversible. interaction represents approval, ambiguity, stale-action and recovery states; policy-required reviews include the exact ChangeSet ID, version and digest. operation_receipts groups bounded canonical receipt references in a receipts array with operation_id, tool, state and optional resource_type, resource_id and revision. Receipts and mutations commit together; model prose alone is not a receipt.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List safe activity for one private Discuss response
/api/v1/workspaces/{workspace_id}/discuss/messages/{message_id}/run-eventsReturns a bounded run-local sequence containing only user-visible lifecycle events and sanitized tool activity. Raw tool arguments/results, prompts, credentials, internal events and hidden reasoning are never returned. Current Workspace membership is rechecked on every request.
Path Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Request an exact stop for a queued or running response
/api/v1/workspaces/{workspace_id}/discuss/messages/{message_id}/cancelQueued work becomes cancelled immediately. Running work first reports cancel_requested; its terminal message and run state are reconciled after execution has stopped. A completed action and its receipt are never described as rolled back.
Path Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
stringCurrent server-owned generation state when this message has a durable run. Omitted for messages without a run.
queuedrunningcancel_requestedcompletedfailedobject[]·max 20Extensible typed message parts. specialist_result may include delivery_mode (direct or supporting) and an author object with actor_id, definition_id, version, revision, name, initiator_actor_id and parent_run_id pinned at admission. Direct results retain that author; supporting results are presented as Discuss. Unknown or absent attribution uses the generic Agent label. runtime_text is a full pending-text snapshot with stable part_id, optional run_id/step_id/generation/revision, producer_fence, producer_sequence and a UTF-8 byte offset; snapshots replace text and never imply concatenation or provider usage. context_capsule records Core-resolved visible UI scope. tool_activity is a stable Core-sanitized user projection keyed by tool_call_id, with optional part_id/run_id/step_id/revision/producer_fence for independently versioned actual handler activity. States describe recorded execution, never effect confirmation; it excludes raw arguments/results, prompts, credentials and hidden reasoning. entity_references contains at most 20 Core-reauthorized Project/Task identities with canonical labels/locators and observed revisions for trusted client navigation. task_result identifies one exact read or committed single-Task create/update with task_id, task_code, title, observed_revision and reason; clients must hydrate current authorized Task properties rather than treating it as a frozen snapshot. Completed Discuss mutations include an immutable action_result with action/receipt IDs, before/after state, entity version, actor, timestamp, risk level and a conditional inverse when reversible. interaction represents approval, ambiguity, stale-action and recovery states; policy-required reviews include the exact ChangeSet ID, version and digest. operation_receipts groups bounded canonical receipt references in a receipts array with operation_id, tool, state and optional resource_type, resource_id and revision. Receipts and mutations commit together; model prose alone is not a receipt.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List private specialist work linked to Discuss
/api/v1/workspaces/{workspace_id}/discuss/specialist-runsReturns bounded projections from canonical Agent and hosted work-session journals. Provider transcripts, prompts, leases and internal execution state are excluded.
Path Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Get one private Discuss specialist run
/api/v1/workspaces/{workspace_id}/discuss/specialist-runs/{specialist_run_id}Path Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Request cooperative cancellation of specialist work
/api/v1/workspaces/{workspace_id}/discuss/specialist-runs/{specialist_run_id}/cancelRoutes cancellation through the bound canonical Agent or work-session journal. A terminal completion may still win a concurrent stop request.
Path Parameters
Header Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Resolve one AG-UI specialist interrupt
/api/v1/workspaces/{workspace_id}/discuss/specialist-runs/{specialist_run_id}/resumeResolves the current canonical work-session clarification or approval. Core reloads the interaction kind and request digest; client metadata cannot widen or replace them. Exact resolved-answer replays are idempotent at the work-session journal.
Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Resolve one version-fenced private clarification or approval
/api/v1/workspaces/{workspace_id}/discuss/interactions/{interaction_id}/decisionThe first valid decision wins. Expired interactions or interactions whose bound message revision changed become stale and cannot resume work.
Path Parameters
Header Parameters
Request Body
application/jsonobjectExplicitly review this exact current version of the same ChangeSet bound to the approval. Core atomically updates the binding and admits the continuation; editing alone never approves. Omit for existing unchanged approvals and clarifications.
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
integer·min 1Seconds until the client may retry.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Search the current membership's private Discuss history
/api/v1/workspaces/{workspace_id}/discuss/messages/searchPath Parameters
Query Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Advance the current membership's Discuss read position
/api/v1/workspaces/{workspace_id}/discuss/read-statePath Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
Read private Discuss schedule, ceremony, delivery, and wording preferences
/api/v1/workspaces/{workspace_id}/discuss/preferencesPath Parameters
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 100IANA timezone used only by this Workspace membership's Discuss schedule.
booleanWhen true, timezone tracks the Account timezone and is returned as the resolved effective value.
Replace private Discuss preferences at an exact revision
/api/v1/workspaces/{workspace_id}/discuss/preferencesPath Parameters
Header Parameters
Request Body
application/jsonstring·min 1·max 100IANA timezone used only by this Workspace membership's Discuss schedule.
booleanWhen true, timezone tracks the Account timezone and is returned as the resolved effective value.
booleanConservative master opt-in; existing notification/device policies still apply.
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 100IANA timezone used only by this Workspace membership's Discuss schedule.
booleanWhen true, timezone tracks the Account timezone and is returned as the resolved effective value.
List the current membership's private work reminders
/api/v1/workspaces/{workspace_id}/discuss/remindersCreate an explicitly confirmed private work reminder
/api/v1/workspaces/{workspace_id}/discuss/remindersPath Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Complete, cancel, or snooze one private reminder
/api/v1/workspaces/{workspace_id}/discuss/reminders/{reminder_id}Path Parameters
Header Parameters
Request Body
Responses
string·const no-storePrevents storage of error responses by clients and intermediaries.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.