API reference
API reference
Endpoints, request bodies, and response schemas for the Fous API.
The public API is available at https://api.fous.com. This reference is generated from the OpenAPI specification, version 1.1.0.
One query endpoint for direct API calls and automatic routing. Responses may include additional fields; clients should ignore fields they do not use.
Endpoints
| Method | Endpoint | Reference |
|---|---|---|
| GET | / | Get Service |
| GET | /health | Get Health |
| POST | /v1/query | Query an API directly or route a prompt |
| GET | /v1/query/requests/{request_id} | Retrieve request status, billing and retained result |
| POST | /v1/query/requests/{request_id}/feedback | Rate a completed public API call |
| GET | /v1/auth | Authenticate |
| GET | /v1/catalog/categories | List Api Categories |
| GET | /v1/catalog | List Apis |
| GET | /v1/catalog/tools | List Tools |
| POST | /v1/files | Upload File |
| GET | /v1/files/{file_id} | Get File |
| DELETE | /v1/files/{file_id} | Delete File |
| GET | /v1/files/{file_id}/content | Download File |
| GET | /.well-known/jwks.json | Get Signing Keys |
| GET | /openapi.json | Get Open Api |
Schemas
Explore the complete schema definitions for request and response types.