> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clanker.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Preclanks

Endpoints for creating and managing pending token configurations (preclanks).

### POST `/api/preclank/v4`

Create a preclank (pending token configuration) for v4 deployment. Validates and simulates the deployment.

**Authentication:** User Auth (Farcaster / Privy)

**Body Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `keyword` | `string` | Yes | — | Deployment keyword. |
| `chain_id` | `number` | Yes | — | Chain ID. |
| `token_settings` | `object` | Yes | — | Token config: name, symbol, image\_url, description, admins, paired\_token, pool\_config\_type, starting\_market\_cap, fee\_config\_type, metadata, social\_context. |
| `vault_settings` | `object` | No | — | Vault settings. |
| `airdrop` | `object` | No | — | Airdrop configuration. |

**Response:** Success confirmation.

```json theme={null}
{ "success": true }
```

> Requires Farcaster or Privy authentication. Preclanks are active for 7 days.

***

### GET `/api/preclank/pending`

Returns all pending preclanks for the authenticated user.

**Authentication:** User Auth (Farcaster / Privy)

**Response:** Array of pending preclank objects.

```json theme={null}
{
  "pendingPreclanks": [ { "id": "...", "keyword": "...", ... } ]
}
```

> Requires Farcaster or Privy authentication.

***

### DELETE `/api/preclank/{id}`

Soft-deletes a preclank owned by the authenticated user.

**Authentication:** User Auth (Farcaster / Privy)

**Path Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `id` | `string` | Yes | — | Preclank ID. |

**Response:** Success confirmation.

```json theme={null}
{ "success": true }
```

> Requires Farcaster or Privy authentication.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.