workspace-actions

Change what a conversation may apply without asking

Change the conversation's grant list. Take one operation back by sending granted_tools without it, or one verb by sending granted_verbs without it; a field left out keeps its half as it was. Send granted_verbs as null to follow the workspace defaults again, operations included. An empty list allows nothing and still stops following the defaults. A verb that always asks (pushing to a destination) cannot be granted and is refused.

patch/assistant/conversations/{conversation_id}/grants/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/assistant/conversations/{conversation_id}/grants/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

conversation_idstring uuid required

Request body

Response

Successful Response

follows_defaultsboolean required

Whether the list is the workspace defaults, read live. False once the conversation has a list of its own, which a change in Settings no longer reaches.

granted_toolsstring[] required

The write operations the AI Assistant runs without asking in this conversation, in effect now: operation names as GET /assistant/tools/ lists them, and family:<area> for the rest of one part of the product. Approving a card for this conversation adds its operation here. Only what still allows something is listed, by the name its operation has today.

granted_verbsWorkspaceVerb[] required

The verbs this conversation applies without asking, in effect now.

Changes

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