> For the complete documentation index, see [llms.txt](https://clanker.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clanker.gitbook.io/documentation/api-reference/user.md).

# User API

These endpoints require user authentication via Farcaster JWT or Privy token in the `Authorization` header.

**Base URL:** `https://www.clanker.world`

## Endpoints

### Preclanks

* `POST /api/preclank/v4` — Create a preclank (pending token configuration) for v4 deployment. Validates and simulates the deployment.
* `GET /api/preclank/pending` — Returns all pending preclanks for the authenticated user.
* `DELETE /api/preclank/{id}` — Soft-deletes a preclank owned by the authenticated user.

### Deployment

* `POST /api/tokens/save-deployed-token/from-ui` — Saves a UI-deployed token and enqueues it for indexing. Auth is optional — unauthenticated requests still trigger indexing but skip the database save.