# Overview

Ink writes from a prompt or rewrites supplied text with the shared Ink model. Rewrites check names, numbers, dates, quotes, citations and links, and show what changed. Review the result before using it. The shared model is not a trained personal voice.

## Choose a connection

* [MCP](https://ink.ego.ist/docs/mcp): connect an assistant with Ink OAuth and the person's consent.
* [REST API](https://ink.ego.ist/docs/api): use a Bearer API key from a paid account after trial.
* [Agent signup](https://ink.ego.ist/docs/agent-signup): start a subscription handoff with a claim link. Signup does not authorize an assistant.

## Make a request

Create a key in [API keys](https://ink.ego.ist/app/api-keys), then send a draft and a fresh UUID:

```sh
curl https://ink.ego.ist/api/v1/rewrites \
  -H "Authorization: Bearer $INK_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"text":"Please review the attached proposal.","settings":{"strength":"balanced"}}'
```

HTTP 200 returns a finished job. HTTP 202 returns a pending job; poll the `Location` URL with the same key. See [create and poll](https://ink.ego.ist/docs/api#create-and-poll) and the [endpoint reference](https://ink.ego.ist/docs/api/reference/create-rewrite).

## Read as markdown

Every page has a Copy as markdown button and a `.md` URL. Request `Accept: text/markdown` on a page URL for the same content. [llms.txt](https://ink.ego.ist/llms.txt) indexes public pages, [llms-full.txt](https://ink.ego.ist/llms-full.txt) contains these docs, and [auth.md](https://ink.ego.ist/auth.md) describes the signup handoff. The [OpenAPI document](https://ink.ego.ist/docs/openapi.json) describes the REST endpoints.
