Skip to main content
PATCH
Change what a conversation may apply without asking

Authorizations

X-API-Key
string
header
required

Path Parameters

conversation_id
string<uuid>
required

Body

application/json

Replace a conversation's grant list, or hand it back to the workspace defaults.

granted_verbs
enum<string>[] | null
required

The verbs this conversation may apply without asking. Send the current list minus one verb to take that verb back. Send null to follow the workspace defaults again; an empty list allows nothing. A send is refused.

Maximum array length: 8

The eight things an AI may do to a workspace.

Exactly eight, not sixty: today's cell-level actions all run against one cell, and building a table, adding contacts to a sequence and starting a search had no home at all. Anything new here is a product decision about what an assistant may touch, not a convenience for a planner.

Available options:
create_table_from_search,
add_column,
run_column,
enrich_rows,
add_contacts_to_sequence,
push_to_destination,
call_endpoint,
start_search

Response

Successful Response

What one conversation may apply without asking: the list, and where it comes from.

Read for the shield in the chat header. follows_defaults tells the header whether to show the list as the workspace's (change it in Settings) or as this thread's own (take one back here, or return to the defaults).

follows_defaults
boolean
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_verbs
enum<string>[]
required

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

The eight things an AI may do to a workspace.

Exactly eight, not sixty: today's cell-level actions all run against one cell, and building a table, adding contacts to a sequence and starting a search had no home at all. Anything new here is a product decision about what an assistant may touch, not a convenience for a planner.

Available options:
create_table_from_search,
add_column,
run_column,
enrich_rows,
add_contacts_to_sequence,
push_to_destination,
call_endpoint,
start_search