---
title: "Set how much help you get"
method: POST
path: "/api/v1/set_assist_mode"
tags: ["write"]
---

# Set how much help you get

`POST /api/v1/set_assist_mode`

## Request

- Base URL: `https://awraiter.ai`
- URL: `https://awraiter.ai/api/v1/set_assist_mode`
- Auth: HTTP bearer

Save how much coaching this person wants from you, for all their channels and future sessions: quiet (just do what is asked, no tips), normal (a short tip only when it clearly matters) or coach (review every draft, suggest topics and hypotheses, weekly review). Call it when they answer the first-session question or ask for less or more advice. Applies from the next message on; the returned rules are what to follow.

## Headers

- `Idempotency-Key` string

## Request body

- SetAssistModeInput
  - `mode` 'quiet' | 'normal' | 'coach', required

## Response `200`

The tool's result in `data`.

- SetAssistModeOutput
  - `ok` unknown, required
  - `data` object, required: Not declared by the tool yet; treat the shape as informational.
  - `usage` Usage: Remaining paid AI actions for the team. Present only on tools that cost AI quota.
    - `aiActionsRemaining` integer, required: -1 when the team is unlimited.
    - `aiActionsLimit` integer, required: -1 when the team is unlimited.
    - `unlimited` boolean, required

## Other responses

- `400`: Invalid arguments (`invalid_input`, with per-field `details`) or a missing `channelId` (`channel_id_required`).
- `401`: No or unknown token (`unauthorized`). The `WWW-Authenticate` header points at the OAuth resource metadata.
- `402`: The team has no active subscription (`subscription_required`).
- `403`: Read-only token on a write tool (`read_only_token`), channel outside the team or the member's ACL (`channel_not_accessible`), channel over the plan limit (`channel_over_plan_limit`), or the user left the team (`not_team_member`).
- `404`: Unknown tool (`unknown_tool`) or an entity the tool could not find (`*_not_found`).
- `409`: The same call is already running (`duplicate_in_flight`); wait instead of retrying.
- `422`: The request was understood but cannot be executed — any other domain error code.
- `428`: The tool needs confirmation before it acts; repeat the call with `confirmationToken`.
- `429`: Rate limit (`rate_limited`, see `Retry-After`), AI quota (`ai_quota_exhausted`) or the daily agent-job budget (`agent_budget_exhausted`).
- `500`: The tool failed unexpectedly (`tool_error`). Nothing internal is disclosed; the `X-Request-Id` header identifies the call for support.

---

[API](https://skmtc.dev/awraiter/apis/awraiter-rest-v1.md) · [All operations](https://skmtc.dev/awraiter/apis/awraiter-rest-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/awraiter/apis/awraiter-rest-v1/revisions/c16dace566cf?raw)