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

# Authentication

> How to authenticate with the twixb API using API keys.

# Authentication

All API requests require authentication via an API key passed in the `X-API-Key` header.

## Get your API key

1. Log in to [twixb.com](https://twixb.com)
2. Go to [Settings](https://twixb.com/settings)
3. Click **Generate API Key**
4. Copy the key immediately — it is only shown once

Your API key looks like this: `twxb_a3f8...`

<Warning>
  Store your API key securely. It grants full access to your account. If compromised, revoke it immediately from Settings and generate a new one.
</Warning>

## Making requests

Include your API key in every request using the `X-API-Key` header:

```bash theme={null}
curl https://twixb.com/api/v1/newsfeeds \
  -H "X-API-Key: twxb_your_key_here"
```

## Base URL

All API endpoints use the following base URL:

```
https://twixb.com/api/v1
```

## Response format

All responses are JSON. Successful responses return `200` with data or `204` for deletions. Errors return standard HTTP status codes:

| Status | Description                            |
| ------ | -------------------------------------- |
| `200`  | Success                                |
| `204`  | Deleted successfully (no body)         |
| `401`  | Missing or invalid API key             |
| `403`  | Not authorized to access this resource |
| `404`  | Resource not found                     |
| `422`  | Validation error                       |

## Rate limits

The API currently does not enforce rate limits, but please be reasonable with your usage.