# Idiolect AI API

**Canonical:** https://apis.io/apis/idiolect-app/idiolect-app-api/  
**Provider:** Idiolect AI — https://apis.io/providers/idiolect-app/  
**Documentation:** https://idiolect.app/developers

Idiolect AI API is one of 2 APIs that [Idiolect AI](https://apis.io/providers/idiolect-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Idiolect AI API as documented publicly: 17 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/score` | POST /api/score |
| POST | `/api/v1/draft` | Write new text from a brief, with optional instructions and format. |
| GET | `/api/v1/questions` | Open questions about the Writing Profile. |
| POST | `/api/v1/questions/{id}/answer` | Answer one question. |
| POST | `/api/v1/rewrite` | POST /api/v1/rewrite |
| POST | `/api/v1/score` | Score text against the Writing Profile. |
| GET | `/api/v1/voice` | The Writing Profile and its Voice Card. |
| POST | `/api/v1/voice/create` | Build a Writing Profile from samples or short answers. |
| GET | `/api/v1/voice/habits` | The habits of the Writing Profile. |
| POST | `/api/v1/voice/habits/{id}/confirm` | Mark a habit as right. |
| POST | `/api/v1/voice/habits/{id}/remove` | Remove a habit. |
| POST | `/api/v1/voice/habits/{id}/restore` | Bring back a removed habit. |
| POST | `/api/v1/voice/rules` | Save a rule in the words of the person, with an optional scope. |
| DELETE | `/api/v1/voice/rules/{id}` | Remove a rule. |
| PATCH | `/api/v1/voice/rules/{id}` | Change the wording or scope of a rule. |
| GET | `/api/voice/curl` | Read a public Voice Card. |
| GET | `/api/voice/your-slug` | GET /api/voice/your-slug |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/idiolect-app/openapi/_ae-authored/idiolect-app-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/idiolect-app/json-schema/idiolect-app-post-api-score-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/idiolect-app/json-schema/idiolect-app-post-api-v1-rewrite-request-schema.json

## Other Idiolect AI APIs (1)

- [Idiolect API](https://apis.io/apis/idiolect-app/idiolect-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/idiolect-app/idiolect-app-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/idiolect-app/.