latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-227311,8115.6 MB

93e11b266872

agent builder

Update a conversation's access control

Spaces method and path for this operation:

<div><span class="operation-verb put">put</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/conversations/{conversation_id}/access_control</span></div>

Refer to Spaces for more information.

Replace a conversation's access mode and member list. Only the conversation owner can call this endpoint; every other caller receives a not-found response. Each call replaces the entire access control — the most recent successful update wins. Members can read and continue the conversation, but still need access to the conversation's agent. To learn more about agent conversations, refer to the agent chat documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

put/api/agent_builder/conversations/{conversation_id}/access_control

Path parameters

conversation_idstring required

The unique identifier of the conversation whose access control to update.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

access_mode'private' | 'public' required

Access-control mode: private (only the owner and the listed members can read and continue the conversation), public (any user with access to the conversation's agent can read and continue it).

Response

Indicates a successful response