opntasks
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/v1

Authentication

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-Limit
    • X-RateLimit-Remaining
    • X-RateLimit-Reset

Error format

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "body/title must be a string"
}

Endpoints

MethodPathDescription
POST/runsStart a run session
GET/runsList run sessions
GET/runs/:idGet run details
POST/runs/:id/tasksSubmit tasks to a run
GET/tasksList tasks with filtering
GET/tasks/:idGet task details
PATCH/tasks/:idUpdate task status
GET/project-typesList project types
POST/project-typesRegister a project type

On this page