API Reference
Overview
Complete REST API documentation for opntasks.
API Reference
The opntasks API is a REST API built on Fastify with JSON Schema validation. All endpoints accept and return JSON.
Base URL
https://api.opntasks.com/api/v1Authentication
All API requests require an API key passed in the Authorization header:
Authorization: Bearer opntasks_sk_...Rate limits
- 100 requests per minute per API key
- Rate limit headers are included in every response:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset
Error format
{
"statusCode": 400,
"error": "Bad Request",
"message": "body/title must be a string"
}Endpoints
| Method | Path | Description |
|---|---|---|
POST | /runs | Start a run session |
GET | /runs | List run sessions |
GET | /runs/:id | Get run details |
POST | /runs/:id/tasks | Submit tasks to a run |
GET | /tasks | List tasks with filtering |
GET | /tasks/:id | Get task details |
PATCH | /tasks/:id | Update task status |
GET | /project-types | List project types |
POST | /project-types | Register a project type |