Nurama Developers
AI

List polish tones available to the chat composer.

Returns the polish tone catalogue so the frontend can render the tone dropdown without hard-coding strings client-side. The list is fixed for the MVP; workspace-scoped custom tones are planned for v2.

GET
/ai/tones

Returns the polish tone catalogue so the frontend can render the tone dropdown without hard-coding strings client-side. The list is fixed for the MVP; workspace-scoped custom tones are planned for v2.

Authorization

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: ai:use

Response Body

application/json

curl -X GET "https://example.com/ai/tones"
{  "tones": [    {      "id": "professional",      "label": "Professional"    },    {      "id": "casual",      "label": "Casual"    },    {      "id": "concise",      "label": "Concise"    },    {      "id": "friendly",      "label": "Friendly"    },    {      "id": "formal",      "label": "Formal"    },    {      "id": "cleanup",      "label": "Cleanup"    }  ]}