{ "openapi": "3.1.0", "info": { "title": "Bakin API", "version": "0.0.0-dev", "description": "Generated from typed route contracts (defineRoute / defineCoreRoute) — same builder as /api/openapi." }, "servers": [ { "url": "http://localhost:3737", "description": "Local Bakin server" } ], "tags": [ { "name": "Assets" }, { "name": "Git" }, { "name": "Health" }, { "name": "Memory" }, { "name": "Models" }, { "name": "Schedule" }, { "name": "Tasks" }, { "name": "Team" }, { "name": "Workflows" }, { "name": "Core" } ], "paths": { "/api/plugins/assets/": { "get": { "operationId": "assets.get.root", "summary": "List assets", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "description": "List assets with optional filter parameters.", "x-bakin-full-path": "/api/plugins/assets/" }, "delete": { "operationId": "assets.delete.root", "summary": "Soft-delete an asset", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "x-bakin-full-path": "/api/plugins/assets/" } }, "/api/plugins/assets/upload": { "post": { "operationId": "assets.post.upload", "summary": "Upload asset files", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "string", "format": "binary" } } } }, "x-bakin-full-path": "/api/plugins/assets/upload" } }, "/api/plugins/assets/file": { "get": { "operationId": "assets.get.file", "summary": "Serve asset file", "responses": { "200": { "description": "Successful response.", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "description": "Streams an asset file by canonical filename for rendering.", "x-bakin-full-path": "/api/plugins/assets/file" } }, "/api/plugins/assets/link": { "patch": { "operationId": "assets.patch.link", "summary": "Relink or unlink an asset", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Assets" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/assets/link" } }, "/api/plugins/assets/retype": { "patch": { "operationId": "assets.patch.retype", "summary": "Change asset type classification", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Assets" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/assets/retype" } }, "/api/plugins/assets/content": { "put": { "operationId": "assets.put.content", "summary": "Update text content of an editable asset", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/assets/content" } }, "/api/plugins/assets/trash": { "get": { "operationId": "assets.get.trash", "summary": "List trashed assets", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "x-bakin-full-path": "/api/plugins/assets/trash" }, "delete": { "operationId": "assets.delete.trash", "summary": "Empty entire trash", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Assets" ], "x-bakin-full-path": "/api/plugins/assets/trash" } }, "/api/plugins/assets/trash/{file}/restore": { "post": { "operationId": "assets.post.trash-file-restore", "summary": "Restore a trashed asset", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "parameters": [ { "name": "file", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "x-bakin-full-path": "/api/plugins/assets/trash/:file/restore" } }, "/api/plugins/assets/trash/{file}": { "delete": { "operationId": "assets.delete.trash-file", "summary": "Permanently delete a trashed asset", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Assets" ], "parameters": [ { "name": "file", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "x-bakin-full-path": "/api/plugins/assets/trash/:file" } }, "/api/plugins/assets/search": { "get": { "operationId": "assets.get.search", "summary": "Search assets", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": {} }, "aggregations": {}, "meta": { "type": "object", "properties": { "query": { "type": "string" }, "total": { "type": "number" }, "took_ms": { "type": "number" }, "source": { "type": "string" } }, "required": [ "query", "total", "took_ms", "source" ], "additionalProperties": false } }, "required": [ "results" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Assets" ], "description": "Full-text search across assets indexed content.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 500 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, { "name": "facets", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/assets/search" } }, "/api/plugins/git/worktrees": { "get": { "operationId": "git.get.worktrees", "summary": "List tracked git worktrees", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Git" ], "parameters": [ { "name": "repoPath", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "taskId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "includeReleased", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false" ] } } ], "x-bakin-full-path": "/api/plugins/git/worktrees" } }, "/api/plugins/git/worktrees/prepare": { "post": { "operationId": "git.post.worktrees-prepare", "summary": "Create or reuse an isolated git worktree for a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Git" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "repoPath": { "type": "string", "minLength": 1 }, "taskId": { "type": "string", "minLength": 1 }, "branch": { "type": "string", "minLength": 1 }, "baseRef": { "default": "HEAD", "type": "string", "minLength": 1 }, "purpose": { "type": "string", "maxLength": 200 }, "agent": { "type": "string", "minLength": 1 } }, "required": [ "repoPath", "taskId", "baseRef" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/git/worktrees/prepare" } }, "/api/plugins/git/worktrees/release": { "post": { "operationId": "git.post.worktrees-release", "summary": "Release a tracked git worktree", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Git" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "worktreePath": { "type": "string", "minLength": 1 }, "repoPath": { "type": "string", "minLength": 1 }, "taskId": { "type": "string", "minLength": 1 }, "force": { "default": false, "type": "boolean" } }, "required": [ "force" ], "additionalProperties": false }, { "type": "object", "properties": { "agent": { "type": "string", "minLength": 1 } }, "additionalProperties": false } ] } } } }, "x-bakin-full-path": "/api/plugins/git/worktrees/release" } }, "/api/plugins/health/checks": { "get": { "operationId": "health.get.checks", "summary": "List registered plugin health checks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "pluginId": { "type": "string" }, "autoFix": { "type": "boolean" } }, "required": [ "id", "name", "autoFix" ], "additionalProperties": false } } }, "required": [ "checks" ], "additionalProperties": false } } } } }, "tags": [ "Health" ], "description": "Returns metadata only; does not execute the checks.", "x-bakin-full-path": "/api/plugins/health/checks" } }, "/api/plugins/health/summary": { "get": { "operationId": "health.get.summary", "summary": "Aggregated health summary", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "doctor": { "anyOf": [ {}, { "type": "null" } ] }, "errors1h": {}, "activeSessions": { "type": "array", "items": {} }, "upSince": { "type": "string" }, "server": { "type": "object", "properties": { "port": { "type": "number" }, "pid": { "type": "number" }, "nodeVersion": { "type": "string" }, "memoryMB": { "type": "number" }, "totalMemoryMB": { "type": "number" } }, "required": [ "port", "pid", "nodeVersion", "memoryMB", "totalMemoryMB" ], "additionalProperties": false } }, "required": [ "doctor", "errors1h", "activeSessions", "upSince", "server" ], "additionalProperties": false } } } } }, "tags": [ "Health" ], "description": "Snapshot of doctor cache, recent error counts, MCP sessions, and host process metrics.", "x-bakin-full-path": "/api/plugins/health/summary" } }, "/api/plugins/health/usage-feed": { "get": { "operationId": "health.get.usage-feed", "summary": "Unified usage feed", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Health" ], "description": "Backs the tabbed usage section on the health page. Filters by kind, time window, and agent.", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "mcp", "rest", "agent" ] } }, { "name": "window", "in": "query", "required": false, "schema": { "default": "1h", "type": "string", "enum": [ "5m", "1h", "24h" ] } }, { "name": "agent", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "x-bakin-full-path": "/api/plugins/health/usage-feed" } }, "/api/plugins/health/search-status": { "get": { "operationId": "health.get.search-status", "summary": "Search adapter health", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "tables": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "enabled", "tables" ], "additionalProperties": {} } } } } }, "tags": [ "Health" ], "description": "Returns search adapter readiness and per-table index stats.", "x-bakin-full-path": "/api/plugins/health/search-status" } }, "/api/plugins/health/usage": { "get": { "operationId": "health.get.usage", "summary": "Agent context/token usage", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } } } } }, "tags": [ "Health" ], "description": "Returns token + context usage per agent from runtime sessions.", "x-bakin-full-path": "/api/plugins/health/usage" } }, "/api/plugins/health/registry": { "get": { "operationId": "health.get.registry", "summary": "List registered plugins", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "plugins": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } } }, "required": [ "plugins" ], "additionalProperties": false } } } } }, "tags": [ "Health" ], "description": "Returns the plugin registry snapshot — installed plugin metadata and route counts.", "x-bakin-full-path": "/api/plugins/health/registry" } }, "/api/plugins/health/doctor": { "get": { "operationId": "health.get.doctor", "summary": "Run system diagnostics", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": {}, "additionalProperties": {} } }, "summary": { "type": "object", "properties": { "total": { "type": "number" }, "errors": { "type": "number" }, "warnings": { "type": "number" } }, "required": [ "total", "errors", "warnings" ], "additionalProperties": false }, "cachedAt": { "type": "string" } }, "required": [ "results", "summary" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Health" ], "description": "Returns cached doctor results by default; pass ?fresh=true to force a fresh run.", "parameters": [ { "name": "fresh", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "const": "true" }, { "type": "string", "const": "false" } ] } } ], "x-bakin-full-path": "/api/plugins/health/doctor" } }, "/api/plugins/memory/audit": { "get": { "operationId": "core.get.api-plugins-memory-audit", "summary": "List memory audit entries", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/plugins/memory/audit" } }, "/api/plugins/memory/durable": { "get": { "operationId": "memory.get.durable", "summary": "List canonical durable files", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false } } }, "required": [ "files" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List canonical durable files present for an agent", "x-bakin-full-path": "/api/plugins/memory/durable" } }, "/api/plugins/memory/durable/{agent}/{basename}": { "get": { "operationId": "memory.get.durable-agent-basename", "summary": "Read one durable file", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Read one canonical durable file for an agent", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "basename", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/durable/:agent/:basename" } }, "/api/plugins/memory/daily-notes": { "get": { "operationId": "memory.get.daily-notes", "summary": "List daily notes for an agent (sorted by date desc)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List daily notes for an agent (sorted by date desc)", "x-bakin-full-path": "/api/plugins/memory/daily-notes" } }, "/api/plugins/memory/daily-notes/{agent}/{filename}": { "get": { "operationId": "memory.get.daily-notes-agent-filename", "summary": "Read one daily note", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Read one daily note", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/daily-notes/:agent/:filename" } }, "/api/plugins/memory/daily-notes/compare-search": { "post": { "operationId": "memory.post.daily-notes-compare-search", "summary": "Run the same query against Bakin search and runtime memory search", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Run the same query against Bakin search and runtime memory search", "x-bakin-full-path": "/api/plugins/memory/daily-notes/compare-search" } }, "/api/plugins/memory/sessions": { "get": { "operationId": "memory.get.sessions", "summary": "List sessions for an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List sessions for an agent", "x-bakin-full-path": "/api/plugins/memory/sessions" } }, "/api/plugins/memory/sessions/{agent}/{sessionKey}": { "get": { "operationId": "memory.get.sessions-agent-session-key", "summary": "Read one session by key", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Read one session by key", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "sessionKey", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/sessions/:agent/:sessionKey" } }, "/api/plugins/memory/sessions/{agent}/{sessionKey}/turns": { "get": { "operationId": "memory.get.sessions-agent-session-key-turns", "summary": "List turns belonging to one session (indexed)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List turns belonging to one session (indexed)", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "sessionKey", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/sessions/:agent/:sessionKey/turns" } }, "/api/plugins/memory/turns": { "get": { "operationId": "memory.get.turns", "summary": "List turns by (agent, sessionId)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List turns by (agent, sessionId)", "x-bakin-full-path": "/api/plugins/memory/turns" } }, "/api/plugins/memory/checkpoints": { "get": { "operationId": "memory.get.checkpoints", "summary": "List compaction checkpoints for an agent (optionally by session)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List compaction checkpoints for an agent (optionally by session)", "x-bakin-full-path": "/api/plugins/memory/checkpoints" } }, "/api/plugins/memory/checkpoints/{agent}/{sessionId}/{checkpointId}": { "get": { "operationId": "memory.get.checkpoints-agent-session-id-checkpoint-id", "summary": "Read one checkpoint by (agent, sessionId, checkpointId)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Read one checkpoint by (agent, sessionId, checkpointId)", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "sessionId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "checkpointId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/checkpoints/:agent/:sessionId/:checkpointId" } }, "/api/plugins/memory/dreams": { "get": { "operationId": "memory.get.dreams", "summary": "List dream artifacts for an agent (optional phase/date/artifactType filters)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "List dream artifacts for an agent (optional phase/date/artifactType filters)", "x-bakin-full-path": "/api/plugins/memory/dreams" } }, "/api/plugins/memory/dreams/{agent}/{artifactType}": { "get": { "operationId": "memory.get.dreams-agent-artifact-type", "summary": "Read one dream artifact by (agent, artifactType[, phase, date])", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Read one dream artifact by (agent, artifactType[, phase, date])", "parameters": [ { "name": "agent", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "artifactType", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/dreams/:agent/:artifactType" } }, "/api/plugins/memory/status": { "get": { "operationId": "memory.get.status", "summary": "Indexer health: per-tier row counts + offset snapshot", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Indexer health: per-tier row counts + offset snapshot", "x-bakin-full-path": "/api/plugins/memory/status" } }, "/api/plugins/memory/recent": { "get": { "operationId": "memory.get.recent", "summary": "Recent memory items across tiers, sorted by updated_at desc", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Memory" ], "description": "Recent memory items across tiers, sorted by updated_at desc", "x-bakin-full-path": "/api/plugins/memory/recent" } }, "/api/plugins/models/available": { "get": { "operationId": "models.get.available", "summary": "List available models", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "description": "Returns the model catalog from the configured runtime adapter. Cached on disk; the response signals freshness.", "x-bakin-full-path": "/api/plugins/models/available" } }, "/api/plugins/models/refresh": { "post": { "operationId": "models.post.refresh", "summary": "Refresh model list (bypass cache)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "502": { "description": "Bad gateway.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Models" ], "description": "Forces a fresh fetch from the runtime adapter, bypassing both cache layers. Falls back to last-known-good cache on failure.", "x-bakin-full-path": "/api/plugins/models/refresh" } }, "/api/plugins/models/config": { "get": { "operationId": "models.get.config", "summary": "Get model config", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "x-bakin-full-path": "/api/plugins/models/config" }, "post": { "operationId": "models.post.config", "summary": "Update agent model config", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agentId": { "type": "string", "minLength": 1 }, "ownModel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subagentModel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "agentId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/models/config" } }, "/api/plugins/models/defaults": { "post": { "operationId": "models.post.defaults", "summary": "Update default models", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "defaultModel": { "type": "string" }, "defaultSubagentModel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fallbackModels": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/models/defaults" } }, "/api/plugins/models/aliases": { "get": { "operationId": "models.get.aliases", "summary": "List model aliases", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "x-bakin-full-path": "/api/plugins/models/aliases" }, "post": { "operationId": "models.post.aliases", "summary": "Add/delete/prepopulate model aliases", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "action": { "type": "string", "const": "add" }, "name": { "type": "string", "minLength": 1 }, "target": { "type": "string", "minLength": 1 } }, "required": [ "action", "name", "target" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "delete" }, "name": { "type": "string", "minLength": 1 } }, "required": [ "action", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "prepopulate" } }, "required": [ "action" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "aliases": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "aliases" ], "additionalProperties": false } ] } } } }, "x-bakin-full-path": "/api/plugins/models/aliases" } }, "/api/plugins/models/profiles": { "get": { "operationId": "models.get.profiles", "summary": "List task profiles", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "x-bakin-full-path": "/api/plugins/models/profiles" }, "put": { "operationId": "models.put.profiles", "summary": "Replace task profiles", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profiles": { "type": "array", "items": { "type": "object", "properties": { "taskType": { "type": "string", "minLength": 1 }, "recommendedModel": { "type": "string", "minLength": 1 }, "notes": { "type": "string" } }, "required": [ "taskType", "recommendedModel", "notes" ], "additionalProperties": false } } }, "required": [ "profiles" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/models/profiles" } }, "/api/plugins/models/runtime/status": { "get": { "operationId": "models.get.runtime-status", "summary": "Runtime config sync status", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Models" ], "description": "Reports whether the runtime config is out of sync with disk and needs a restart.", "x-bakin-full-path": "/api/plugins/models/runtime/status" } }, "/api/plugins/models/runtime/restart": { "post": { "operationId": "models.post.runtime-restart", "summary": "Restart the runtime", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Models" ], "x-bakin-full-path": "/api/plugins/models/runtime/restart" } }, "/api/plugins/schedule/": { "get": { "operationId": "schedule.get.root", "summary": "List all scheduled jobs", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "description": "Returns the merged runtime cron + Bakin sidecar view of all jobs.", "x-bakin-full-path": "/api/plugins/schedule/" }, "post": { "operationId": "schedule.post.root", "summary": "Create a scheduled job", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "schedule": { "type": "string", "minLength": 1 }, "agentId": { "type": "string" }, "workflowId": { "type": "string" }, "taskPrompt": { "type": "string" }, "taskTitle": { "type": "string" }, "owner": { "type": "string" }, "requireTriage": { "type": "boolean" }, "allowOverlap": { "type": "boolean" }, "maxFailures": { "type": "number" }, "tz": { "type": "string" } }, "required": [ "name", "schedule" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/schedule/" } }, "/api/plugins/schedule/{jobId}": { "put": { "operationId": "schedule.put.job-id", "summary": "Update a scheduled job", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId" }, "get": { "operationId": "schedule.get.job-id", "summary": "Get scheduled job details", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "x-bakin-full-path": "/api/plugins/schedule/:jobId" }, "delete": { "operationId": "schedule.delete.job-id", "summary": "Delete a scheduled job", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId" } }, "/api/plugins/schedule/{jobId}/adopt": { "post": { "operationId": "schedule.post.job-id-adopt", "summary": "Adopt a runtime cron job into Bakin task scheduling", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" }, "name": { "type": "string" }, "schedule": { "type": "string" }, "agentId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workflowId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "taskPrompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "taskTitle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requireTriage": { "type": "boolean" }, "allowOverlap": { "type": "boolean" }, "maxFailures": { "type": "number" }, "tz": { "type": "string" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId/adopt" } }, "/api/plugins/schedule/{jobId}/restore-native": { "post": { "operationId": "schedule.post.job-id-restore-native", "summary": "Restore an adopted Bakin schedule back to its native runtime cron behavior", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId/restore-native" } }, "/api/plugins/schedule/{jobId}/pause": { "post": { "operationId": "schedule.post.job-id-pause", "summary": "Pause/resume/skip a scheduled job", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" }, "action": { "type": "string", "enum": [ "pause", "resume", "skip" ] }, "pauseUntil": { "type": "string" }, "skipN": { "type": "number" } }, "required": [ "action" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId/pause" } }, "/api/plugins/schedule/{jobId}/run": { "post": { "operationId": "schedule.post.job-id-run", "summary": "Trigger immediate run", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugins/schedule/:jobId/run" } }, "/api/plugins/schedule/{jobId}/runs": { "get": { "operationId": "schedule.get.job-id-runs", "summary": "Get run history for a job", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "parameters": [ { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } } ], "x-bakin-full-path": "/api/plugins/schedule/:jobId/runs" } }, "/api/plugins/schedule/parse": { "post": { "operationId": "schedule.post.parse", "summary": "Parse a schedule expression", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "description": "Converts a natural-language or cron expression into structured schedule output.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string", "minLength": 1 } }, "required": [ "input" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/schedule/parse" } }, "/api/plugins/schedule/bridge": { "post": { "operationId": "schedule.post.bridge", "summary": "Cron bridge webhook", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "Unauthorized.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "503": { "description": "Service unavailable.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Schedule" ], "description": "Internal webhook the runtime cron POSTs to when a job fires. Auth via shared secret.", "parameters": [ { "name": "secret", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jobId": { "type": "string" }, "runId": { "type": "string" } }, "required": [ "jobId" ], "additionalProperties": {} } } } }, "x-bakin-visibility": "internal", "x-bakin-full-path": "/api/plugins/schedule/bridge" } }, "/api/plugins/schedule/search": { "get": { "operationId": "schedule.get.search", "summary": "Search schedule", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": {} }, "aggregations": {}, "meta": { "type": "object", "properties": { "query": { "type": "string" }, "total": { "type": "number" }, "took_ms": { "type": "number" }, "source": { "type": "string" } }, "required": [ "query", "total", "took_ms", "source" ], "additionalProperties": false } }, "required": [ "results" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Schedule" ], "description": "Full-text search across schedule indexed content.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 500 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, { "name": "facets", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/schedule/search" } }, "/api/plugins/tasks/": { "get": { "operationId": "tasks.get.root", "summary": "List all tasks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "description": "Returns the full kanban board state, grouped by column.", "x-bakin-full-path": "/api/plugins/tasks/" }, "post": { "operationId": "tasks.post.root", "summary": "Create a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "id": { "type": "string" }, "workflowId": { "type": "string" }, "suggestedWorkflow": { "type": "string" } }, "required": [ "ok", "id" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "description": "Creates a task on the kanban board. Auto-matches a workflow by title when workflowId is omitted.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string", "minLength": 1 }, "description": { "type": "string" }, "column": { "type": "string", "enum": [ "backlog", "todo", "inProgress", "review", "done", "blocked", "archived" ] }, "assignee": { "type": "string" }, "workflowId": { "type": "string" }, "skipWorkflowReason": { "type": "string" }, "createdBy": { "type": "string" }, "parentId": { "type": "string" }, "projectId": { "type": "string" } }, "required": [ "title" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/" } }, "/api/plugins/tasks/{taskId}": { "get": { "operationId": "tasks.get.task-id", "summary": "Get a task by ID", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/tasks/:taskId" }, "put": { "operationId": "tasks.put.task-id", "summary": "Update a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "originalTitle": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "agent": { "type": "string" }, "column": { "type": "string" }, "workflowId": { "type": "string" } }, "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId" }, "delete": { "operationId": "tasks.delete.task-id", "summary": "Delete a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "*/*": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" } }, "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId" } }, "/api/plugins/tasks/{taskId}/move": { "post": { "operationId": "tasks.post.task-id-move", "summary": "Move a task to a different column", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "agent": { "type": "string" }, "reason": { "type": "string" }, "channel": { "type": "string" } }, "required": [ "to", "agent" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/move" } }, "/api/plugins/tasks/{taskId}/assign": { "post": { "operationId": "tasks.post.task-id-assign", "summary": "Assign a task to an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "agent": { "type": "string" } }, "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/assign" } }, "/api/plugins/tasks/{taskId}/log": { "post": { "operationId": "tasks.post.task-id-log", "summary": "Add a log entry to a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "author": { "type": "string" }, "agent": { "type": "string" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "message" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/log" } }, "/api/plugins/tasks/{taskId}/block": { "post": { "operationId": "tasks.post.task-id-block", "summary": "Mark a task as blocked", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "agent": { "type": "string" }, "reason": { "type": "string", "minLength": 1 } }, "required": [ "reason" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/block" } }, "/api/plugins/tasks/{taskId}/dependency": { "post": { "operationId": "tasks.post.task-id-dependency", "summary": "Set a dependency between tasks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "dependsOn": { "type": "string", "minLength": 1 } }, "required": [ "dependsOn" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/dependency" } }, "/api/plugins/tasks/reorder": { "post": { "operationId": "tasks.post.reorder", "summary": "Reorder tasks within a column", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "columnId": { "type": "string", "minLength": 1 }, "orderedIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "columnId", "orderedIds" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/reorder" } }, "/api/plugins/tasks/{taskId}/complete": { "post": { "operationId": "tasks.post.task-id-complete", "summary": "Mark a task as complete", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "agent": { "type": "string" }, "summary": { "type": "string" } }, "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/tasks/:taskId/complete" } }, "/api/plugins/tasks/search": { "get": { "operationId": "tasks.get.search", "summary": "Search tasks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": {} }, "aggregations": {}, "meta": { "type": "object", "properties": { "query": { "type": "string" }, "total": { "type": "number" }, "took_ms": { "type": "number" }, "source": { "type": "string" } }, "required": [ "query", "total", "took_ms", "source" ], "additionalProperties": false } }, "required": [ "results" ], "additionalProperties": false } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Tasks" ], "description": "Full-text search across tasks (title, description, log entries, blocked reasons).", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "exclusiveMinimum": 0, "maximum": 500 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, { "name": "facets", "in": "query", "required": false, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/tasks/search" } }, "/api/plugins/team/": { "get": { "operationId": "team.get.root", "summary": "List all agents with runtime status", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List all agents with runtime status", "x-bakin-full-path": "/api/plugins/team/" }, "post": { "operationId": "team.post.root", "summary": "Create a new agent in the active runtime", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Create a new agent in the active runtime", "x-bakin-full-path": "/api/plugins/team/" } }, "/api/plugins/team/{agentId}": { "delete": { "operationId": "team.delete.agent-id", "summary": "Remove an agent from the active runtime and move workspace to trash", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Remove an agent from the active runtime and move workspace to trash", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId" }, "get": { "operationId": "team.get.agent-id", "summary": "Get full agent profile merged from runtime state", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Get full agent profile merged from runtime state", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId" } }, "/api/plugins/team/{agentId}/identity": { "put": { "operationId": "team.put.agent-id-identity", "summary": "Update agent identity fields and persona files", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Update agent identity fields and persona files", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/identity" } }, "/api/plugins/team/{agentId}/permissions": { "put": { "operationId": "team.put.agent-id-permissions", "summary": "Update agent dispatch permissions (subagents.allowAgents)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Update agent dispatch permissions (subagents.allowAgents)", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/permissions" } }, "/api/plugins/team/{agentId}/avatar": { "post": { "operationId": "team.post.agent-id-avatar", "summary": "Upload agent avatar image", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Upload agent avatar image", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/avatar" }, "get": { "operationId": "team.get.agent-id-avatar", "summary": "Serve agent avatar image", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Serve agent avatar image", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/avatar" } }, "/api/plugins/team/{agentId}/files": { "get": { "operationId": "team.get.agent-id-files", "summary": "List workspace files for an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List workspace files for an agent", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/files" } }, "/api/plugins/team/{agentId}/files/{filename}": { "get": { "operationId": "team.get.agent-id-files-filename", "summary": "Read a specific workspace file", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Read a specific workspace file", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/files/:filename" }, "put": { "operationId": "team.put.agent-id-files-filename", "summary": "Write a workspace file through the active runtime", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Write a workspace file through the active runtime", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filename", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/files/:filename" } }, "/api/plugins/team/{agentId}/skills": { "get": { "operationId": "team.get.agent-id-skills", "summary": "List installed skills for an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List installed skills for an agent", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/skills" } }, "/api/plugins/team/{agentId}/skills/{skillId}": { "get": { "operationId": "team.get.agent-id-skills-skill-id", "summary": "Read SKILL.md for a specific skill", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Read SKILL.md for a specific skill", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "skillId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/skills/:skillId" } }, "/api/plugins/team/{agentId}/memory": { "get": { "operationId": "team.get.agent-id-memory", "summary": "List memory files for an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List memory files for an agent", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/memory" } }, "/api/plugins/team/{agentId}/memory/{date}": { "get": { "operationId": "team.get.agent-id-memory-date", "summary": "Read a specific memory file", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Read a specific memory file", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "date", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/memory/:date" } }, "/api/plugins/team/{agentId}/stats": { "get": { "operationId": "team.get.agent-id-stats", "summary": "Get token usage and cost stats for an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Get token usage and cost stats for an agent", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/stats" } }, "/api/plugins/team/{agentId}/heartbeat": { "get": { "operationId": "team.get.agent-id-heartbeat", "summary": "Read the agent heartbeat narrative", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Read the agent HEARTBEAT.md narrative + file mtime", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/heartbeat" } }, "/api/plugins/team/{agentId}/active-context": { "get": { "operationId": "team.get.agent-id-active-context", "summary": "Read the most recent session JSONL parsed into a message stream", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Read the most recent session JSONL parsed into a message stream", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/active-context" } }, "/api/plugins/team/{agentId}/recent-activity": { "get": { "operationId": "team.get.agent-id-recent-activity", "summary": "Per-agent dispatch + error counts across 5m / 1h / 24h windows (resets on server restart)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Per-agent dispatch + error counts across 5m / 1h / 24h windows (resets on server restart)", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/recent-activity" } }, "/api/plugins/team/{agentId}/start": { "post": { "operationId": "team.post.agent-id-start", "summary": "Start an agent via the active runtime", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Start an agent via the active runtime", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/start" } }, "/api/plugins/team/{agentId}/stop": { "post": { "operationId": "team.post.agent-id-stop", "summary": "Stop an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Stop an agent", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/stop" } }, "/api/plugins/team/settings": { "get": { "operationId": "team.get.settings", "summary": "Get agent display settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Get agent display settings", "x-bakin-full-path": "/api/plugins/team/settings" }, "put": { "operationId": "team.put.settings", "summary": "Update agent display settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Update agent display settings", "x-bakin-full-path": "/api/plugins/team/settings" } }, "/api/plugins/team/teams": { "get": { "operationId": "team.get.teams", "summary": "List organizational teams", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List organizational teams", "x-bakin-full-path": "/api/plugins/team/teams" }, "post": { "operationId": "team.post.teams", "summary": "Create an organizational team", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Create an organizational team", "x-bakin-full-path": "/api/plugins/team/teams" } }, "/api/plugins/team/teams/{teamId}": { "put": { "operationId": "team.put.teams-team-id", "summary": "Update an organizational team", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Update an organizational team", "parameters": [ { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/teams/:teamId" }, "delete": { "operationId": "team.delete.teams-team-id", "summary": "Delete an organizational team", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Delete an organizational team", "parameters": [ { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/teams/:teamId" } }, "/api/plugins/team/teams/{teamId}/members": { "get": { "operationId": "team.get.teams-team-id-members", "summary": "List agents belonging to a team", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "List agents belonging to a team", "parameters": [ { "name": "teamId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/teams/:teamId/members" } }, "/api/plugins/team/{agentId}/team": { "put": { "operationId": "team.put.agent-id-team", "summary": "Assign an agent to an organizational team", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Team" ], "description": "Assign an agent to an organizational team", "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/team/:agentId/team" } }, "/api/plugins/workflows/notification-channels": { "get": { "operationId": "workflows.get.notification-channels", "summary": "List registered notification channels", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "List registered notification channels", "x-bakin-full-path": "/api/plugins/workflows/notification-channels" } }, "/api/plugins/workflows/definitions": { "get": { "operationId": "workflows.get.definitions", "summary": "List all workflow templates with step counts and resolved sub-workflows", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "List all workflow templates with step counts and resolved sub-workflows", "x-bakin-full-path": "/api/plugins/workflows/definitions" }, "post": { "operationId": "workflows.post.definitions", "summary": "Create a new user-owned workflow definition", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Create a new user-owned workflow definition", "x-bakin-full-path": "/api/plugins/workflows/definitions" } }, "/api/plugins/workflows/definitions/{name}": { "get": { "operationId": "workflows.get.definitions-name", "summary": "Get a specific workflow definition by name", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Get a specific workflow definition by name", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/definitions/:name" }, "put": { "operationId": "workflows.put.definitions-name", "summary": "Update or shadow a workflow definition (writes user YAML)", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Update or shadow a workflow definition (writes user YAML)", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/definitions/:name" }, "delete": { "operationId": "workflows.delete.definitions-name", "summary": "Delete a user-owned workflow definition", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Delete a user-owned workflow definition", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/definitions/:name" } }, "/api/plugins/workflows/node-types": { "get": { "operationId": "workflows.get.node-types", "summary": "List registered workflow node types (builtin + plugin-registered) for the canvas palette", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "List registered workflow node types (builtin + plugin-registered) for the canvas palette", "x-bakin-full-path": "/api/plugins/workflows/node-types" } }, "/api/plugins/workflows/steps/{taskId}": { "get": { "operationId": "workflows.get.steps-task-id", "summary": "Get current workflow step for a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Get current workflow step for a task", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/steps/:taskId" } }, "/api/plugins/workflows/steps/{taskId}/complete": { "post": { "operationId": "workflows.post.steps-task-id-complete", "summary": "Submit step output, validates against schema, advances workflow", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Submit step output, validates against schema, advances workflow", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/steps/:taskId/complete" } }, "/api/plugins/workflows/gates/{taskId}/approve": { "post": { "operationId": "workflows.post.gates-task-id-approve", "summary": "Approve a human gate step", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Approve a human gate step", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/gates/:taskId/approve" } }, "/api/plugins/workflows/gates/{taskId}/reject": { "post": { "operationId": "workflows.post.gates-task-id-reject", "summary": "Reject a gate step, rewinds workflow", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Reject a gate step, rewinds workflow", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/gates/:taskId/reject" } }, "/api/plugins/workflows/gates/{taskId}/decision": { "get": { "operationId": "workflows.get.gates-task-id-decision", "summary": "Render a durable Bakin gate approval fallback page", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Render a durable Bakin gate approval fallback page", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/gates/:taskId/decision" }, "post": { "operationId": "workflows.post.gates-task-id-decision", "summary": "Approve or reject a gate through the durable Bakin approval fallback page", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Approve or reject a gate through the durable Bakin approval fallback page", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/gates/:taskId/decision" } }, "/api/plugins/workflows/instances": { "get": { "operationId": "workflows.get.instances", "summary": "List active workflow instances. Optional status filter.", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "List active workflow instances. Optional status filter.", "x-bakin-full-path": "/api/plugins/workflows/instances" } }, "/api/plugins/workflows/instances/{taskId}": { "get": { "operationId": "workflows.get.instances-task-id", "summary": "Get full workflow instance state for a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Get full workflow instance state for a task", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/workflows/instances/:taskId" } }, "/api/plugins/workflows/gates/pending": { "get": { "operationId": "workflows.get.gates-pending", "summary": "List all gates awaiting approval", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "List all gates awaiting approval", "x-bakin-full-path": "/api/plugins/workflows/gates/pending" } }, "/api/plugins/workflows/gates/status": { "get": { "operationId": "workflows.get.gates-status", "summary": "Batch check gate status for tasks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Batch check gate status for tasks", "x-bakin-full-path": "/api/plugins/workflows/gates/status" } }, "/api/plugins/workflows/instances/start": { "post": { "operationId": "workflows.post.instances-start", "summary": "Start a workflow instance for a task", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "201": { "description": "Created.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "403": { "description": "Forbidden.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Workflows" ], "description": "Start a workflow instance for a task", "x-bakin-full-path": "/api/plugins/workflows/instances/start" } }, "/api/agents": { "get": { "operationId": "core.get.api-agents", "summary": "List agents", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Lists all agents with status and active tasks.", "x-bakin-full-path": "/api/agents" } }, "/api/agents/avatar": { "get": { "operationId": "core.get.api-agents-avatar", "summary": "Get agent avatar", "responses": { "200": { "description": "Successful response.", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Serves an agent avatar image.", "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/agents/avatar" } }, "/api/agents/health": { "get": { "operationId": "core.get.api-agents-health", "summary": "List agent health status", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns enriched heartbeat and staleness data for agents.", "x-bakin-full-path": "/api/agents/health" } }, "/api/agents/settings": { "get": { "operationId": "core.get.api-agents-settings", "summary": "Get agent settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns host display and behavior settings for agents.", "x-bakin-full-path": "/api/agents/settings" }, "put": { "operationId": "core.put.api-agents-settings", "summary": "Update agent settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "description": "Updates host display and behavior settings for agents.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/agents/settings" } }, "/api/agents/start": { "post": { "operationId": "core.post.api-agents-start", "summary": "Start an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agentId": { "type": "string" } }, "required": [ "agentId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agents/start" } }, "/api/agents/stop": { "post": { "operationId": "core.post.api-agents-stop", "summary": "Stop an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agentId": { "type": "string" } }, "required": [ "agentId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agents/stop" } }, "/api/agents/restart": { "post": { "operationId": "core.post.api-agents-restart", "summary": "Restart an agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agentId": { "type": "string" } }, "required": [ "agentId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agents/restart" } }, "/api/agents/{id}": { "get": { "operationId": "core.get.api-agents-id", "summary": "Get agent status", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/agents/:id" } }, "/api/agents/{id}/status": { "get": { "operationId": "core.get.api-agents-id-status", "summary": "Get detailed agent status", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/agents/:id/status" } }, "/api/agents/{id}/message": { "post": { "operationId": "core.post.api-agents-id-message", "summary": "Send message to agent", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agents/:id/message" } }, "/api/agents/{id}/tasks": { "get": { "operationId": "core.get.api-agents-id-tasks", "summary": "Get agent tasks", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/agents/:id/tasks" } }, "/api/dispatch": { "get": { "operationId": "core.get.api-dispatch", "summary": "Get dispatch timer state", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns interval, last run, next run, and dispatched count.", "x-bakin-full-path": "/api/dispatch" }, "post": { "operationId": "core.post.api-dispatch", "summary": "Trigger dispatch", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Triggers an immediate task dispatch cycle.", "x-bakin-full-path": "/api/dispatch" } }, "/api/settings": { "get": { "operationId": "core.get.api-settings", "summary": "Get settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns current Bakin settings.", "x-bakin-full-path": "/api/settings" }, "post": { "operationId": "core.post.api-settings", "summary": "Update settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "description": "Updates Bakin settings with a partial merge.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/settings" } }, "/api/agent-packages": { "get": { "operationId": "core.get.api-agent-packages", "summary": "List agent packages", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/agent-packages" } }, "/api/agent-packages/install": { "post": { "operationId": "core.post.api-agent-packages-install", "summary": "Install agent package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string" }, "adopt": { "type": "boolean" }, "installAs": { "type": "string" } }, "required": [ "source" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agent-packages/install" } }, "/api/agent-packages/{agentId}": { "delete": { "operationId": "core.delete.api-agent-packages-agent-id", "summary": "Remove agent package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keepBlocks": { "type": "boolean" }, "deleteAgent": { "type": "boolean" }, "force": { "type": "boolean" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/agent-packages/:agentId" } }, "/api/agent-packages/{agentId}/update": { "post": { "operationId": "core.post.api-agent-packages-agent-id-update", "summary": "Update agent package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "refreshTemplate": { "type": "boolean" } }, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/agent-packages/:agentId/update" } }, "/api/agent-packages/{agentId}/lessons": { "get": { "operationId": "core.get.api-agent-packages-agent-id-lessons", "summary": "List agent package lessons", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/agent-packages/:agentId/lessons" } }, "/api/agent-packages/{agentId}/lessons/{lessonId}": { "post": { "operationId": "core.post.api-agent-packages-agent-id-lessons-lesson-id", "summary": "Toggle agent package lessons", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "lessonId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/agent-packages/:agentId/lessons/:lessonId" } }, "/api/packages": { "get": { "operationId": "core.get.api-packages", "summary": "List reusable packages", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/packages" } }, "/api/packages/install": { "post": { "operationId": "core.post.api-packages-install", "summary": "Install reusable package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string" } }, "required": [ "source" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/packages/install" } }, "/api/packages/{packageId}": { "delete": { "operationId": "core.delete.api-packages-package-id", "summary": "Remove reusable package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "packageId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/packages/:packageId" } }, "/api/packages/{packageId}/update": { "post": { "operationId": "core.post.api-packages-package-id-update", "summary": "Update reusable package", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "packageId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/packages/:packageId/update" } }, "/api/curated": { "get": { "operationId": "core.get.api-curated", "summary": "List curated installable packages", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/curated" } }, "/api/plugin-settings/schemas": { "get": { "operationId": "core.get.api-plugin-settings-schemas", "summary": "List plugin settings schemas", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/plugin-settings/schemas" } }, "/api/plugin-settings/{pluginId}": { "get": { "operationId": "core.get.api-plugin-settings-plugin-id", "summary": "Get plugin settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "pluginId", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugin-settings/:pluginId" }, "put": { "operationId": "core.put.api-plugin-settings-plugin-id", "summary": "Update plugin settings", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "pluginId", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/plugin-settings/:pluginId" } }, "/api/plugins/install": { "post": { "operationId": "core.post.api-plugins-install", "summary": "Install plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "source": { "type": "string" }, "type": { "type": "string", "enum": [ "local", "github" ] } }, "required": [ "source", "type" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/install" } }, "/api/plugins/link": { "post": { "operationId": "core.post.api-plugins-link", "summary": "Link local plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localPath": { "type": "string" }, "force": { "type": "boolean" } }, "required": [ "localPath" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/link" } }, "/api/plugins/manifest": { "get": { "operationId": "core.get.api-plugins-manifest", "summary": "Get plugin manifest bundle", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/plugins/manifest" } }, "/api/plugins/{pluginId}/assets/{path}": { "get": { "operationId": "core.get.api-plugins-plugin-id-assets-path", "summary": "Serve plugin client asset", "responses": { "200": { "description": "Successful response.", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "pluginId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/:pluginId/assets/:path" } }, "/api/plugins/memory/workspace": { "get": { "operationId": "core.get.api-plugins-memory-workspace", "summary": "Get memory workspace bundle", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "agentId", "in": "query", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/plugins/memory/workspace" } }, "/api/plugins/remove": { "post": { "operationId": "core.post.api-plugins-remove", "summary": "Remove plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pluginId": { "type": "string" } }, "required": [ "pluginId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/remove" } }, "/api/plugins/restore": { "post": { "operationId": "core.post.api-plugins-restore", "summary": "Restore plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "409": { "description": "Conflict.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pluginId": { "type": "string" }, "snapshot": { "type": "string" }, "force": { "type": "boolean" }, "listOnly": { "type": "boolean" } }, "required": [ "pluginId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/restore" } }, "/api/plugins/unlink": { "post": { "operationId": "core.post.api-plugins-unlink", "summary": "Unlink local plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pluginId": { "type": "string" } }, "required": [ "pluginId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/unlink" } }, "/api/plugins/upgrade": { "post": { "operationId": "core.post.api-plugins-upgrade", "summary": "Upgrade plugin", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pluginId": { "type": "string" } }, "required": [ "pluginId" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/plugins/upgrade" } }, "/api/version": { "get": { "operationId": "core.get.api-version", "summary": "Get runtime version", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "string" } }, "required": [ "version" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "description": "Returns the running Bakin version.", "x-bakin-full-path": "/api/version" } }, "/api/paths": { "get": { "operationId": "core.get.api-paths", "summary": "Get resolved runtime paths", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns important local filesystem paths used by the runtime.", "x-bakin-full-path": "/api/paths" } }, "/api/state": { "get": { "operationId": "core.get.api-state", "summary": "Get dashboard state snapshot", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/state" } }, "/api/search": { "get": { "operationId": "core.get.api-search", "summary": "Search indexed content", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Searches across indexed content through the search adapter.", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "table", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } } ], "x-bakin-full-path": "/api/search" } }, "/api/reindex": { "post": { "operationId": "core.post.api-reindex", "summary": "Trigger reindex", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "x-bakin-full-path": "/api/reindex" } }, "/api/activity": { "get": { "operationId": "core.get.api-activity", "summary": "List activity feed events", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns unified activity data from audit events and task logs.", "x-bakin-full-path": "/api/activity" } }, "/api/activity/emit": { "post": { "operationId": "core.post.api-activity-emit", "summary": "Emit activity event", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agent": { "type": "string" }, "message": { "type": "string" }, "ts": { "type": "string" } }, "required": [ "agent", "message", "ts" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/activity/emit" } }, "/api/internal/continuation": { "post": { "operationId": "core.post.api-internal-continuation", "summary": "Trigger continuation check", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "completedTaskId": { "type": "string" }, "completedTitle": { "type": "string" } }, "required": [ "completedTaskId", "completedTitle" ], "additionalProperties": false } } } }, "x-bakin-visibility": "internal", "x-bakin-full-path": "/api/internal/continuation" } }, "/api/exec-tools/{toolName}": { "post": { "operationId": "core.post.api-exec-tools-tool-name", "summary": "Run an exec tool", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "500": { "description": "Server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "toolName", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } }, "x-bakin-full-path": "/api/exec-tools/:toolName" } }, "/api/memory/log": { "post": { "operationId": "core.post.api-memory-log", "summary": "Append memory log entry", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "decision", "learned", "note" ] }, "message": { "type": "string" } }, "required": [ "type", "message" ], "additionalProperties": false } } } }, "x-bakin-full-path": "/api/memory/log" } }, "/api/assets/{path}": { "get": { "operationId": "core.get.api-assets-path", "summary": "Serve asset file", "responses": { "200": { "description": "Successful response.", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "Not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": {} } } } } }, "tags": [ "Core" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "x-bakin-full-path": "/api/assets/:path" } }, "/api/docs": { "get": { "operationId": "core.get.api-docs", "summary": "Get API documentation", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Legacy endpoint — returns route metadata in the {routes} shape for CLI consumers.", "x-bakin-full-path": "/api/docs" } }, "/api/openapi": { "get": { "operationId": "core.get.api-openapi", "summary": "Get live OpenAPI document", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": {} } } } } }, "tags": [ "Core" ], "description": "Returns the OpenAPI 3.1 document built from the runtime route registry.", "x-bakin-full-path": "/api/openapi" } }, "/api/events": { "get": { "operationId": "core.get.api-events", "summary": "SSE event stream", "responses": { "200": { "description": "Successful response.", "content": { "text/event-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "Core" ], "description": "Real-time updates for file changes, task events, alerts.", "x-bakin-full-path": "/api/events" } }, "/api/dev/events": { "get": { "operationId": "core.get.api-dev-events", "summary": "Dev SSE event stream", "responses": { "200": { "description": "Successful response.", "content": { "text/event-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "Core" ], "description": "Development-only browser reload and notification event stream.", "x-bakin-visibility": "internal", "x-bakin-full-path": "/api/dev/events" } }, "/api/dev/notify": { "post": { "operationId": "core.post.api-dev-notify", "summary": "Emit development notification", "responses": { "200": { "description": "Successful response.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": {} } } } }, "400": { "description": "Invalid input — params, query, or body did not match the declared schema.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } }, "415": { "description": "Unsupported Media Type — body content type does not match the declared content type.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "issues": { "type": "array", "items": {} } }, "required": [ "error" ], "additionalProperties": false } } } } }, "tags": [ "Core" ], "description": "Development-only watcher bridge for browser rebuild notifications.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string" }, "payload": {} }, "required": [ "type", "payload" ], "additionalProperties": false } } } }, "x-bakin-visibility": "internal", "x-bakin-full-path": "/api/dev/notify" } } }, "components": { "securitySchemes": { "pluginPermissions": { "type": "apiKey", "in": "header", "name": "X-Bakin-Plugin-Permission", "description": "Documents plugin permission requirements." } } } }