All Docs
REST API Reference
The Cognova REST API lives at https://cognova.dev/api/v1. All endpoints require an API key via the Authorization: Bearer header.
Authentication
Every request must include your API key:
curl -H "Authorization: Bearer cg_YOUR_KEY" \
https://cognova.dev/api/v1/agents
Invalid or missing keys return 401 Unauthorized.
Base URL
https://cognova.dev/api/v1
Response Format
All endpoints return JSON with a data wrapper:
{
"data": { ... }
}
Errors return standard HTTP status codes with a message field.
Endpoints Overview
Agents
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/agents | List agents |
| POST | /api/v1/agents/ask | Ask an agent |
Tasks
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/tasks | List tasks |
| POST | /api/v1/tasks | Create task |
| PUT | /api/v1/tasks/:id | Update task |
Memory
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/memory/search | Search memories |
| POST | /api/v1/memory | Store memory |
Knowledge
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/knowledge | List files |
| GET | /api/v1/knowledge/:path | Get file |
Skill
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/skill | Download the Python skill script |
Rate Limits
There are currently no rate limits enforced. This may change in future releases.
Token Usage
Agent invocations (/api/v1/agents/ask) consume credits from your workspace pool. Usage is logged and visible in the dashboard under Settings > Billing.