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

# API Reference

> Complete API reference for Flowent API Gateway. Explore all endpoints, request/response formats, authentication methods, and interactive API playground.

## Flowent API Gateway Specification

The Flowent API Gateway provides a REST API for registering and managing custom actions. All endpoints require JWT authentication obtained by exchanging your API token.

## Authentication

All API endpoints are authenticated using Bearer tokens:

```bash theme={null}
curl -X GET https://your-flowent-instance.com/api/v1/gateway/actions \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

To obtain a JWT token, exchange your API token first:

```bash theme={null}
curl -X POST https://your-flowent-instance.com/api/v1/gateway/token/exchange \
  -H "Content-Type: application/json" \
  -d '{"api_token": "your-api-token"}'
```

## Endpoints

### Authentication

* **POST** `/api/v1/gateway/token/exchange` - Exchange API token for JWT

### Actions

* **GET** `/api/v1/gateway/actions` - List all actions
* **POST** `/api/v1/gateway/actions` - Register a new action
* **GET** `/api/v1/gateway/actions/{action_name}` - Get action details
* **PUT** `/api/v1/gateway/actions/{action_name}` - Update an action
* **DELETE** `/api/v1/gateway/actions/{action_name}` - Delete an action

For detailed information, see the [API Concepts](/api-concepts) documentation.