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

# Create API key

> Generate a new API key for the authenticated user

This endpoint generates a new API key for the authenticated user. Unlike the login endpoint which creates a session token, this creates a persistent API key that can be used for long-term API access.

> [!NOTE]
>
> This endpoint requires authentication. Use your existing API key or session token to create additional API keys.

### Request Body

**name** `string` *required*

A name/label for the API key (e.g., "Production", "Development", "My App")

### Response

**message** `string`

Success message

**api\_key** `object`

The created API key details

**api\_key properties**

**name** `string`

The name/label of the API key

**token** `string`

The API key token. **Store this securely** - it will only be shown once.

**created\_at** `string`

ISO 8601 timestamp of when the API key was created

```json 201 Created theme={null}
{
  "message": "API key created successfully.",
  "api_key": {
    "name": "Production API Key",
    "token": "1|abc123xyz789abcdef...",
    "created_at": "2025-01-08T10:30:00.000000Z"
  }
}
```

```json 422 Validation Error theme={null}
{
  "message": "The name field is required.",
  "errors": {
    "name": ["The name field is required."]
  }
}
```

### Example Request

```bash theme={null}
curl -X POST https://app.lacy.ai/api/user/api-keys \
  -H "Authorization: Bearer YOUR_EXISTING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API Key"
  }'
```

> [!WARNING]
>
> The API key token is only returned once. Make sure to store it securely. If you lose it, you'll need to create a new one.

### Managing API Keys

* **GET /user/api-keys** - List all API keys for the authenticated user
* **DELETE /user/api-keys/{id}** - Delete a specific API key


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