opntasks
API Reference

Project Types

Project type registration endpoints.

Project Types

List project types

GET /api/v1/project-types

Returns all registered project types for the authenticated client.

Response

{
  "projectTypes": [
    {
      "id": "pt_abc123",
      "name": "accessibility-audit",
      "label": "Accessibility Audit",
      "description": "WCAG 2.2 compliance findings",
      "createdAt": "2026-03-01T00:00:00Z"
    }
  ]
}

Register a project type

POST /api/v1/project-types
{
  "name": "security-scan",
  "label": "Security Scan",
  "description": "Automated security vulnerability findings",
  "extensionSchema": {
    "type": "object",
    "properties": {
      "cveId": { "type": "string" },
      "cvssScore": { "type": "number" }
    }
  }
}

The extensionSchema is a JSON Schema that validates the extensions field on tasks submitted to this project type. If omitted, no extension validation is applied.

On this page