---
title: "Read what a conversation may apply without asking"
method: GET
path: "/assistant/conversations/{conversation_id}/grants/"
tags: ["workspace-actions"]
---

# Read what a conversation may apply without asking

`GET /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

What this chat conversation applies without asking, as it stands now: the write operations the AI Assistant runs unasked here (approving a card for this conversation adds one) and the verbs, and whether that list is the workspace defaults (read live, so a change in Settings reaches it) or the conversation's own, frozen the first time it allowed something. Anything on the list still asks when it is priced at or above the approval threshold, and a send always asks.

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

Successful Response

- ConversationGrantsReadSchema: 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). ``granted_tools`` is what the shield lists: the AI Assistant's cards are decided by tool, and the verbs decide only an agent's.
  - `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_tools` string[], 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_verbs` WorkspaceVerb[], required: The verbs this conversation applies without asking, in effect now.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Conversation not found.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)