jesus/Vapora
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Vapora/api-catalog.json

1826 lines
36 KiB
JSON
Raw Normal View History

chore: ontology sync + 4 NCL ADRs + landing page update on+re: - core.ncl: 5 new Practice nodes (notification-channels, vapora-capabilities, agent-hot-reload-stable-identity, merkle-audit-trail, notification-channels) + 5 new edges; knowledge-graph-execution-history updated with HNSW+BM25+RRF - state.ncl: production-readiness blocker/catalyst updated (hot-reload complete, BudgetManager/LLMRouter still require restart); ontoref-integration catalyst updated (vapora-ontology/reflection crates, api-catalog.json, nickel contracts) ADRs (NCL): - adr-013: KG hybrid search — HNSW+BM25+RRF, rejected in-process scan - adr-014: capability packages — AgentDefinition→vapora-shared, DashMap shard-before-await constraint - adr-015: Merkle audit trail — SHA-256 hash chain, rejected HMAC - adr-016: agent hot-reload — stable_id=role, learning_profiles survive drain, BudgetManager excluded from reload scope landing page: - 2 new feature boxes: VCS-Agnostic Worktree (jj/git), Ontology Protocol - KG box: 20→28 tests, HNSW+BM25+RRF description - Agents box: 71→82 tests, hot-reload + stable_id - tech stack: Rust 21→23 crates, added jj, Radicle, ontoref badges - status badge: 620→691 tests
2026-04-07 21:06:48 +01:00
[
{
"method": "GET",
"path": "/api/v1/agents",
"description": "Returns all registered agents in the swarm.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"agents",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/agents",
"description": "Registers a new agent in the swarm with its initial capabilities.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/agents/:id",
"description": "Removes an agent from the swarm registry.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/agents/:id",
"description": "Returns a single agent by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"read"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/agents/:id",
"description": "Fully replaces an agent record with the provided payload.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/agents/:id/capabilities",
"description": "Adds a named capability to the specified agent's capability set.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/agents/:id/capabilities/:capability",
"description": "Removes a named capability from the specified agent.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
},
{
"name": "capability",
"kind": "string",
"constraint": "required",
"description": "Capability name"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/agents/:id/health",
"description": "Probes an agent's health and returns liveness status.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"health",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/agents/:id/skills",
"description": "Adds a named skill to the specified agent's skill set.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/agents/:id/status",
"description": "Transitions an agent to a new lifecycle status and fires inactivity notifications.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
}
],
"tags": [
"agents",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/agents/available",
"description": "Returns agents currently available to accept new task assignments.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"agents",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/agent/:id",
"description": "Returns performance metrics for a specific agent over the requested period.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Agent identifier"
},
{
"name": "period",
"kind": "string",
"constraint": "optional",
"description": "Time period (hour/day/week/month/all)"
}
],
"tags": [
"analytics",
"agents",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/cost-report",
"description": "Returns a cost efficiency report with per-provider and per-task-type breakdown.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "period",
"kind": "string",
"constraint": "optional",
"description": "Time period (hour/day/week/month/all)"
}
],
"tags": [
"analytics",
"cost",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/dashboard",
"description": "Returns aggregated system-wide dashboard metrics for the requested period.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "period",
"kind": "string",
"constraint": "optional",
"description": "Time period (hour/day/week/month/all)"
}
],
"tags": [
"analytics",
"dashboard",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/providers",
"description": "Returns cost breakdown grouped by LLM provider with percentage share.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [],
"tags": [
"analytics",
"providers",
"cost",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/providers/:provider",
"description": "Returns detailed cost and success-rate analytics for a single LLM provider.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "provider",
"kind": "string",
"constraint": "required",
"description": "Provider name (e.g. openai, anthropic)"
}
],
"tags": [
"analytics",
"providers",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/providers/:provider/forecast",
"description": "Returns weekly and monthly cost forecast for a provider based on recent usage trend.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "provider",
"kind": "string",
"constraint": "required",
"description": "Provider name (e.g. openai, anthropic)"
}
],
"tags": [
"analytics",
"providers",
"cost",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/providers/:provider/tasks/:task_type",
"description": "Returns a provider's performance metrics scoped to a specific task type.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "provider",
"kind": "string",
"constraint": "required",
"description": "Provider name"
},
{
"name": "task_type",
"kind": "string",
"constraint": "required",
"description": "Task type name"
}
],
"tags": [
"analytics",
"providers",
"tasks",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/providers/efficiency",
"description": "Returns providers ranked by efficiency ratio combining quality and cost scores.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [],
"tags": [
"analytics",
"providers",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/summary",
"description": "Returns a combined analytics summary covering dashboard metrics and cost report.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "period",
"kind": "string",
"constraint": "optional",
"description": "Time period (hour/day/week/month/all)"
}
],
"tags": [
"analytics",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/analytics/task-types/:task_type",
"description": "Returns aggregate analytics for a specific task type over the requested period.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "task_type",
"kind": "string",
"constraint": "required",
"description": "Task type name"
},
{
"name": "period",
"kind": "string",
"constraint": "optional",
"description": "Time period (hour/day/week/month/all)"
}
],
"tags": [
"analytics",
"tasks",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/channels",
"description": "Returns the names of all registered notification channels.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [],
"tags": [
"channels",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/channels/:name/test",
"description": "Sends a test message through the named notification channel to verify connectivity.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "name",
"kind": "string",
"constraint": "required",
"description": "Channel name"
}
],
"tags": [
"channels",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/projects",
"description": "Returns all projects visible to the authenticated tenant.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"projects",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/projects",
"description": "Creates a new project under the authenticated tenant.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [],
"tags": [
"projects",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/projects/:id",
"description": "Permanently removes a project and all its associated data.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
}
],
"tags": [
"projects",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/projects/:id",
"description": "Returns a single project by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
}
],
"tags": [
"projects",
"read"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/projects/:id",
"description": "Fully replaces a project record with the provided payload.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
}
],
"tags": [
"projects",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/projects/:id/archive",
"description": "Marks the project as archived, making it read-only.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
}
],
"tags": [
"projects",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/projects/:id/features",
"description": "Adds a named feature flag to the specified project.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
}
],
"tags": [
"projects",
"features",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/projects/:id/features/:feature",
"description": "Removes a named feature flag from the specified project.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Project identifier"
},
{
"name": "feature",
"kind": "string",
"constraint": "required",
"description": "Feature name"
}
],
"tags": [
"projects",
"features",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/proposals",
"description": "Returns proposals for a project, optionally filtered by status.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "project_id",
"kind": "string",
"constraint": "required",
"description": "Parent project identifier"
},
{
"name": "status",
"kind": "string",
"constraint": "optional",
"description": "Filter by proposal status"
}
],
"tags": [
"proposals",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/proposals",
"description": "Creates a new change proposal with risk level and execution plan.",
"auth": "bearer",
"actors": [
"agent",
"developer",
"admin"
],
"params": [],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/proposals/:id",
"description": "Permanently removes a proposal by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/proposals/:id",
"description": "Returns a single proposal by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"read"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/proposals/:id",
"description": "Fully replaces a proposal record with the provided payload.",
"auth": "bearer",
"actors": [
"agent",
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/proposals/:id/approve",
"description": "Approves a submitted proposal and fires approval notifications.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/proposals/:id/executed",
"description": "Marks an approved proposal as executed after the change has been applied.",
"auth": "bearer",
"actors": [
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/proposals/:id/reject",
"description": "Rejects a submitted proposal and fires rejection notifications.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/proposals/:id/reviews",
"description": "Returns all reviews attached to the specified proposal.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"reviews",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/proposals/:id/reviews",
"description": "Adds a reviewer decision (approve/reject with feedback) to a proposal.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"reviews",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/proposals/:id/submit",
"description": "Submits a draft proposal into the approval workflow.",
"auth": "bearer",
"actors": [
"agent",
"developer"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Proposal identifier"
}
],
"tags": [
"proposals",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/rlm/analyze",
"description": "Dispatches a query against retrieved chunks to an LLM and returns the synthesized response.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [],
"tags": [
"rlm",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/rlm/documents",
"description": "Loads, scans, and chunks a document into the RLM index for subsequent queries.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [],
"tags": [
"rlm",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/rlm/query",
"description": "Retrieves relevant document chunks using BM25 and semantic hybrid search.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [],
"tags": [
"rlm",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/schedules",
"description": "Returns all scheduled workflows with their cron expressions and next fire times.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"schedules",
"read"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/schedules/:id",
"description": "Permanently removes a scheduled workflow and its run history.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/schedules/:id",
"description": "Returns a single scheduled workflow by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"read"
],
"feature": ""
},
{
"method": "PATCH",
"path": "/api/v1/schedules/:id",
"description": "Partially updates a schedule; recomputes next_fire_at if cron_expression changes.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/schedules/:id",
"description": "Creates or fully replaces a scheduled workflow, validating cron and timezone.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/schedules/:id/fire",
"description": "Manually fires a scheduled workflow immediately, bypassing the cron timer.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/schedules/:id/runs",
"description": "Returns the execution run history for a scheduled workflow (last 100, descending).",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Schedule identifier"
}
],
"tags": [
"schedules",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/swarm/health",
"description": "Returns the overall health status of the swarm based on agent availability.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"swarm",
"health",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/swarm/stats",
"description": "Returns live swarm statistics including agent counts, average load, and active tasks.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"swarm",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/tasks",
"description": "Returns tasks for a project, optionally filtered by status or assignee.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "project_id",
"kind": "string",
"constraint": "required",
"description": "Parent project identifier"
},
{
"name": "status",
"kind": "string",
"constraint": "optional",
"description": "Filter by task status"
},
{
"name": "assignee",
"kind": "string",
"constraint": "optional",
"description": "Filter by assignee"
}
],
"tags": [
"tasks",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/tasks",
"description": "Creates a new task, scanning input for prompt-injection before persisting.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "DELETE",
"path": "/api/v1/tasks/:id",
"description": "Permanently removes a task by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/tasks/:id",
"description": "Returns a single task by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"read"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/tasks/:id",
"description": "Fully replaces a task record after prompt-injection scan.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/tasks/:id/assign",
"description": "Assigns a task to the specified agent or user.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/tasks/:id/priority",
"description": "Updates the priority level of the specified task.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/tasks/:id/reorder",
"description": "Updates a task's board position and optionally its status for Kanban drag-and-drop.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "PUT",
"path": "/api/v1/tasks/:id/status",
"description": "Transitions a task to a new status and triggers notifications on completion.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Task identifier"
}
],
"tags": [
"tasks",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/tracking/entries",
"description": "Returns tracked change log entries with optional project, source, and limit filters.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "project",
"kind": "string",
"constraint": "optional",
"description": "Filter by project path"
},
{
"name": "source",
"kind": "string",
"constraint": "optional",
"description": "Filter by source type"
},
{
"name": "limit",
"kind": "string",
"constraint": "optional",
"description": "Maximum number of results"
}
],
"tags": [
"tracking",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/tracking/health",
"description": "Returns liveness status of the tracking service.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"tracking",
"health",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/tracking/summary",
"description": "Returns aggregate statistics for tracked entries including change and TODO counts.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"tracking",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflow_orchestrator",
"description": "Returns all active and completed workflow instances managed by the orchestrator.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"workflow_orchestrator",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflow_orchestrator",
"description": "Starts a new multi-stage orchestrated workflow from a named template.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [],
"tags": [
"workflow_orchestrator",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflow_orchestrator/:id",
"description": "Returns the current state and stage of a specific orchestrated workflow instance.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow instance identifier"
}
],
"tags": [
"workflow_orchestrator",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflow_orchestrator/:id/approve",
"description": "Approves the current pending stage of an orchestrated workflow, unblocking execution.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow instance identifier"
}
],
"tags": [
"workflow_orchestrator",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflow_orchestrator/:id/cancel",
"description": "Cancels a running or approval-pending orchestrated workflow with a reason.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow instance identifier"
}
],
"tags": [
"workflow_orchestrator",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflow_orchestrator/templates",
"description": "Returns the names of all registered workflow templates available for instantiation.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"workflow_orchestrator",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflows",
"description": "Returns all workflow definitions stored in the workflow service.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"workflows",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflows",
"description": "Parses a YAML workflow definition and persists it to the workflow service.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [],
"tags": [
"workflows",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflows/:id",
"description": "Returns a single workflow definition by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow identifier"
}
],
"tags": [
"workflows",
"read"
],
"feature": ""
},
{
"method": "GET",
"path": "/api/v1/workflows/:id/audit",
"description": "Returns the full audit trail of state transitions for a workflow instance.",
"auth": "bearer",
"actors": [
"developer",
"ci",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow identifier"
}
],
"tags": [
"workflows",
"audit",
"read"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflows/:id/execute",
"description": "Triggers execution of a stored workflow by its identifier.",
"auth": "bearer",
"actors": [
"developer",
"agent",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow identifier"
}
],
"tags": [
"workflows",
"write"
],
"feature": ""
},
{
"method": "POST",
"path": "/api/v1/workflows/:id/rollback",
"description": "Rolls back a failed or partially executed workflow to its previous state.",
"auth": "bearer",
"actors": [
"developer",
"admin"
],
"params": [
{
"name": "id",
"kind": "string",
"constraint": "required",
"description": "Workflow identifier"
}
],
"tags": [
"workflows",
"write"
],
"feature": ""
},
{
"method": "GET",
"path": "/health",
"description": "Returns current server liveness status and build version.",
"auth": "none",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"health",
"system"
],
"feature": ""
},
{
"method": "GET",
"path": "/metrics",
"description": "Exposes Prometheus metrics for scraping in text/plain format.",
"auth": "none",
"actors": [
"developer",
"agent",
"ci",
"admin"
],
"params": [],
"tags": [
"metrics",
"observability"
],
"feature": ""
}
]
Reference in a new issue Copy permalink