> 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/preclanks.md).

# 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
{ "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
{
  "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
{ "success": true }
```

> Requires Farcaster or Privy authentication.

***