Overview
All Flextell API endpoints are available under the base URL:
https://dev.flextell.ai/api
Authentication
Every request requires a Bearer token in the Authorization header. Obtain a token by completing the OAuth 2.0 flow described in the Authentication page.
Include these headers on every request:
curl --request GET \
--url https://dev.flextell.ai/api/<endpoint> \
--header "Authorization: Bearer <your_access_token>" \
--header "Content-Type: application/json"
POST, PUT, PATCH), pass your payload as JSON:
curl --request POST \
--url https://dev.flextell.ai/api/<endpoint> \
--header "Authorization: Bearer <your_access_token>" \
--header "Content-Type: application/json" \
--data '{
"key": "value"
}'
Standard response envelope
All responses return JSON. Successful responses follow this general structure:
{
"data": [ ... ],
"meta": {
"cursor": "cursor_eyJpZCI6InJlc18wMDIifQ",
"has_more": true,
"total": 100
}
}
{
"error": "unauthorized",
"message": "The access token is missing or invalid."
}
Operations
The API supports the following categories of operations across its resources:
| Operation | Method | Description |
|---|
| List | GET | Retrieve a paginated list of resources |
| Read | GET | Retrieve a single resource by ID |
| Create | POST | Create a new resource |
| Update | PUT | Replace an existing resource |
| Modify | PATCH | Partially update an existing resource |
| Delete | DELETE | Permanently remove a resource |
Before integrating an endpoint into your code, test it directly with curl. This lets you inspect the raw request and response, confirm your authentication is working, and understand the exact shape of the data — all without writing any application code.
