{"openapi":"3.1.0","info":{"title":"Nodal Universal Capability Layer API","version":"2.0.0","description":"Universal discovery, installation, connectivity, routing, and execution infrastructure for AI agent capabilities. ONE INTEGRATION. EVERY CAPABILITY.","contact":{"name":"Nodal Support","url":"https://nodal.sonnev.com","email":"support@sonnev.com"},"license":{"name":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://nodal.sonnev.com/api/v1","description":"Production API Server"},{"url":"http://localhost:3000/api/v1","description":"Local Development Server"}],"paths":{"/capabilities":{"get":{"summary":"Search and List Capabilities","description":"Filter and search the universal registry across skills, MCP servers, APIs, and workflows.","operationId":"listCapabilities","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search query"},{"name":"type","in":"query","schema":{"type":"string"},"description":"Capability type filter"},{"name":"provider","in":"query","schema":{"type":"string"},"description":"Provider filter"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category filter"}],"responses":{"200":{"description":"Array of capabilities with structured metadata"}}}},"/capabilities/{slug}":{"get":{"summary":"Inspect Capability","description":"Retrieve complete schema, source provenance, dependencies, and install instructions.","operationId":"inspectCapability","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full capability detail record"},"404":{"description":"Capability not found"}}}},"/resolve":{"post":{"summary":"Resolve Task to Execution Plan","description":"Decomposes a complex prompt into an ordered DAG with dependency sorting and permission checks.","operationId":"resolveTask","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task":{"type":"string"}},"required":["task"]}}}},"responses":{"200":{"description":"Resolved execution plan"}}}},"/runs":{"post":{"summary":"Create Execution Run","description":"Submits a capability or workflow execution run to the runtime engine.","operationId":"createRun","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task":{"type":"string"},"autoExecute":{"type":"boolean","default":true}},"required":["task"]}}}},"responses":{"201":{"description":"Execution run created"}}}},"/runs/{id}":{"get":{"summary":"Get Execution Run","description":"Checks real-time status, completed steps, and approval state.","operationId":"getRun","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Execution run details"},"404":{"description":"Run not found"}}}},"/runs/{id}/approval":{"post":{"summary":"Submit Human Approval","description":"Approves or rejects a paused step. Prohibits automated agents from approving their own operations.","operationId":"submitApproval","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"approvalId":{"type":"string"},"decision":{"type":"string","enum":["approved","rejected"]},"approverIdentity":{"type":"string"}},"required":["approvalId","decision","approverIdentity"]}}}},"responses":{"200":{"description":"Approval processed and execution resumed"},"403":{"description":"Agent self-approval prohibited"}}}},"/tools":{"get":{"summary":"Search and List Legacy AI Tools","description":"Retrieve a paginated list of AI tools with keyword and category filtering.","operationId":"listTools","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":24}}],"responses":{"200":{"description":"Paginated list of AI tools"}}}}}}