{ "manifestVersion": 1, "contractVersion": "v1", "schemaVersion": 1, "launchState": "live", "manifestUrl": "/agent-public-contracts/v1/knowledge-manifest.json", "source": { "repository": "NeotaskInc/neotask-site", "commit": "a3c2f7b7002f5772145865a42e9d29573fc59f9c", "operationRegistryVersion": 3, "contentSha256": "c0fc17a5e81f93218746c8c488f96e1c690f34d280d6df2ab7406a31f0babe18" }, "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities", "operations": [ { "operationId": "listAgentCompanies", "method": "GET", "path": "/api/agent/v1/companies", "routePath": "/companies", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List authorized companies", "description": "List authorized companies after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCompanies.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-companies.md" } }, "markdownUrl": "/docs/api/list-agent-companies.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_companies_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCompany", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}", "routePath": "/companies/:companyRef", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a company overview", "description": "Read a company overview after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCompany.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-company.md" } }, "markdownUrl": "/docs/api/get-agent-company.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_companies_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies get --company-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentCompanyAgents", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}/agents", "routePath": "/companies/:companyRef/agents", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List configured company agents", "description": "List configured company agents after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCompanyAgents.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-company-agents.md" } }, "markdownUrl": "/docs/api/list-agent-company-agents.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_company_agents_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies agents --company-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentCompanyTasks", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}/tasks", "routePath": "/companies/:companyRef/tasks", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List company tasks", "description": "List company tasks after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCompanyTasks.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-company-tasks.md" } }, "markdownUrl": "/docs/api/list-agent-company-tasks.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_company_tasks_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies tasks --company-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCompanyTask", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}/tasks/{taskRef}", "routePath": "/companies/:companyRef/tasks/:taskRef", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a company task", "description": "Read a company task after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCompanyTask.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-company-task.md" } }, "markdownUrl": "/docs/api/get-agent-company-task.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_company_tasks_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies task --company-ref --task-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentCompanyRuns", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}/runs", "routePath": "/companies/:companyRef/runs", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List company runs", "description": "List company runs after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCompanyRuns.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-company-runs.md" } }, "markdownUrl": "/docs/api/list-agent-company-runs.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_company_runs_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies runs --company-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCompanyRun", "method": "GET", "path": "/api/agent/v1/companies/{companyRef}/runs/{runRef}", "routePath": "/companies/:companyRef/runs/:runRef", "requiredScope": "neotask:companies:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "company_plan", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a company run", "description": "Read a company run after claim, plan and current company-access checks.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCompanyRun.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-company-run.md" } }, "markdownUrl": "/docs/api/get-agent-company-run.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_company_runs_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api companies run --company-ref --run-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listInsightBoards", "method": "GET", "path": "/api/agent/v1/boards", "routePath": "/boards", "requiredScope": "neotask:boards:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List saved boards in the verified company boundary.", "description": "List saved boards in the verified company boundary.", "requestSchemaRef": null, "responseSchemaRef": "listInsightBoards.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-insight-boards.md" } }, "markdownUrl": "/docs/api/list-insight-boards.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getInsightBoard", "method": "GET", "path": "/api/agent/v1/boards/{boardId}", "routePath": "/boards/:boardId", "requiredScope": "neotask:boards:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read one saved board in the verified company boundary.", "description": "Read one saved board in the verified company boundary.", "requestSchemaRef": null, "responseSchemaRef": "getInsightBoard.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-insight-board.md" } }, "markdownUrl": "/docs/api/get-insight-board.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards get --board-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getInsightBoardPublication", "method": "GET", "path": "/api/agent/v1/boards/{boardId}/publication", "routePath": "/boards/:boardId/publication", "requiredScope": "neotask:boards:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read hosted publication state without a link secret.", "description": "Read hosted publication state without a link secret.", "requestSchemaRef": null, "responseSchemaRef": "getInsightBoardPublication.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-insight-board-publication.md" } }, "markdownUrl": "/docs/api/get-insight-board-publication.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_publication_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards publication get --board-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "publishInsightBoard", "method": "POST", "path": "/api/agent/v1/boards/{boardId}/publish", "routePath": "/boards/:boardId/publish", "requiredScope": "neotask:boards:publish", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "account", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Publish a saved version; public links require an exact human approval.", "description": "Publish a saved version; public links require an exact human approval.", "requestSchemaRef": "publishInsightBoard.request.v1", "responseSchemaRef": "publishInsightBoard.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/publish-insight-board.md" } }, "markdownUrl": "/docs/api/publish-insight-board.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_publish", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards publish --board-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "unpublishInsightBoard", "method": "POST", "path": "/api/agent/v1/boards/{boardId}/unpublish", "routePath": "/boards/:boardId/unpublish", "requiredScope": "neotask:boards:publish", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Unpublish the hosted board and revoke its active links.", "description": "Unpublish the hosted board and revoke its active links.", "requestSchemaRef": "unpublishInsightBoard.request.v1", "responseSchemaRef": "unpublishInsightBoard.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/unpublish-insight-board.md" } }, "markdownUrl": "/docs/api/unpublish-insight-board.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_unpublish", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards unpublish --board-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "rotateInsightBoardLink", "method": "POST", "path": "/api/agent/v1/boards/{boardId}/rotate-link", "routePath": "/boards/:boardId/rotate-link", "requiredScope": "neotask:boards:publish", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Rotate the hosted link; the new secret is returned once.", "description": "Rotate the hosted link; the new secret is returned once.", "requestSchemaRef": "rotateInsightBoardLink.request.v1", "responseSchemaRef": "rotateInsightBoardLink.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/rotate-insight-board-link.md" } }, "markdownUrl": "/docs/api/rotate-insight-board-link.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_link_rotate", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards link rotate --board-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "setInsightBoardVisibility", "method": "PUT", "path": "/api/agent/v1/boards/{boardId}/visibility", "routePath": "/boards/:boardId/visibility", "requiredScope": "neotask:boards:share", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Change visibility; public access requires an exact human approval.", "description": "Change visibility; public access requires an exact human approval.", "requestSchemaRef": "setInsightBoardVisibility.request.v1", "responseSchemaRef": "setInsightBoardVisibility.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/set-insight-board-visibility.md" } }, "markdownUrl": "/docs/api/set-insight-board-visibility.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_visibility_set", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards visibility set --board-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listInsightBoardGrants", "method": "GET", "path": "/api/agent/v1/boards/{boardId}/grants", "routePath": "/boards/:boardId/grants", "requiredScope": "neotask:boards:share", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List viewer-only grants for one board.", "description": "List viewer-only grants for one board.", "requestSchemaRef": null, "responseSchemaRef": "listInsightBoardGrants.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-insight-board-grants.md" } }, "markdownUrl": "/docs/api/list-insight-board-grants.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_grants_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards grants list --board-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createInsightBoardGrant", "method": "POST", "path": "/api/agent/v1/boards/{boardId}/grants", "routePath": "/boards/:boardId/grants", "requiredScope": "neotask:boards:share", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create one viewer-only grant subject to publication caps.", "description": "Create one viewer-only grant subject to publication caps.", "requestSchemaRef": "createInsightBoardGrant.request.v1", "responseSchemaRef": "createInsightBoardGrant.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-insight-board-grant.md" } }, "markdownUrl": "/docs/api/create-insight-board-grant.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_grants_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards grants create --board-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeInsightBoardGrant", "method": "DELETE", "path": "/api/agent/v1/boards/{boardId}/grants/{grantId}", "routePath": "/boards/:boardId/grants/:grantId", "requiredScope": "neotask:boards:share", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Revoke one grant so the next viewer request is denied.", "description": "Revoke one grant so the next viewer request is denied.", "requestSchemaRef": "revokeInsightBoardGrant.request.v1", "responseSchemaRef": "revokeInsightBoardGrant.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-insight-board-grant.md" } }, "markdownUrl": "/docs/api/revoke-insight-board-grant.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_boards_grants_revoke", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api boards grants revoke --board-id --grant-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentProfile", "method": "GET", "path": "/api/agent/v1/me", "routePath": "/me", "requiredScope": "neotask:profile:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read the current agent identity and account", "description": "Returns the verified principal and its ordinary account snapshot.", "requestSchemaRef": null, "responseSchemaRef": "getAgentProfile.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-profile.md" } }, "markdownUrl": "/docs/api/get-agent-profile.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api profile get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCapabilities", "method": "GET", "path": "/api/agent/v1/capabilities", "routePath": "/capabilities", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "onboarding", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read current plan limits and effective operation access", "description": "Returns the server-derived capabilities and effective-access records.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCapabilities.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-capabilities.md" } }, "markdownUrl": "/docs/api/get-agent-capabilities.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_capabilities", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api capabilities get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentOnboarding", "method": "GET", "path": "/api/agent/v1/onboarding", "routePath": "/onboarding", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "agent_onboarding_read", "domain": "onboarding", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read the ordered agent onboarding journey", "description": "Returns a server-derived onboarding snapshot with bounded resource summaries, effective next actions, and current blockers.", "requestSchemaRef": null, "responseSchemaRef": "getAgentOnboarding.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-onboarding.md" } }, "markdownUrl": "/docs/api/get-agent-onboarding.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_onboarding", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api onboarding get --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgents", "method": "GET", "path": "/api/agent/v1/agents", "routePath": "/agents", "requiredScope": "neotask:agents:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List agents in the current account", "description": "Lists only agents in the tenant derived from the verified credential.", "requestSchemaRef": null, "responseSchemaRef": "listAgents.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agents.md" } }, "markdownUrl": "/docs/api/list-agents.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents list", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgent", "method": "POST", "path": "/api/agent/v1/agents", "routePath": "/agents", "requiredScope": "neotask:agents:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Create an agent in the current account", "description": "Creates a tenant-scoped agent after ordinary plan and policy checks.", "requestSchemaRef": "createAgent.request.v1", "responseSchemaRef": "createAgent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent.md" } }, "markdownUrl": "/docs/api/create-agent.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgent", "method": "GET", "path": "/api/agent/v1/agents/{agentRef}", "routePath": "/agents/:agentRef", "requiredScope": "neotask:agents:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read one managed agent", "description": "Returns one managed agent owned by the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getAgent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent.md" } }, "markdownUrl": "/docs/api/get-agent.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents get --agent-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "updateAgent", "method": "PATCH", "path": "/api/agent/v1/agents/{agentRef}", "routePath": "/agents/:agentRef", "requiredScope": "neotask:agents:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Update one managed agent", "description": "Updates editable managed-agent metadata after authority and scope checks.", "requestSchemaRef": "updateAgent.request.v1", "responseSchemaRef": "updateAgent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-agent.md" } }, "markdownUrl": "/docs/api/update-agent.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_update", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents update --agent-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "archiveAgent", "method": "POST", "path": "/api/agent/v1/agents/{agentRef}/archive", "routePath": "/agents/:agentRef/archive", "requiredScope": "neotask:agents:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Archive a managed agent", "description": "Archives a managed agent while retaining its durable history for restoration.", "requestSchemaRef": "archiveAgent.request.v1", "responseSchemaRef": "archiveAgent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/archive-agent.md" } }, "markdownUrl": "/docs/api/archive-agent.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_archive", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents archive --agent-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "restoreAgent", "method": "POST", "path": "/api/agent/v1/agents/{agentRef}/restore", "routePath": "/agents/:agentRef/restore", "requiredScope": "neotask:agents:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Restore a managed agent", "description": "Restores an archived managed agent after authority and scope checks.", "requestSchemaRef": "restoreAgent.request.v1", "responseSchemaRef": "restoreAgent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/restore-agent.md" } }, "markdownUrl": "/docs/api/restore-agent.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agents_restore", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents restore --agent-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentEffectiveTools", "method": "GET", "path": "/api/agent/v1/agents/{agentRef}/tools", "routePath": "/agents/:agentRef/tools", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read effective tools for an agent", "description": "Returns MCP permissions. Pass runRef to read complete prepared-tool availability for one owned selected-agent run.", "requestSchemaRef": null, "responseSchemaRef": "getAgentEffectiveTools.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-effective-tools.md" } }, "markdownUrl": "/docs/api/get-agent-effective-tools.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agent_tools_effective", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask tools effective --agent-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentToolPolicy", "method": "GET", "path": "/api/agent/v1/agents/{agentRef}/tool-policy", "routePath": "/agents/:agentRef/tool-policy", "requiredScope": "neotask:agents:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read an agent tool policy", "description": "Returns the MCP policy, runtime tool restrictions, and their shared revision for a managed agent.", "requestSchemaRef": null, "responseSchemaRef": "getAgentToolPolicy.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-tool-policy.md" } }, "markdownUrl": "/docs/api/get-agent-tool-policy.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agent_tool_policy_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents tool-policy get --agent-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "updateAgentToolPolicy", "method": "PATCH", "path": "/api/agent/v1/agents/{agentRef}/tool-policy", "routePath": "/agents/:agentRef/tool-policy", "requiredScope": "neotask:agents:configure", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Update an agent tool policy", "description": "Narrows MCP or runtime tool restrictions with revision-checked writes. An agent cannot widen either policy.", "requestSchemaRef": "updateAgentToolPolicy.request.v1", "responseSchemaRef": "updateAgentToolPolicy.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-agent-tool-policy.md" } }, "markdownUrl": "/docs/api/update-agent-tool-policy.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agent_tool_policy_update", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api agents tool-policy update --agent-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentConversations", "method": "GET", "path": "/api/agent/v1/conversations", "routePath": "/conversations", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List agent conversations", "description": "Lists conversations owned by the verified tenant with bounded pagination.", "requestSchemaRef": null, "responseSchemaRef": "listAgentConversations.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-conversations.md" } }, "markdownUrl": "/docs/api/list-agent-conversations.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentConversation", "method": "POST", "path": "/api/agent/v1/conversations", "routePath": "/conversations", "requiredScope": "neotask:conversations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Create an agent conversation", "description": "Creates a durable conversation backed by the existing tenant session store.", "requestSchemaRef": "createAgentConversation.request.v1", "responseSchemaRef": "createAgentConversation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-conversation.md" } }, "markdownUrl": "/docs/api/create-agent-conversation.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations create --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentConversation", "method": "GET", "path": "/api/agent/v1/conversations/{conversationRef}", "routePath": "/conversations/:conversationRef", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read an agent conversation", "description": "Returns one conversation metadata record in the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getAgentConversation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-conversation.md" } }, "markdownUrl": "/docs/api/get-agent-conversation.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations get --conversation-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "archiveAgentConversation", "method": "POST", "path": "/api/agent/v1/conversations/{conversationRef}/archive", "routePath": "/conversations/:conversationRef/archive", "requiredScope": "neotask:conversations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Archive an agent conversation", "description": "Archives a conversation while preserving its messages and audit history.", "requestSchemaRef": "archiveAgentConversation.request.v1", "responseSchemaRef": "archiveAgentConversation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/archive-agent-conversation.md" } }, "markdownUrl": "/docs/api/archive-agent-conversation.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_archive", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations archive --conversation-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "restoreAgentConversation", "method": "POST", "path": "/api/agent/v1/conversations/{conversationRef}/restore", "routePath": "/conversations/:conversationRef/restore", "requiredScope": "neotask:conversations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Restore an agent conversation", "description": "Restores an archived conversation in the verified tenant.", "requestSchemaRef": "restoreAgentConversation.request.v1", "responseSchemaRef": "restoreAgentConversation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/restore-agent-conversation.md" } }, "markdownUrl": "/docs/api/restore-agent-conversation.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_restore", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations restore --conversation-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentConversationMessages", "method": "GET", "path": "/api/agent/v1/conversations/{conversationRef}/messages", "routePath": "/conversations/:conversationRef/messages", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List conversation messages", "description": "Returns ordered messages from the canonical tenant message store.", "requestSchemaRef": null, "responseSchemaRef": "listAgentConversationMessages.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-conversation-messages.md" } }, "markdownUrl": "/docs/api/list-agent-conversation-messages.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_messages", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api conversations messages --conversation-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentConversationTurn", "method": "POST", "path": "/api/agent/v1/conversations/{conversationRef}/turns", "routePath": "/conversations/:conversationRef/turns", "requiredScope": "neotask:conversations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "run_execution", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "runner_not_enrolled", "summary": "Create a conversation turn", "description": "Creates a durable turn and queues its run through the trusted runner dispatch.", "requestSchemaRef": "createAgentConversationTurn.request.v1", "responseSchemaRef": "createAgentConversationTurn.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-conversation-turn.md" } }, "markdownUrl": "/docs/api/create-agent-conversation-turn.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_turn_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api turns create --conversation-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentConversationTurn", "method": "GET", "path": "/api/agent/v1/conversations/{conversationRef}/turns/{turnRef}", "routePath": "/conversations/:conversationRef/turns/:turnRef", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read a conversation turn", "description": "Returns one durable conversation turn and its current execution state.", "requestSchemaRef": null, "responseSchemaRef": "getAgentConversationTurn.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-conversation-turn.md" } }, "markdownUrl": "/docs/api/get-agent-conversation-turn.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_turn_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api turns get --conversation-ref --turn-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentConversationTurn", "method": "POST", "path": "/api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/cancel", "routePath": "/conversations/:conversationRef/turns/:turnRef/cancel", "requiredScope": "neotask:conversations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Cancel a conversation turn", "description": "Records a durable cancel request for an active conversation turn.", "requestSchemaRef": "cancelAgentConversationTurn.request.v1", "responseSchemaRef": "cancelAgentConversationTurn.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-conversation-turn.md" } }, "markdownUrl": "/docs/api/cancel-agent-conversation-turn.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_conversations_turn_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api turns cancel --conversation-ref --turn-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentConversationTurnEvents", "method": "GET", "path": "/api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/events", "routePath": "/conversations/:conversationRef/turns/:turnRef/events", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Recover conversation turn events", "description": "Returns ordered events for one tenant-scoped conversation turn after an opaque cursor.", "requestSchemaRef": null, "responseSchemaRef": "listAgentConversationTurnEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.conversations.{conversationRef}.turns.{turnRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-conversation-turn-events.md" } }, "markdownUrl": "/docs/api/list-agent-conversation-turn-events.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": "neotask://agent/v1/conversations/{conversationRef}/turns/{turnRef}/events", "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api turns events --conversation-ref --turn-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "streamAgentConversationTurnEvents", "method": "GET", "path": "/api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/events/stream", "routePath": "/conversations/:conversationRef/turns/:turnRef/events/stream", "requiredScope": "neotask:conversations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Stream conversation turn events", "description": "Returns a finite SSE replay for one conversation turn and closes after the current event page.", "requestSchemaRef": null, "responseSchemaRef": "streamAgentConversationTurnEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.conversations.{conversationRef}.turns.{turnRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/stream-agent-conversation-turn-events.md" } }, "markdownUrl": "/docs/api/stream-agent-conversation-turn-events.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask chat watch --conversation-ref --turn-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listTasks", "method": "GET", "path": "/api/agent/v1/tasks", "routePath": "/tasks", "requiredScope": "neotask:tasks:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List tasks in the current account", "description": "Lists tenant-scoped tasks with optional agent filtering.", "requestSchemaRef": null, "responseSchemaRef": "listTasks.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-tasks.md" } }, "markdownUrl": "/docs/api/list-tasks.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_tasks_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api tasks list", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createTask", "method": "POST", "path": "/api/agent/v1/tasks", "routePath": "/tasks", "requiredScope": "neotask:tasks:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "task_flow", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Create a task in the current account", "description": "Creates a tenant-scoped task after ordinary plan and policy checks.", "requestSchemaRef": "createTask.request.v1", "responseSchemaRef": "createTask.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-task.md" } }, "markdownUrl": "/docs/api/create-task.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_tasks_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api tasks create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentCronJobs", "method": "GET", "path": "/api/agent/v1/automations/cron", "routePath": "/automations/cron", "requiredScope": "neotask:cron:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List cron schedules", "description": "Lists cron schedules owned by the verified claimed tenant.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCronJobs.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-cron-jobs.md" } }, "markdownUrl": "/docs/api/list-agent-cron-jobs.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentCronJob", "method": "POST", "path": "/api/agent/v1/automations/cron", "routePath": "/automations/cron", "requiredScope": "neotask:cron:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create a cron schedule", "description": "Creates a tenant-scoped cron schedule for an existing task.", "requestSchemaRef": "createAgentCronJob.request.v1", "responseSchemaRef": "createAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-cron-job.md" } }, "markdownUrl": "/docs/api/create-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron create --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCronJob", "method": "GET", "path": "/api/agent/v1/automations/cron/{cronJobRef}", "routePath": "/automations/cron/:cronJobRef", "requiredScope": "neotask:cron:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a cron schedule", "description": "Reads one cron schedule scoped to the verified claimed tenant.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-cron-job.md" } }, "markdownUrl": "/docs/api/get-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron get --cron-job-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "updateAgentCronJob", "method": "PATCH", "path": "/api/agent/v1/automations/cron/{cronJobRef}", "routePath": "/automations/cron/:cronJobRef", "requiredScope": "neotask:cron:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Update a cron schedule", "description": "Updates the name, expression, timezone, or enabled state of a tenant-scoped schedule.", "requestSchemaRef": "updateAgentCronJob.request.v1", "responseSchemaRef": "updateAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-agent-cron-job.md" } }, "markdownUrl": "/docs/api/update-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_update", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron update --cron-job-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "enableAgentCronJob", "method": "POST", "path": "/api/agent/v1/automations/cron/{cronJobRef}/enable", "routePath": "/automations/cron/:cronJobRef/enable", "requiredScope": "neotask:cron:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Enable a cron schedule", "description": "Enables an existing tenant-scoped cron schedule.", "requestSchemaRef": "enableAgentCronJob.request.v1", "responseSchemaRef": "enableAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/enable-agent-cron-job.md" } }, "markdownUrl": "/docs/api/enable-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_enable", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron enable --cron-job-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "disableAgentCronJob", "method": "POST", "path": "/api/agent/v1/automations/cron/{cronJobRef}/disable", "routePath": "/automations/cron/:cronJobRef/disable", "requiredScope": "neotask:cron:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Disable a cron schedule", "description": "Disables an existing tenant-scoped cron schedule without deleting its run history.", "requestSchemaRef": "disableAgentCronJob.request.v1", "responseSchemaRef": "disableAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/disable-agent-cron-job.md" } }, "markdownUrl": "/docs/api/disable-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_disable", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron disable --cron-job-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "runAgentCronJob", "method": "POST", "path": "/api/agent/v1/automations/cron/{cronJobRef}/runs", "routePath": "/automations/cron/:cronJobRef/runs", "requiredScope": "neotask:cron:run", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "run_execution", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Run a cron schedule now", "description": "Queues one schedule-attributed run through the existing trusted runner outbox.", "requestSchemaRef": "runAgentCronJob.request.v1", "responseSchemaRef": "runAgentCronJob.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/run-agent-cron-job.md" } }, "markdownUrl": "/docs/api/run-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_run", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron run --cron-job-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentCronJobRuns", "method": "GET", "path": "/api/agent/v1/automations/cron/{cronJobRef}/runs", "routePath": "/automations/cron/:cronJobRef/runs", "requiredScope": "neotask:cron:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List cron run history", "description": "Lists durable schedule-attributed runs for one tenant-scoped cron schedule.", "requestSchemaRef": null, "responseSchemaRef": "listAgentCronJobRuns.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-cron-job-runs.md" } }, "markdownUrl": "/docs/api/list-agent-cron-job-runs.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_history", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron history --cron-job-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "deleteAgentCronJob", "method": "DELETE", "path": "/api/agent/v1/automations/cron/{cronJobRef}", "routePath": "/automations/cron/:cronJobRef", "requiredScope": "neotask:cron:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cron", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Delete a cron schedule", "description": "Deletes a tenant-scoped cron schedule and detaches its task schedule fields.", "requestSchemaRef": "deleteAgentCronJob.request.v1", "responseSchemaRef": "deleteAgentCronJob.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/delete-agent-cron-job.md" } }, "markdownUrl": "/docs/api/delete-agent-cron-job.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_cron_delete", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask cron delete --cron-job-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentAutomationCatalog", "method": "GET", "path": "/api/agent/v1/automations/flows/catalog", "routePath": "/automations/flows/catalog", "requiredScope": "neotask:automations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List supported Task Flow kinds", "description": "Returns the bounded Task Flow and automation kinds supported by the claimed account.", "requestSchemaRef": null, "responseSchemaRef": "listAgentAutomationCatalog.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-automation-catalog.md" } }, "markdownUrl": "/docs/api/list-agent-automation-catalog.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_catalog", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations catalog", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentAutomations", "method": "GET", "path": "/api/agent/v1/automations/flows", "routePath": "/automations/flows", "requiredScope": "neotask:automations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List Task Flows and automations", "description": "Lists tenant-scoped Task Flows and automations after the verified claim and scope checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentAutomations.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-automations.md" } }, "markdownUrl": "/docs/api/list-agent-automations.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations list", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentAutomation", "method": "POST", "path": "/api/agent/v1/automations/flows", "routePath": "/automations/flows", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create a Task Flow or automation", "description": "Creates a bounded tenant-scoped automation definition and persists its Task Flow descriptor.", "requestSchemaRef": "createAgentAutomation.request.v1", "responseSchemaRef": "createAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-automation.md" } }, "markdownUrl": "/docs/api/create-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentAutomation", "method": "GET", "path": "/api/agent/v1/automations/flows/{automationRef}", "routePath": "/automations/flows/:automationRef", "requiredScope": "neotask:automations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read one Task Flow or automation", "description": "Returns one tenant-scoped automation definition and its latest run projection.", "requestSchemaRef": null, "responseSchemaRef": "getAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-automation.md" } }, "markdownUrl": "/docs/api/get-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "updateAgentAutomation", "method": "PATCH", "path": "/api/agent/v1/automations/flows/{automationRef}", "routePath": "/automations/flows/:automationRef", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Update a Task Flow or automation", "description": "Updates a bounded automation definition with optimistic revision fencing.", "requestSchemaRef": "updateAgentAutomation.request.v1", "responseSchemaRef": "updateAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-agent-automation.md" } }, "markdownUrl": "/docs/api/update-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_update", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations update", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "deleteAgentAutomation", "method": "DELETE", "path": "/api/agent/v1/automations/flows/{automationRef}", "routePath": "/automations/flows/:automationRef", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Archive a Task Flow or automation", "description": "Archives an automation while retaining its durable task and run history.", "requestSchemaRef": "deleteAgentAutomation.request.v1", "responseSchemaRef": "deleteAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/delete-agent-automation.md" } }, "markdownUrl": "/docs/api/delete-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_delete", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations delete", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "startAgentAutomation", "method": "POST", "path": "/api/agent/v1/automations/flows/{automationRef}/start", "routePath": "/automations/flows/:automationRef/start", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "run_execution", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Start a Task Flow or automation", "description": "Queues one active automation through the trusted Site runner outbox using the exact Task Flow descriptor.", "requestSchemaRef": "startAgentAutomation.request.v1", "responseSchemaRef": "startAgentAutomation.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/start-agent-automation.md" } }, "markdownUrl": "/docs/api/start-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_start", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations start", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentAutomationStatus", "method": "GET", "path": "/api/agent/v1/automations/flows/{automationRef}/status", "routePath": "/automations/flows/:automationRef/status", "requiredScope": "neotask:automations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read Task Flow status", "description": "Returns the current automation state and latest durable run.", "requestSchemaRef": null, "responseSchemaRef": "getAgentAutomationStatus.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-automation-status.md" } }, "markdownUrl": "/docs/api/get-agent-automation-status.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations status", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "pauseAgentAutomation", "method": "POST", "path": "/api/agent/v1/automations/flows/{automationRef}/pause", "routePath": "/automations/flows/:automationRef/pause", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Pause a Task Flow or automation", "description": "Pauses an automation with optimistic revision fencing.", "requestSchemaRef": "pauseAgentAutomation.request.v1", "responseSchemaRef": "pauseAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/pause-agent-automation.md" } }, "markdownUrl": "/docs/api/pause-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_pause", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations pause", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "resumeAgentAutomation", "method": "POST", "path": "/api/agent/v1/automations/flows/{automationRef}/resume", "routePath": "/automations/flows/:automationRef/resume", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Resume a Task Flow or automation", "description": "Resumes a paused automation with optimistic revision fencing.", "requestSchemaRef": "resumeAgentAutomation.request.v1", "responseSchemaRef": "resumeAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/resume-agent-automation.md" } }, "markdownUrl": "/docs/api/resume-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_resume", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations resume", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentAutomation", "method": "POST", "path": "/api/agent/v1/automations/flows/{automationRef}/cancel", "routePath": "/automations/flows/:automationRef/cancel", "requiredScope": "neotask:automations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel an active automation run", "description": "Cancels the current non-terminal run through the Site-owned tenant and principal fence.", "requestSchemaRef": "cancelAgentAutomation.request.v1", "responseSchemaRef": "cancelAgentAutomation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-automation.md" } }, "markdownUrl": "/docs/api/cancel-agent-automation.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations cancel", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentAutomationRuns", "method": "GET", "path": "/api/agent/v1/automations/flows/{automationRef}/runs", "routePath": "/automations/flows/:automationRef/runs", "requiredScope": "neotask:automations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "automation", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List Task Flow run history", "description": "Lists durable runs attributed to one tenant-scoped automation.", "requestSchemaRef": null, "responseSchemaRef": "listAgentAutomationRuns.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-automation-runs.md" } }, "markdownUrl": "/docs/api/list-agent-automation-runs.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_automations_history", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask automations history", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getRun", "method": "GET", "path": "/api/agent/v1/runs/{runId}", "routePath": "/runs/:runId", "requiredScope": "neotask:runs:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read an asynchronous run", "description": "Reads one run after tenant and task ownership checks.", "requestSchemaRef": null, "responseSchemaRef": "getRun.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-run.md" } }, "markdownUrl": "/docs/api/get-run.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_runs_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api runs get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createRun", "method": "POST", "path": "/api/agent/v1/runs", "routePath": "/runs", "requiredScope": "neotask:runs:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "run_execution", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "runner_not_enrolled", "summary": "Start an asynchronous task run", "description": "Starts work only after the trusted Site-to-Gateway executor is ready.", "requestSchemaRef": "createRun.request.v1", "responseSchemaRef": "createRun.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-run.md" } }, "markdownUrl": "/docs/api/create-run.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_runs_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api runs create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentRunEvents", "method": "GET", "path": "/api/agent/v1/runs/{runRef}/events", "routePath": "/runs/:runRef/events", "requiredScope": "neotask:runs:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Recover run events", "description": "Returns ordered lifecycle events for one standalone-agent run after an opaque cursor.", "requestSchemaRef": null, "responseSchemaRef": "listAgentRunEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-run-events.md" } }, "markdownUrl": "/docs/api/list-agent-run-events.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": "neotask://agent/v1/runs/{runRef}/events", "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api runs events --run-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "streamAgentRunEvents", "method": "GET", "path": "/api/agent/v1/runs/{runRef}/events/stream", "routePath": "/runs/:runRef/events/stream", "requiredScope": "neotask:runs:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "chat", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Stream run events", "description": "Returns a finite SSE replay for one standalone-agent run and closes after the current event page.", "requestSchemaRef": null, "responseSchemaRef": "streamAgentRunEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/stream-agent-run-events.md" } }, "markdownUrl": "/docs/api/stream-agent-run-events.md", "includedIn": [ "/docs/chat/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api runs watch --run-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentAutonomyGoals", "method": "GET", "path": "/api/agent/v1/autonomy/goals", "routePath": "/autonomy/goals", "requiredScope": "neotask:autonomy:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List autonomy goals", "description": "Lists company autonomy goals after the verified claim and ordinary company-plan checks.", "requestSchemaRef": null, "responseSchemaRef": "listAgentAutonomyGoals.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-autonomy-goals.md" } }, "markdownUrl": "/docs/api/list-agent-autonomy-goals.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals list", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals", "routePath": "/autonomy/goals", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create an autonomy goal", "description": "Creates a company-scoped autonomy goal after the verified claim, plan, and idempotency checks.", "requestSchemaRef": "createAgentAutonomyGoal.request.v1", "responseSchemaRef": "createAgentAutonomyGoal.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/create-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentAutonomyGoal", "method": "GET", "path": "/api/agent/v1/autonomy/goals/{goalRef}", "routePath": "/autonomy/goals/:goalRef", "requiredScope": "neotask:autonomy:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read an autonomy goal", "description": "Returns one company-scoped autonomy goal for the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getAgentAutonomyGoal.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/get-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "updateAgentAutonomyGoal", "method": "PATCH", "path": "/api/agent/v1/autonomy/goals/{goalRef}", "routePath": "/autonomy/goals/:goalRef", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Update an autonomy goal", "description": "Updates editable fields on a company-scoped autonomy goal with optimistic state checks.", "requestSchemaRef": "updateAgentAutonomyGoal.request.v1", "responseSchemaRef": "updateAgentAutonomyGoal.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/update-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_update", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals update", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "startAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals/{goalRef}/start", "routePath": "/autonomy/goals/:goalRef/start", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_runtime", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Start an autonomy goal", "description": "Starts one autonomy goal through the trusted runner when a concrete runtime owner is ready.", "requestSchemaRef": "startAgentAutonomyGoal.request.v1", "responseSchemaRef": "startAgentAutonomyGoal.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/start-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/start-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_start", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals start", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentAutonomyGoalStatus", "method": "GET", "path": "/api/agent/v1/autonomy/goals/{goalRef}/status", "routePath": "/autonomy/goals/:goalRef/status", "requiredScope": "neotask:autonomy:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read autonomy goal status", "description": "Returns the goal state, task plan summary, and current run state for the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getAgentAutonomyGoalStatus.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-autonomy-goal-status.md" } }, "markdownUrl": "/docs/api/get-agent-autonomy-goal-status.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals status", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "steerAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals/{goalRef}/steer", "routePath": "/autonomy/goals/:goalRef/steer", "requiredScope": "neotask:autonomy:steer", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_runtime", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Steer an autonomy goal", "description": "Sends a bounded instruction to an active goal through the trusted runner control owner.", "requestSchemaRef": "steerAgentAutonomyGoal.request.v1", "responseSchemaRef": "steerAgentAutonomyGoal.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/steer-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/steer-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_steer", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals steer", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "pauseAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals/{goalRef}/pause", "routePath": "/autonomy/goals/:goalRef/pause", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Pause an autonomy goal", "description": "Pauses a goal at a durable Site checkpoint after the verified plan and claim checks.", "requestSchemaRef": "pauseAgentAutonomyGoal.request.v1", "responseSchemaRef": "pauseAgentAutonomyGoal.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/pause-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/pause-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_pause", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals pause", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "resumeAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals/{goalRef}/resume", "routePath": "/autonomy/goals/:goalRef/resume", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Resume an autonomy goal", "description": "Resumes a paused goal from its latest durable Site checkpoint.", "requestSchemaRef": "resumeAgentAutonomyGoal.request.v1", "responseSchemaRef": "resumeAgentAutonomyGoal.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/resume-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/resume-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_resume", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals resume", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentAutonomyGoal", "method": "POST", "path": "/api/agent/v1/autonomy/goals/{goalRef}/cancel", "routePath": "/autonomy/goals/:goalRef/cancel", "requiredScope": "neotask:autonomy:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_runtime", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel an autonomy goal", "description": "Cancels a goal and its active run through the trusted runner control owner.", "requestSchemaRef": "cancelAgentAutonomyGoal.request.v1", "responseSchemaRef": "cancelAgentAutonomyGoal.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-autonomy-goal.md" } }, "markdownUrl": "/docs/api/cancel-agent-autonomy-goal.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals cancel", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentAutonomyGoalRuns", "method": "GET", "path": "/api/agent/v1/autonomy/goals/{goalRef}/runs", "routePath": "/autonomy/goals/:goalRef/runs", "requiredScope": "neotask:autonomy:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "autonomy_plan", "domain": "autonomy", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List autonomy goal runs", "description": "Lists durable runs associated with one company-scoped autonomy goal.", "requestSchemaRef": null, "responseSchemaRef": "listAgentAutonomyGoalRuns.response.v1", "eventChannelRefs": [ "neotask.agent.v1.runs.{runRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-autonomy-goal-runs.md" } }, "markdownUrl": "/docs/api/list-agent-autonomy-goal-runs.md", "includedIn": [ "/docs/automations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_autonomy_goals_history", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask autonomy goals history", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentApprovals", "method": "GET", "path": "/api/agent/v1/approvals", "routePath": "/approvals", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List agent approvals", "description": "Lists tenant-scoped approval requests visible to the verified agent principal.", "requestSchemaRef": null, "responseSchemaRef": "listAgentApprovals.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-approvals.md" } }, "markdownUrl": "/docs/api/list-agent-approvals.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals list", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentApproval", "method": "GET", "path": "/api/agent/v1/approvals/{approvalRef}", "routePath": "/approvals/:approvalRef", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read an agent approval", "description": "Reads one tenant-scoped approval request with credential-shaped values redacted.", "requestSchemaRef": null, "responseSchemaRef": "getAgentApproval.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-approval.md" } }, "markdownUrl": "/docs/api/get-agent-approval.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentApprovalHandoff", "method": "POST", "path": "/api/agent/v1/approvals/{approvalRef}/human-handoffs", "routePath": "/approvals/:approvalRef/human-handoffs", "requiredScope": "neotask:approvals:handoff", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "relay_only", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create a human approval handoff", "description": "Creates a short-lived hashed opaque relay URL for a human to review one pending approval; it carries no decision authority.", "requestSchemaRef": "createAgentApprovalHandoff.request.v1", "responseSchemaRef": "createAgentApprovalHandoff.response.v1", "eventChannelRefs": [ "neotask.agent.v1.approvals.{approvalRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-approval-handoff.md" } }, "markdownUrl": "/docs/api/create-agent-approval-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_handoff_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals handoff", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentApprovalHandoff", "method": "GET", "path": "/api/agent/v1/approvals/{approvalRef}/human-handoffs/{handoffRef}", "routePath": "/approvals/:approvalRef/human-handoffs/:handoffRef", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a human approval handoff", "description": "Reads a tenant- and principal-bound approval handoff with the current durable approval state.", "requestSchemaRef": null, "responseSchemaRef": "getAgentApprovalHandoff.response.v1", "eventChannelRefs": [ "neotask.agent.v1.approvals.{approvalRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-approval-handoff.md" } }, "markdownUrl": "/docs/api/get-agent-approval-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_handoff_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals wait", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentApprovalHandoff", "method": "POST", "path": "/api/agent/v1/approvals/{approvalRef}/human-handoffs/{handoffRef}/cancel", "routePath": "/approvals/:approvalRef/human-handoffs/:handoffRef/cancel", "requiredScope": "neotask:approvals:handoff", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel a human approval handoff", "description": "Cancels a pending approval handoff without changing the underlying approval request.", "requestSchemaRef": "cancelAgentApprovalHandoff.request.v1", "responseSchemaRef": "cancelAgentApprovalHandoff.response.v1", "eventChannelRefs": [ "neotask.agent.v1.approvals.{approvalRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-approval-handoff.md" } }, "markdownUrl": "/docs/api/cancel-agent-approval-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_handoff_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals cancel", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentApprovalEvents", "method": "GET", "path": "/api/agent/v1/approvals/{approvalRef}/events", "routePath": "/approvals/:approvalRef/events", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List approval events", "description": "Lists ordered approval events from durable approval truth with an opaque after-exclusive replay cursor.", "requestSchemaRef": null, "responseSchemaRef": "listAgentApprovalEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.approvals.{approvalRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-approval-events.md" } }, "markdownUrl": "/docs/api/list-agent-approval-events.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": "neotask://agent/v1/approvals/{approvalRef}/events", "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals events", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "streamAgentApprovalEvents", "method": "GET", "path": "/api/agent/v1/approvals/{approvalRef}/events/stream", "routePath": "/approvals/:approvalRef/events/stream", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Stream approval events", "description": "Streams ordered approval events over SSE; reconnect with Last-Event-ID or the JSON recovery route in the same cursor namespace.", "requestSchemaRef": null, "responseSchemaRef": "streamAgentApprovalEvents.response.v1", "eventChannelRefs": [ "neotask.agent.v1.approvals.{approvalRef}.events" ], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "implemented", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/stream-agent-approval-events.md" } }, "markdownUrl": "/docs/api/stream-agent-approval-events.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals wait --stream", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getEffectiveAgentApprovalPolicy", "method": "GET", "path": "/api/agent/v1/agents/{agentRef}/approval-policy", "routePath": "/agents/:agentRef/approval-policy", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read effective approval policy", "description": "Returns the tenant default, per-agent override, exact deterministic rules, revisions, and immutable human-only hard gates.", "requestSchemaRef": null, "responseSchemaRef": "getEffectiveAgentApprovalPolicy.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-effective-agent-approval-policy.md" } }, "markdownUrl": "/docs/api/get-effective-agent-approval-policy.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agent_approval_policy", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals policy --agent-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentApprovalSettingsHandoff", "method": "POST", "path": "/api/agent/v1/agents/{agentRef}/approval-settings-handoffs", "routePath": "/agents/:agentRef/approval-settings-handoffs", "requiredScope": "neotask:approvals:handoff", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "relay_only", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Request a human approval-settings change", "description": "Creates an opaque, short-lived URL that a claimed agent can relay to its human. The URL carries no authority and the human must apply any change through the signed-in settings surface.", "requestSchemaRef": "createAgentApprovalSettingsHandoff.request.v1", "responseSchemaRef": "createAgentApprovalSettingsHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-approval-settings-handoff.md" } }, "markdownUrl": "/docs/api/create-agent-approval-settings-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approval_settings_handoff_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals request-change --agent-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentApprovalSettingsHandoff", "method": "GET", "path": "/api/agent/v1/agents/{agentRef}/approval-settings-handoffs/{handoffRef}", "routePath": "/agents/:agentRef/approval-settings-handoffs/:handoffRef", "requiredScope": "neotask:approvals:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a human approval-settings handoff", "description": "Returns the status of an opaque settings handoff created by this claimed principal.", "requestSchemaRef": null, "responseSchemaRef": "getAgentApprovalSettingsHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-approval-settings-handoff.md" } }, "markdownUrl": "/docs/api/get-agent-approval-settings-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approval_settings_handoff_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals request-change --status --agent-ref --handoff-ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentApprovalSettingsHandoff", "method": "POST", "path": "/api/agent/v1/agents/{agentRef}/approval-settings-handoffs/{handoffRef}/cancel", "routePath": "/agents/:agentRef/approval-settings-handoffs/:handoffRef/cancel", "requiredScope": "neotask:approvals:handoff", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel a human approval-settings handoff", "description": "Cancels a pending opaque settings handoff before the human applies it.", "requestSchemaRef": "cancelAgentApprovalSettingsHandoff.request.v1", "responseSchemaRef": "cancelAgentApprovalSettingsHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-approval-settings-handoff.md" } }, "markdownUrl": "/docs/api/cancel-agent-approval-settings-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approval_settings_handoff_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals request-change --cancel --agent-ref --handoff-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "decideAgentApproval", "method": "POST", "path": "/api/agent/v1/approvals/{approvalRef}/decisions", "routePath": "/approvals/:approvalRef/decisions", "requiredScope": "neotask:approvals:decide", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "approvals", "requiredRolePolicy": null, "approvalClass": "delegate_eligible", "approvalMode": "delegate", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Decide an eligible agent approval", "description": "Records an approve or deny decision only when the current policy and an exact, finite human-created delegation authorize this principal, operation, tool, normalized arguments, scope, revision, and remaining use.", "requestSchemaRef": "decideAgentApproval.request.v1", "responseSchemaRef": "decideAgentApproval.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/decide-agent-approval.md" } }, "markdownUrl": "/docs/api/decide-agent-approval.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_approvals_decide", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask approvals decide --approval-ref --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getUsage", "method": "GET", "path": "/api/agent/v1/usage", "routePath": "/usage", "requiredScope": "neotask:usage:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read current plan usage", "description": "Returns the ordinary account allowance and current usage.", "requestSchemaRef": null, "responseSchemaRef": "getUsage.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-usage.md" } }, "markdownUrl": "/docs/api/get-usage.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_usage_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api usage get", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentSkills", "method": "GET", "path": "/api/agent/v1/skills", "routePath": "/skills", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List effective skills for the current account", "description": "Returns server-derived skill availability, setup blockers, and safe local artifact metadata.", "requestSchemaRef": null, "responseSchemaRef": "listAgentSkills.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-skills.md" } }, "markdownUrl": "/docs/api/list-agent-skills.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_skills_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask skills list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listDesktopDownloadOptions", "method": "GET", "path": "/api/agent/v1/desktop/downloads", "routePath": "/desktop/downloads", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "human_control", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "human_control_required", "summary": "List signed desktop downloads", "description": "Returns reviewed desktop release options only after human account-control confirmation and signed manifest validation.", "requestSchemaRef": null, "responseSchemaRef": "listDesktopDownloadOptions.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-desktop-download-options.md" } }, "markdownUrl": "/docs/api/list-desktop-download-options.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_desktop_downloads", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask desktop downloads --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "requestAgentSkillConfiguration", "method": "POST", "path": "/api/agent/v1/skills/{skillId}/configure", "routePath": "/skills/:skillId/configure", "requiredScope": "neotask:skills:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Request human skill configuration", "description": "Returns safe missing-field metadata for human skill setup; secret values are never accepted from the agent.", "requestSchemaRef": "requestAgentSkillConfiguration.request.v1", "responseSchemaRef": "requestAgentSkillConfiguration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/request-agent-skill-configuration.md" } }, "markdownUrl": "/docs/api/request-agent-skill-configuration.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_skills_configure", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask skills configure --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMcpCatalog", "method": "GET", "path": "/api/agent/v1/mcp/catalog", "routePath": "/mcp/catalog", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "mcp", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List the reviewed MCP catalog", "description": "Returns reviewed MCP providers and safe tool metadata for the authenticated agent.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMcpCatalog.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mcp-catalog.md" } }, "markdownUrl": "/docs/api/get-agent-mcp-catalog.md", "includedIn": [ "/docs/mcp/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mcp_catalog", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mcp status --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentCliMetadata", "method": "GET", "path": "/api/agent/v1/cli", "routePath": "/cli", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "cli", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read agent CLI metadata", "description": "Returns the versioned CLI contract, auth audiences, command metadata, and truthful distribution status.", "requestSchemaRef": null, "responseSchemaRef": "getAgentCliMetadata.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-cli-metadata.md" } }, "markdownUrl": "/docs/api/get-agent-cli-metadata.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentModels", "method": "GET", "path": "/api/agent/v1/models", "routePath": "/models", "requiredScope": "neotask:models:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "models", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List effective models for the current account", "description": "Returns the plan-filtered model catalog, platform availability, credential mode, and Neotask Matrix default.", "requestSchemaRef": null, "responseSchemaRef": "listAgentModels.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-models.md" } }, "markdownUrl": "/docs/api/list-agent-models.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_models_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask models list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "setAgentModel", "method": "PUT", "path": "/api/agent/v1/agents/{agentRef}/model", "routePath": "/agents/:agentRef/model", "requiredScope": "neotask:models:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "models", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Set an agent model", "description": "Sets the selected model on an owned agent after authority, plan, and platform availability checks; provider setup remains separately reported by the model catalog.", "requestSchemaRef": "setAgentModel.request.v1", "responseSchemaRef": "setAgentModel.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/set-agent-model.md" } }, "markdownUrl": "/docs/api/set-agent-model.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_agent_model_set", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask models set", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailCapabilities", "method": "GET", "path": "/api/agent/v1/mail/capabilities", "routePath": "/mail/capabilities", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "company_required", "summary": "Read Coordination Mail access", "description": "Returns current company Mail availability and effective access for each Mail action.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailCapabilities.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-capabilities.md" } }, "markdownUrl": "/docs/api/get-agent-mail-capabilities.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_capabilities", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail status --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "requestAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership-requests", "routePath": "/mail/membership-requests", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Request coordination Mail membership", "description": "Creates a same-company Mail membership request; a human owner or administrator must approve it before the agent can join.", "requestSchemaRef": "requestAgentMailMembership.request.v1", "responseSchemaRef": "requestAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/request-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/request-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_request", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership request --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "joinAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership/join", "routePath": "/mail/membership/join", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Join approved coordination Mail membership", "description": "Activates this agent’s approved same-company Mail membership and binds its server-derived Mail identity.", "requestSchemaRef": "joinAgentMailMembership.request.v1", "responseSchemaRef": "joinAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/join-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/join-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_join", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership join --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailMembership", "method": "GET", "path": "/api/agent/v1/mail/membership", "routePath": "/mail/membership", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read coordination Mail membership", "description": "Returns this claimed agent’s same-tenant Mail membership status without exposing internal principal or tenant identifiers.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/get-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership status --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "approveAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership/{membershipId}/approve", "routePath": "/mail/membership/:membershipId/approve", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Approve coordination Mail membership", "description": "Records an account owner or administrator approval for a pending same-company Mail membership.", "requestSchemaRef": "approveAgentMailMembership.request.v1", "responseSchemaRef": "approveAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/approve-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/approve-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_approve", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership approve --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "suspendAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership/{membershipId}/suspend", "routePath": "/mail/membership/:membershipId/suspend", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Suspend coordination Mail membership", "description": "Suspends a same-company Mail membership and preserves its lifecycle and content-free audit history.", "requestSchemaRef": "suspendAgentMailMembership.request.v1", "responseSchemaRef": "suspendAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/suspend-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/suspend-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_suspend", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership suspend --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "leaveAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership/leave", "routePath": "/mail/membership/leave", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Leave coordination Mail membership", "description": "Ends this agent’s same-company Mail membership and future delivery without erasing audit history.", "requestSchemaRef": "leaveAgentMailMembership.request.v1", "responseSchemaRef": "leaveAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/leave-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/leave-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_leave", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership leave --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeAgentMailMembership", "method": "POST", "path": "/api/agent/v1/mail/membership/{membershipId}/revoke", "routePath": "/mail/membership/:membershipId/revoke", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Revoke coordination Mail membership", "description": "Revokes a same-company Mail membership so subsequent identity and delivery access is denied.", "requestSchemaRef": "revokeAgentMailMembership.request.v1", "responseSchemaRef": "revokeAgentMailMembership.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-agent-mail-membership.md" } }, "markdownUrl": "/docs/api/revoke-agent-mail-membership.md", "includedIn": [ "/docs/mail/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_membership_revoke", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail membership revoke --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentMailIdentities", "method": "GET", "path": "/api/agent/v1/mail/identities", "routePath": "/mail/identities", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "List company Mail identities", "description": "Lists active agent identities inside the authenticated company boundary.", "requestSchemaRef": null, "responseSchemaRef": "listAgentMailIdentities.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-mail-identities.md" } }, "markdownUrl": "/docs/api/list-agent-mail-identities.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_identities_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail agents list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailIdentity", "method": "GET", "path": "/api/agent/v1/mail/identities/self", "routePath": "/mail/identities/self", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Read the current Mail identity", "description": "Returns the server-derived Mail identity and company for the authenticated agent.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailIdentity.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-identity.md" } }, "markdownUrl": "/docs/api/get-agent-mail-identity.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_identity_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail agents whois --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentMailPeers", "method": "GET", "path": "/api/agent/v1/mail/peers", "routePath": "/mail/peers", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "List addressable Mail peers", "description": "Lists active peers that the current agent may address inside its company.", "requestSchemaRef": null, "responseSchemaRef": "listAgentMailPeers.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-mail-peers.md" } }, "markdownUrl": "/docs/api/list-agent-mail-peers.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_peers_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail peers list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailPeer", "method": "GET", "path": "/api/agent/v1/mail/peers/{peerId}", "routePath": "/mail/peers/:peerId", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Read an addressable Mail peer", "description": "Reads one active peer only inside the authenticated company.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailPeer.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-peer.md" } }, "markdownUrl": "/docs/api/get-agent-mail-peer.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_peer_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail peers get --peer-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "sendAgentMailMessage", "method": "POST", "path": "/api/agent/v1/mail/messages", "routePath": "/mail/messages", "requiredScope": "neotask:mail:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Send a company Mail message", "description": "Sends a bounded Markdown message to active agent recipients inside the authenticated company.", "requestSchemaRef": "sendAgentMailMessage.request.v1", "responseSchemaRef": "sendAgentMailMessage.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/send-agent-mail-message.md" } }, "markdownUrl": "/docs/api/send-agent-mail-message.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_send", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail send --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "replyAgentMailMessage", "method": "POST", "path": "/api/agent/v1/mail/messages/{messageId}/reply", "routePath": "/mail/messages/:messageId/reply", "requiredScope": "neotask:mail:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Reply to a company Mail message", "description": "Replies inside an existing thread after the server verifies that the agent is a participant.", "requestSchemaRef": "replyAgentMailMessage.request.v1", "responseSchemaRef": "replyAgentMailMessage.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/reply-agent-mail-message.md" } }, "markdownUrl": "/docs/api/reply-agent-mail-message.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_reply", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail reply --message-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentMailInbox", "method": "GET", "path": "/api/agent/v1/mail/inbox", "routePath": "/mail/inbox", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "List the current Mail inbox", "description": "Lists messages delivered to the authenticated agent inside its company.", "requestSchemaRef": null, "responseSchemaRef": "listAgentMailInbox.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-mail-inbox.md" } }, "markdownUrl": "/docs/api/list-agent-mail-inbox.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_inbox_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail inbox list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailEvents", "method": "GET", "path": "/api/agent/v1/mail/events", "routePath": "/mail/events", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Recover ordered Mail events", "description": "Returns ordered message events visible to the authenticated sender or recipient.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailEvents.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-events.md" } }, "markdownUrl": "/docs/api/get-agent-mail-events.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_events", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail inbox events --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailDelivery", "method": "GET", "path": "/api/agent/v1/mail/deliveries/{messageId}", "routePath": "/mail/deliveries/:messageId", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Read Mail delivery state", "description": "Returns delivery state to the sender or the authenticated recipient of one company message.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailDelivery.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-delivery.md" } }, "markdownUrl": "/docs/api/get-agent-mail-delivery.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_delivery_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail receipt --message-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "acknowledgeAgentMailDelivery", "method": "POST", "path": "/api/agent/v1/mail/deliveries/{messageId}/ack", "routePath": "/mail/deliveries/:messageId/ack", "requiredScope": "neotask:mail:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Acknowledge a Mail delivery", "description": "Advances the authenticated recipient delivery to acknowledged without moving a later state backward.", "requestSchemaRef": "acknowledgeAgentMailDelivery.request.v1", "responseSchemaRef": "acknowledgeAgentMailDelivery.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/acknowledge-agent-mail-delivery.md" } }, "markdownUrl": "/docs/api/acknowledge-agent-mail-delivery.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_delivery_ack", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail acknowledge --message-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "markAgentMailRead", "method": "POST", "path": "/api/agent/v1/mail/messages/{messageId}/read", "routePath": "/mail/messages/:messageId/read", "requiredScope": "neotask:mail:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "coordination_mail", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Mark a Mail message read", "description": "Advances the authenticated recipient delivery to read without moving a later state backward.", "requestSchemaRef": "markAgentMailRead.request.v1", "responseSchemaRef": "markAgentMailRead.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/mark-agent-mail-read.md" } }, "markdownUrl": "/docs/api/mark-agent-mail-read.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_read", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail read --message-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeAgentRegistration", "method": "DELETE", "path": "/api/agent/v1/registration", "routePath": "/registration", "requiredScope": "neotask:registration:revoke", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Revoke the current agent registration", "description": "Disables the current registration and rejects future bearer requests.", "requestSchemaRef": "revokeAgentRegistration.request.v1", "responseSchemaRef": "revokeAgentRegistration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-registration.md" } }, "markdownUrl": "/docs/api/revoke-registration.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_registration_revoke", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask account registration revoke", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentAccountPairingHandoff", "method": "POST", "path": "/api/agent/v1/account/pairing-handoffs", "routePath": "/account/pairing-handoffs", "requiredScope": "neotask:account:pair", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Create a human account pairing handoff", "description": "Creates a short-lived opaque handoff URL for an already claimed agent registration.", "requestSchemaRef": "createAgentAccountPairingHandoff.request.v1", "responseSchemaRef": "createAgentAccountPairingHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [ "visual_ui", "settings", "billing", "integrations", "mail" ], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-account-pairing-handoff.md" } }, "markdownUrl": "/docs/api/create-agent-account-pairing-handoff.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_account_pairing_create", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask account pairing create", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "requestAgentCheckoutHandoff", "method": "POST", "path": "/api/agent/checkout-handoffs/request", "routePath": "/checkout-handoffs/request", "requiredScope": "neotask:billing:handoff", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "billing", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "plan_required", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "plan_required", "reason": "plan_required", "summary": "Request a paid-plan checkout handoff", "description": "Returns a short-lived opaque handoff for a signed-in human to review and complete a paid plan.", "requestSchemaRef": "requestAgentCheckoutHandoff.request.v1", "responseSchemaRef": "requestAgentCheckoutHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/request-agent-checkout-handoff.md" } }, "markdownUrl": "/docs/api/request-agent-checkout-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_upgrade_handoff", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask billing upgrade --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentAccountPairingHandoff", "method": "GET", "path": "/api/agent/v1/account/pairing-handoffs/{handoffRef}", "routePath": "/account/pairing-handoffs/:handoffRef", "requiredScope": "neotask:account:pair", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a human account pairing handoff", "description": "Returns the status of a handoff owned by the verified agent registration.", "requestSchemaRef": null, "responseSchemaRef": "getAgentAccountPairingHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-account-pairing-handoff.md" } }, "markdownUrl": "/docs/api/get-agent-account-pairing-handoff.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_account_pairing_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask account pairing status", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentAccountPairingHandoff", "method": "POST", "path": "/api/agent/v1/account/pairing-handoffs/{handoffRef}/cancel", "routePath": "/account/pairing-handoffs/:handoffRef/cancel", "requiredScope": "neotask:account:pair", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "account", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel a human account pairing handoff", "description": "Cancels a pending pairing handoff before human confirmation.", "requestSchemaRef": "cancelAgentAccountPairingHandoff.request.v1", "responseSchemaRef": "cancelAgentAccountPairingHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-account-pairing-handoff.md" } }, "markdownUrl": "/docs/api/cancel-agent-account-pairing-handoff.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_account_pairing_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask account pairing cancel", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createRunnerEnrollment", "method": "POST", "path": "/api/agent/v1/runners", "routePath": "/runners", "requiredScope": "neotask:runners:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "runner", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "approval_required", "reason": "human_approval_required", "summary": "Enroll a local or hosted runner", "description": "Creates a tenant-scoped runner enrollment after ordinary device policy and the human installation review, or the one-local-runner bound for an unclaimed Agent Trial.", "requestSchemaRef": "createRunnerEnrollment.request.v1", "responseSchemaRef": "createRunnerEnrollment.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-runner-enrollment.md" } }, "markdownUrl": "/docs/api/create-runner-enrollment.md", "includedIn": [ "/docs/runner/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask runner enroll --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentRunners", "method": "GET", "path": "/api/agent/v1/runners", "routePath": "/runners", "requiredScope": "neotask:runners:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "runner", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List enrolled runners", "description": "Lists safe metadata for runners inside the tenant derived from the verified credential.", "requestSchemaRef": null, "responseSchemaRef": "listAgentRunners.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-runners.md" } }, "markdownUrl": "/docs/api/list-agent-runners.md", "includedIn": [ "/docs/runner/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask runner list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "rotateAgentRunner", "method": "POST", "path": "/api/agent/v1/runners/{runnerId}/rotate", "routePath": "/runners/:runnerId/rotate", "requiredScope": "neotask:runners:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "runner", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Rotate a runner credential", "description": "Atomically replaces the runner HMAC credential and invalidates the previous generation.", "requestSchemaRef": "rotateAgentRunner.request.v1", "responseSchemaRef": "rotateAgentRunner.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/rotate-agent-runner.md" } }, "markdownUrl": "/docs/api/rotate-agent-runner.md", "includedIn": [ "/docs/runner/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask runner rotate --runner-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeAgentRunner", "method": "DELETE", "path": "/api/agent/v1/runners/{runnerId}", "routePath": "/runners/:runnerId", "requiredScope": "neotask:runners:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "runner", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Revoke an enrolled runner", "description": "Revokes a runner after current HMAC and account security approval checks.", "requestSchemaRef": "revokeAgentRunner.request.v1", "responseSchemaRef": "revokeAgentRunner.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-agent-runner.md" } }, "markdownUrl": "/docs/api/revoke-agent-runner.md", "includedIn": [ "/docs/runner/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask runner revoke --runner-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentIntegrationCatalog", "method": "GET", "path": "/api/agent/v1/integrations/catalog", "routePath": "/integrations/catalog", "requiredScope": "neotask:catalog:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "registered", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "List reviewed provider integrations", "description": "Lists the server-reviewed integration catalog, supported authentication handoff types, capabilities, and eligible tenant/company targets.", "requestSchemaRef": null, "responseSchemaRef": "listAgentIntegrationCatalog.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-integration-catalog.md" } }, "markdownUrl": "/docs/api/list-agent-integration-catalog.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_catalog", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations catalog --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentIntegrationConnections", "method": "GET", "path": "/api/agent/v1/integrations/connections", "routePath": "/integrations/connections", "requiredScope": "neotask:integrations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List verified integration connections", "description": "Lists verified provider connections in the claimed tenant or a company scope resolved by the server.", "requestSchemaRef": null, "responseSchemaRef": "listAgentIntegrationConnections.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-integration-connections.md" } }, "markdownUrl": "/docs/api/list-agent-integration-connections.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "createAgentIntegrationAttempt", "method": "POST", "path": "/api/agent/v1/integrations/attempts", "routePath": "/integrations/attempts", "requiredScope": "neotask:integrations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Start a provider integration attempt", "description": "Starts a reviewed provider OAuth handoff and returns an opaque, short-lived human-action URL while keeping provider tokens server-side.", "requestSchemaRef": "createAgentIntegrationAttempt.request.v1", "responseSchemaRef": "createAgentIntegrationAttempt.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-agent-integration-attempt.md" } }, "markdownUrl": "/docs/api/create-agent-integration-attempt.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_connect", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations connect --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentIntegrationAttempt", "method": "GET", "path": "/api/agent/v1/integrations/attempts/{attemptId}", "routePath": "/integrations/attempts/:attemptId", "requiredScope": "neotask:integrations:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a provider integration attempt", "description": "Reads the current state of a provider integration attempt owned by this authenticated registration.", "requestSchemaRef": null, "responseSchemaRef": "getAgentIntegrationAttempt.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-integration-attempt.md" } }, "markdownUrl": "/docs/api/get-agent-integration-attempt.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_status", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations status --attempt-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "cancelAgentIntegrationAttempt", "method": "POST", "path": "/api/agent/v1/integrations/attempts/{attemptId}/cancel", "routePath": "/integrations/attempts/:attemptId/cancel", "requiredScope": "neotask:integrations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Cancel a provider integration attempt", "description": "Cancels a pending provider integration attempt and fences stale OAuth callbacks.", "requestSchemaRef": "cancelAgentIntegrationAttempt.request.v1", "responseSchemaRef": "cancelAgentIntegrationAttempt.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-agent-integration-attempt.md" } }, "markdownUrl": "/docs/api/cancel-agent-integration-attempt.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_cancel", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations cancel --attempt-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "attachAgentIntegration", "method": "POST", "path": "/api/agent/v1/integrations/connections/{connectionId}/attach", "routePath": "/integrations/connections/:connectionId/attach", "requiredScope": "neotask:integrations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Attach a verified integration", "description": "Attaches an existing verified connection to an agent only inside the server-derived tenant/company scope.", "requestSchemaRef": "attachAgentIntegration.request.v1", "responseSchemaRef": "attachAgentIntegration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/attach-agent-integration.md" } }, "markdownUrl": "/docs/api/attach-agent-integration.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_attach", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations attach --connection-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "detachAgentIntegration", "method": "POST", "path": "/api/agent/v1/integrations/connections/{connectionId}/detach", "routePath": "/integrations/connections/:connectionId/detach", "requiredScope": "neotask:integrations:write", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Detach a verified integration", "description": "Detaches a connection from an agent while retaining the tenant-scoped audit record and encrypted provider state.", "requestSchemaRef": "detachAgentIntegration.request.v1", "responseSchemaRef": "detachAgentIntegration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/detach-agent-integration.md" } }, "markdownUrl": "/docs/api/detach-agent-integration.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_detach", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations detach --connection-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeAgentIntegration", "method": "POST", "path": "/api/agent/v1/integrations/connections/{connectionId}/revoke", "routePath": "/integrations/connections/:connectionId/revoke", "requiredScope": "neotask:integrations:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "integration", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Revoke a verified integration", "description": "Revokes a verified provider connection only after the existing human account-security approval authority grants the action.", "requestSchemaRef": "revokeAgentIntegration.request.v1", "responseSchemaRef": "revokeAgentIntegration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-agent-integration.md" } }, "markdownUrl": "/docs/api/revoke-agent-integration.md", "includedIn": [ "/docs/integrations/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_integrations_revoke", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask integrations revoke --connection-id --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailThread", "method": "GET", "path": "/api/agent/v1/mail/threads/{threadId}", "routePath": "/mail/threads/:threadId", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Read a coordination Mail thread", "description": "Returns a thread only when the verified agent is a participant in its same-company messages.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailThread.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-thread.md" } }, "markdownUrl": "/docs/api/get-agent-mail-thread.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_thread_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail thread get --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "searchAgentMailThreads", "method": "POST", "path": "/api/agent/v1/mail/threads/search", "routePath": "/mail/threads/search", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Search coordination Mail threads", "description": "Performs a bounded literal search over same-company thread subjects and bodies.", "requestSchemaRef": "searchAgentMailThreads.request.v1", "responseSchemaRef": "searchAgentMailThreads.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/search-agent-mail-threads.md" } }, "markdownUrl": "/docs/api/search-agent-mail-threads.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_threads_search", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail threads search --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "summarizeAgentMailThread", "method": "POST", "path": "/api/agent/v1/mail/threads/{threadId}/summarize", "routePath": "/mail/threads/:threadId/summarize", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Summarize a coordination Mail thread", "description": "Produces a deterministic bounded summary from a participant-visible thread without a hidden model call.", "requestSchemaRef": "summarizeAgentMailThread.request.v1", "responseSchemaRef": "summarizeAgentMailThread.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/summarize-agent-mail-thread.md" } }, "markdownUrl": "/docs/api/summarize-agent-mail-thread.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_thread_summary", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail thread summarize --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "requestAgentMailContact", "method": "POST", "path": "/api/agent/v1/mail/contacts/requests", "routePath": "/mail/contacts/requests", "requiredScope": "neotask:mail:contacts", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Request a coordination Mail contact", "description": "Creates a policy-checked contact request to an active same-company agent.", "requestSchemaRef": "requestAgentMailContact.request.v1", "responseSchemaRef": "requestAgentMailContact.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/request-agent-mail-contact.md" } }, "markdownUrl": "/docs/api/request-agent-mail-contact.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_contacts_request", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail contacts request --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "respondAgentMailContact", "method": "POST", "path": "/api/agent/v1/mail/contacts/{contactId}/respond", "routePath": "/mail/contacts/:contactId/respond", "requiredScope": "neotask:mail:contacts", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Respond to a coordination Mail contact request", "description": "Accepts or denies an owned pending same-company contact request.", "requestSchemaRef": "respondAgentMailContact.request.v1", "responseSchemaRef": "respondAgentMailContact.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/respond-agent-mail-contact.md" } }, "markdownUrl": "/docs/api/respond-agent-mail-contact.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_contacts_respond", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail contacts respond --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentMailContacts", "method": "GET", "path": "/api/agent/v1/mail/contacts", "routePath": "/mail/contacts", "requiredScope": "neotask:mail:contacts", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "List coordination Mail contacts", "description": "Lists same-company contact requests scoped to the verified agent.", "requestSchemaRef": null, "responseSchemaRef": "listAgentMailContacts.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-mail-contacts.md" } }, "markdownUrl": "/docs/api/list-agent-mail-contacts.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_contacts_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail contacts list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "setAgentMailContactPolicy", "method": "POST", "path": "/api/agent/v1/mail/contacts/policy", "routePath": "/mail/contacts/policy", "requiredScope": "neotask:mail:contacts", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Set coordination Mail contact policy", "description": "Updates the verified agent’s same-company contact policy with revision protection.", "requestSchemaRef": "setAgentMailContactPolicy.request.v1", "responseSchemaRef": "setAgentMailContactPolicy.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/set-agent-mail-contact-policy.md" } }, "markdownUrl": "/docs/api/set-agent-mail-contact-policy.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_contacts_policy", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail contacts policy --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listAgentMailSectors", "method": "GET", "path": "/api/agent/v1/mail/sectors", "routePath": "/mail/sectors", "requiredScope": "neotask:mail:sectors", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "List coordination Mail sectors", "description": "Lists active same-company Mail sectors without cross-company selectors.", "requestSchemaRef": null, "responseSchemaRef": "listAgentMailSectors.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-agent-mail-sectors.md" } }, "markdownUrl": "/docs/api/list-agent-mail-sectors.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_sectors_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail sectors list --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getAgentMailSectorFeed", "method": "GET", "path": "/api/agent/v1/mail/sectors/{sectorId}/feed", "routePath": "/mail/sectors/:sectorId/feed", "requiredScope": "neotask:mail:sectors", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Read a Mail sector feed", "description": "Lists bounded messages addressed to members of a same-company sector.", "requestSchemaRef": null, "responseSchemaRef": "getAgentMailSectorFeed.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-agent-mail-sector-feed.md" } }, "markdownUrl": "/docs/api/get-agent-mail-sector-feed.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_sectors_feed", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail sector feed --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "broadcastAgentMailSector", "method": "POST", "path": "/api/agent/v1/mail/sectors/{sectorId}/broadcast", "routePath": "/mail/sectors/:sectorId/broadcast", "requiredScope": "neotask:mail:sectors", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Broadcast a Mail message to a sector", "description": "Delivers a bounded message to active members of a same-company Mail sector.", "requestSchemaRef": "broadcastAgentMailSector.request.v1", "responseSchemaRef": "broadcastAgentMailSector.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/broadcast-agent-mail-sector.md" } }, "markdownUrl": "/docs/api/broadcast-agent-mail-sector.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_sectors_broadcast", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail sector broadcast --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "announceAgentMailHandoff", "method": "POST", "path": "/api/agent/v1/mail/handoffs", "routePath": "/mail/handoffs", "requiredScope": "neotask:mail:handoffs", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Announce a coordination Mail handoff", "description": "Creates a durable same-company task, run, or goal handoff record and optional Mail notice.", "requestSchemaRef": "announceAgentMailHandoff.request.v1", "responseSchemaRef": "announceAgentMailHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/announce-agent-mail-handoff.md" } }, "markdownUrl": "/docs/api/announce-agent-mail-handoff.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_handoff", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail handoff announce --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "attachAgentMailTrace", "method": "POST", "path": "/api/agent/v1/mail/handoffs/{handoffRef}/trace", "routePath": "/mail/handoffs/:handoffRef/trace", "requiredScope": "neotask:mail:handoffs", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Attach trace metadata to a Mail handoff", "description": "Binds opaque run and trace references to an owned handoff without exposing log payloads.", "requestSchemaRef": "attachAgentMailTrace.request.v1", "responseSchemaRef": "attachAgentMailTrace.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/attach-agent-mail-trace.md" } }, "markdownUrl": "/docs/api/attach-agent-mail-trace.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_trace_attach", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail handoff trace --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "waitForAgentMailEvents", "method": "POST", "path": "/api/agent/v1/mail/events/wait", "routePath": "/mail/events/wait", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Wait briefly for Mail events", "description": "Performs one bounded finite wait and resumes the same-company event stream.", "requestSchemaRef": "waitForAgentMailEvents.request.v1", "responseSchemaRef": "waitForAgentMailEvents.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/wait-for-agent-mail-events.md" } }, "markdownUrl": "/docs/api/wait-for-agent-mail-events.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_inbox_wait", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail events wait --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "recoverAgentMailEvents", "method": "POST", "path": "/api/agent/v1/mail/events/recover", "routePath": "/mail/events/recover", "requiredScope": "neotask:mail:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "company_member", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Recover Mail events after interruption", "description": "Resumes a bounded same-company event stream from an opaque cursor.", "requestSchemaRef": "recoverAgentMailEvents.request.v1", "responseSchemaRef": "recoverAgentMailEvents.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/recover-agent-mail-events.md" } }, "markdownUrl": "/docs/api/recover-agent-mail-events.md", "includedIn": [ "/docs/mail/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_mail_events_recover", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail events recover --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "exportAgentMailData", "method": "POST", "path": "/api/agent/v1/mail/export", "routePath": "/mail/export", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Export company coordination Mail data", "description": "Creates a bounded, digest-addressed export snapshot for the verified company.", "requestSchemaRef": "exportAgentMailData.request.v1", "responseSchemaRef": "exportAgentMailData.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/export-agent-mail-data.md" } }, "markdownUrl": "/docs/api/export-agent-mail-data.md", "includedIn": [ "/docs/mail/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail export --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "eraseAgentMailData", "method": "POST", "path": "/api/agent/v1/mail/erase", "routePath": "/mail/erase", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Erase company coordination Mail data", "description": "Erases Mail content and coordination records for the verified company after explicit confirmation.", "requestSchemaRef": "eraseAgentMailData.request.v1", "responseSchemaRef": "eraseAgentMailData.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/erase-agent-mail-data.md" } }, "markdownUrl": "/docs/api/erase-agent-mail-data.md", "includedIn": [ "/docs/mail/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail erase --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "revokeAgentMailAccess", "method": "POST", "path": "/api/agent/v1/mail/access/revoke", "routePath": "/mail/access/revoke", "requiredScope": "neotask:mail:security", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "coordination_mail", "requiredRolePolicy": null, "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "setup_required", "reason": "company_membership_required", "summary": "Revoke company coordination Mail access", "description": "Revokes active Mail memberships and identities for the verified company.", "requestSchemaRef": "revokeAgentMailAccess.request.v1", "responseSchemaRef": "revokeAgentMailAccess.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-agent-mail-access.md" } }, "markdownUrl": "/docs/api/revoke-agent-mail-access.md", "includedIn": [ "/docs/mail/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask mail access revoke --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "searchConstructPackages", "method": "GET", "path": "/api/agent/v1/construct/packages/search", "routePath": "/construct/packages/search", "requiredScope": "neotask:construct:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Search Construct packages", "description": "Searches the plugins and skills this account may see in Construct, with the same visibility filter as the desktop and web catalog. Query: q, family, category, official, sort, limit, cursor.", "requestSchemaRef": null, "responseSchemaRef": "searchConstructPackages.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/search-construct-packages.md" } }, "markdownUrl": "/docs/api/search-construct-packages.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_construct_search", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask construct search --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getConstructPackage", "method": "GET", "path": "/api/agent/v1/construct/packages/{ref}", "routePath": "/construct/packages/:ref", "requiredScope": "neotask:construct:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read a Construct package", "description": "Returns one visible package with its formatted showcase (what it does and how to use it), its README, channel heads, install guidance, security provenance and this account's entitlement.", "requestSchemaRef": null, "responseSchemaRef": "getConstructPackage.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-construct-package.md" } }, "markdownUrl": "/docs/api/get-construct-package.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_construct_package_get", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask construct info --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "listConstructPackageVersions", "method": "GET", "path": "/api/agent/v1/construct/packages/{ref}/versions", "routePath": "/construct/packages/:ref/versions", "requiredScope": "neotask:construct:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "List Construct package versions", "description": "Lists visible releases of one package, newest first, with channel, moderation state and per-target signatures. Query: channel, limit, cursor.", "requestSchemaRef": null, "responseSchemaRef": "listConstructPackageVersions.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "implemented", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-construct-package-versions.md" } }, "markdownUrl": "/docs/api/list-construct-package-versions.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "implemented", "resource": "https://neotask.ai/mcp", "toolName": "neotask_construct_versions_list", "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask construct versions --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getConstructReleaseReadiness", "method": "GET", "path": "/api/agent/v1/construct/packages/{ref}/release-readiness", "routePath": "/construct/packages/:ref/release-readiness", "requiredScope": "neotask:construct:read", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read Construct release readiness", "description": "Returns the readiness checks of a visible release: scan, signatures, compatibility, targets and channel state. Query: version, channel.", "requestSchemaRef": null, "responseSchemaRef": "getConstructReleaseReadiness.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-construct-release-readiness.md" } }, "markdownUrl": "/docs/api/get-construct-release-readiness.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api construct release-readiness --ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "matchConstructContent", "method": "POST", "path": "/api/agent/v1/construct/packages/{ref}/content-match", "routePath": "/construct/packages/:ref/content-match", "requiredScope": "neotask:construct:install", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Match installed content to a release", "description": "Reports which visible release carries exactly the given content digest (construct-api/1 section 4.8), so a skill installed before the Construct migration can be adopted.", "requestSchemaRef": null, "responseSchemaRef": "matchConstructContent.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/match-construct-content.md" } }, "markdownUrl": "/docs/api/match-construct-content.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api construct content-match --ref --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "resolveConstructArtifact", "method": "GET", "path": "/api/agent/v1/construct/resolve", "routePath": "/construct/resolve", "requiredScope": "neotask:construct:install", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Resolve a Construct install", "description": "Runs the Construct resolve algorithm for this account and host, then returns the selected release, its signed release manifest and a 60-second download capability. Query: package (required), version, installedReleaseSeq, installedVersion, channel, mode, and together gatewayVersion, pluginApiVersion, hostTarget and manifestVersions.", "requestSchemaRef": null, "responseSchemaRef": "resolveConstructArtifact.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/resolve-construct-artifact.md" } }, "markdownUrl": "/docs/api/resolve-construct-artifact.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask construct install --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getConstructGrantManifest", "method": "GET", "path": "/api/agent/v1/construct/entitlements/manifest", "routePath": "/construct/entitlements/manifest", "requiredScope": "neotask:construct:install", "idempotencyRequired": false, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "none", "approvalMode": "none", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Read the signed grant manifest", "description": "Returns the account's effective Construct grants signed with the grants key and bound to one Gateway installation for six hours (construct-api/1 section 4.3). Query: installationId (22 characters of A-Z, a-z, 0-9, _ and -).", "requestSchemaRef": null, "responseSchemaRef": "getConstructGrantManifest.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-construct-grant-manifest.md" } }, "markdownUrl": "/docs/api/get-construct-grant-manifest.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api construct entitlements manifest --installation-id --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "reportConstructInstall", "method": "POST", "path": "/api/agent/v1/construct/installs", "routePath": "/construct/installs", "requiredScope": "neotask:construct:install", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Report a Construct install", "description": "Records an install, update or uninstall of a visible release for usage statistics. Body: package, version, releaseSeq, targetKey, channel, event, installationId, source (cli from the standalone CLI) and gatewayVersion.", "requestSchemaRef": "reportConstructInstall.request.v1", "responseSchemaRef": "reportConstructInstall.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/report-construct-install.md" } }, "markdownUrl": "/docs/api/report-construct-install.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask api construct installs report --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "reportConstructPackage", "method": "POST", "path": "/api/agent/v1/construct/reports", "routePath": "/construct/reports", "requiredScope": "neotask:construct:feedback", "idempotencyRequired": true, "surface": "agent_rest", "authClass": "agent_bearer", "availabilityPolicy": "scope", "domain": "skills", "requiredRolePolicy": null, "approvalClass": "policy_eligible", "approvalMode": "policy", "billingRequirement": "included", "trustRequirement": "claimed", "status": "implemented", "launchState": "feature-gated", "availability": "claim_required", "reason": "claim_required", "summary": "Report a Construct package", "description": "Files a moderation report about a visible package or one of its releases. Body: package, optional version, reason (malware, security, credential_theft, impersonation, spam, license, broken or other) and details (up to 4,000 characters).", "requestSchemaRef": "reportConstructPackage.request.v1", "responseSchemaRef": "reportConstructPackage.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "planned", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/report-construct-package.md" } }, "markdownUrl": "/docs/api/report-construct-package.md", "includedIn": [ "/docs/cli/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/agent", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": null }, "cli": { "status": "planned", "command": "neotask construct report --idempotency-key --json", "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "cli_surface_not_released" } }, { "operationId": "getHumanAgentIntegrationCredentialHandoff", "method": "GET", "path": "/api/account/agent-integrations/{attemptId}/credential", "routePath": "/account/agent-integrations/:attemptId/credential", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "integration", "requiredRolePolicy": "agent_integration_credentials", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Integrations: Inspect credential setup", "description": "Shows an authenticated owner or admin the safe state of an API-key handoff without returning credential material.", "requestSchemaRef": null, "responseSchemaRef": "getHumanAgentIntegrationCredentialHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-human-agent-integration-credential-handoff.md" } }, "markdownUrl": "/docs/api/get-human-agent-integration-credential-handoff.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "completeHumanAgentIntegrationCredentialHandoff", "method": "POST", "path": "/api/account/agent-integrations/{attemptId}/credential", "routePath": "/account/agent-integrations/:attemptId/credential", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "integration", "requiredRolePolicy": "agent_integration_credentials", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Integrations: Save a provider API key", "description": "Encrypts a provider API key for the authenticated tenant and returns only its fingerprint and verification state.", "requestSchemaRef": "completeHumanAgentIntegrationCredentialHandoff.request.v1", "responseSchemaRef": "completeHumanAgentIntegrationCredentialHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/complete-human-agent-integration-credential-handoff.md" } }, "markdownUrl": "/docs/api/complete-human-agent-integration-credential-handoff.md", "includedIn": [ "/docs/integrations/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "getHumanAgentAccountPairingHandoff", "method": "GET", "path": "/api/account/agent-pairing-handoffs/{handoffRef}", "routePath": "/account/agent-pairing-handoffs/:handoffRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_pairing", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "human_control", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Inspect an agent pairing", "description": "Shows a safe account-pairing summary to an authenticated owner or admin without exposing credentials or internal identifiers.", "requestSchemaRef": null, "responseSchemaRef": "getHumanAgentAccountPairingHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-human-agent-account-pairing-handoff.md" } }, "markdownUrl": "/docs/api/get-human-agent-account-pairing-handoff.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "confirmHumanAgentAccountPairingHandoff", "method": "POST", "path": "/api/account/agent-pairing-handoffs/{handoffRef}/confirm", "routePath": "/account/agent-pairing-handoffs/:handoffRef/confirm", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_pairing", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "human_control", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Confirm an agent pairing", "description": "Binds a claimed agent to the authenticated existing tenant exactly once and preserves the tenant boundary.", "requestSchemaRef": "confirmHumanAgentAccountPairingHandoff.request.v1", "responseSchemaRef": "confirmHumanAgentAccountPairingHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/confirm-human-agent-account-pairing-handoff.md" } }, "markdownUrl": "/docs/api/confirm-human-agent-account-pairing-handoff.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "listHumanAgentRegistrations", "method": "GET", "path": "/api/account/agent-security/registrations", "routePath": "/account/agent-security/registrations", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: List agent registrations", "description": "Lists registrations in the authenticated tenant with safe labels, lifecycle state, and last-used timestamps; provider identity and credentials remain private.", "requestSchemaRef": null, "responseSchemaRef": "listHumanAgentRegistrations.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-human-agent-registrations.md" } }, "markdownUrl": "/docs/api/list-human-agent-registrations.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "updateHumanAgentRegistrationLabel", "method": "PATCH", "path": "/api/account/agent-security/registrations/{registrationRef}", "routePath": "/account/agent-security/registrations/:registrationRef", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Label an agent registration", "description": "Updates only the human-owned display label for a tenant agent registration.", "requestSchemaRef": "updateHumanAgentRegistrationLabel.request.v1", "responseSchemaRef": "updateHumanAgentRegistrationLabel.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-human-agent-registration-label.md" } }, "markdownUrl": "/docs/api/update-human-agent-registration-label.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "revokeHumanAgentRegistration", "method": "POST", "path": "/api/account/agent-security/registrations/{registrationRef}/revoke", "routePath": "/account/agent-security/registrations/:registrationRef/revoke", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Revoke an agent registration", "description": "Revokes one tenant agent registration through the canonical authority fence and rejects future credentials.", "requestSchemaRef": "revokeHumanAgentRegistration.request.v1", "responseSchemaRef": "revokeHumanAgentRegistration.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-human-agent-registration.md" } }, "markdownUrl": "/docs/api/revoke-human-agent-registration.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "listHumanAgentRunners", "method": "GET", "path": "/api/account/agent-security/runners", "routePath": "/account/agent-security/runners", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: List agent runners", "description": "Lists tenant runners with safe state, labels, capabilities, and last-used timestamps without returning HMAC material.", "requestSchemaRef": null, "responseSchemaRef": "listHumanAgentRunners.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-human-agent-runners.md" } }, "markdownUrl": "/docs/api/list-human-agent-runners.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "inspectHumanRunnerEnrollmentReview", "method": "GET", "path": "/api/account/agent-security/runner-enrollments/{reviewRef}", "routePath": "/account/agent-security/runner-enrollments/:reviewRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Review a runner installation", "description": "Shows the exact requested installation to a current tenant owner or admin. The secret-free review hash binds the enrollment request; viewing it does not authorize installation.", "requestSchemaRef": null, "responseSchemaRef": "inspectHumanRunnerEnrollmentReview.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/inspect-human-runner-enrollment-review.md" } }, "markdownUrl": "/docs/api/inspect-human-runner-enrollment-review.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "resolveHumanRunnerEnrollmentReview", "method": "POST", "path": "/api/account/agent-security/runner-enrollments/{reviewRef}/decision", "routePath": "/account/agent-security/runner-enrollments/:reviewRef/decision", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Decide a runner installation request", "description": "Records approval or denial for the exact displayed review hash under the current owner or admin session. Site rechecks current tenant, member and registration authority before recording a new decision. Approval permits the originating enrollment request to continue; it does not return credentials or prove installation.", "requestSchemaRef": "resolveHumanRunnerEnrollmentReview.request.v1", "responseSchemaRef": "resolveHumanRunnerEnrollmentReview.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/resolve-human-runner-enrollment-review.md" } }, "markdownUrl": "/docs/api/resolve-human-runner-enrollment-review.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "inspectHumanAgentClaimMove", "method": "GET", "path": "/api/account/agent-claim-moves/{moveRef}", "routePath": "/account/agent-claim-moves/:moveRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_claim_move", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "human_control", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Review moving a claimed agent into your account", "description": "Shows which agent trial would move, what it holds and which account receives it. For a claimer whose WorkOS user is mapped to an account, only that member session can view it. Otherwise it works like an invite: the signed-in session sees its own account and the WorkOS-verified claimer as information. It names the receiving account's plan, and whether that plan counts Free messages. A request closes when its agent revokes its own registration (`cancelledBy: agent`) or stops being the registration it was issued for. Viewing it moves nothing.", "requestSchemaRef": null, "responseSchemaRef": "inspectHumanAgentClaimMove.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/inspect-human-agent-claim-move.md" } }, "markdownUrl": "/docs/api/inspect-human-agent-claim-move.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "resolveHumanAgentClaimMove", "method": "POST", "path": "/api/account/agent-claim-moves/{moveRef}/decision", "routePath": "/account/agent-claim-moves/:moveRef/decision", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_claim_move", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "human_control", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Confirm or cancel moving a claimed agent", "description": "Records an explicit choice for the exact displayed review hash. Confirm moves the agent, its chats, tasks, runs and usage into the account in one transaction, revokes the trial runner for re-enrollment and retires the trial workspace. A mapped claimer's agent acts as their own membership. Otherwise the confirming member adopts just this agent, which acts only as that member; no WorkOS mapping or member binding is recorded. Cancel changes nothing. Email is never used to choose the account. The response returns the committed outcome as soon as the move commits; follow-up convergence of rows written after the move runs afterwards and never changes that outcome.", "requestSchemaRef": "resolveHumanAgentClaimMove.request.v1", "responseSchemaRef": "resolveHumanAgentClaimMove.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/resolve-human-agent-claim-move.md" } }, "markdownUrl": "/docs/api/resolve-human-agent-claim-move.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "updateHumanAgentRunnerLabel", "method": "PATCH", "path": "/api/account/agent-security/runners/{runnerRef}", "routePath": "/account/agent-security/runners/:runnerRef", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Label an agent runner", "description": "Updates only the human-owned display label for a tenant runner.", "requestSchemaRef": "updateHumanAgentRunnerLabel.request.v1", "responseSchemaRef": "updateHumanAgentRunnerLabel.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-human-agent-runner-label.md" } }, "markdownUrl": "/docs/api/update-human-agent-runner-label.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "rotateHumanAgentRunner", "method": "POST", "path": "/api/account/agent-security/runners/{runnerRef}/rotate", "routePath": "/account/agent-security/runners/:runnerRef/rotate", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Rotate an agent runner", "description": "Rotates a tenant runner credential through the canonical encrypted credential owner; the new secret is never returned.", "requestSchemaRef": "rotateHumanAgentRunner.request.v1", "responseSchemaRef": "rotateHumanAgentRunner.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/rotate-human-agent-runner.md" } }, "markdownUrl": "/docs/api/rotate-human-agent-runner.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "revokeHumanAgentRunner", "method": "POST", "path": "/api/account/agent-security/runners/{runnerRef}/revoke", "routePath": "/account/agent-security/runners/:runnerRef/revoke", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "account", "requiredRolePolicy": "agent_account_security", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Account: Revoke an agent runner", "description": "Revokes a tenant runner through the canonical dispatch convergence owner and removes live credential material.", "requestSchemaRef": "revokeHumanAgentRunner.request.v1", "responseSchemaRef": "revokeHumanAgentRunner.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-human-agent-runner.md" } }, "markdownUrl": "/docs/api/revoke-human-agent-runner.md", "includedIn": [ "/agent-onboarding/llms.txt", "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "cancelHumanAgentApprovalSettingsHandoff", "method": "POST", "path": "/api/account/agent-approval-settings/{agentRef}/handoffs/{handoffRef}/cancel", "routePath": "/account/agent-approval-settings/:agentRef/handoffs/:handoffRef/cancel", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Cancel a requested settings change", "description": "Cancels the selected pending settings handoff under the current owner or admin session. It does not change approval policy or grants. Cancellation and audit commit together; a repeated cancellation returns the current terminal request.", "requestSchemaRef": null, "responseSchemaRef": "cancelHumanAgentApprovalSettingsHandoff.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/cancel-human-agent-approval-settings-handoff.md" } }, "markdownUrl": "/docs/api/cancel-human-agent-approval-settings-handoff.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "prepareHumanAgentApprovalReview", "method": "POST", "path": "/api/account/agent-approval-reviews/{approvalRef}/handoff", "routePath": "/account/agent-approval-reviews/:approvalRef/handoff", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Prepare a runner approval review", "description": "Creates a hash-only handoff for a pending runner approval under the current owner or admin session. Current requester, dispatch, task, profile and policy authority are rechecked transactionally. This operation records no decision and issues no execution grant.", "requestSchemaRef": null, "responseSchemaRef": "prepareHumanAgentApprovalReview.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/prepare-human-agent-approval-review.md" } }, "markdownUrl": "/docs/api/prepare-human-agent-approval-review.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "getHumanAgentApprovalReview", "method": "GET", "path": "/api/account/agent-approval-reviews/{approvalRef}/{handoffRef}", "routePath": "/account/agent-approval-reviews/:approvalRef/:handoffRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Read a human approval review", "description": "Loads the complete supported request behind an opaque handoff under the current owner or admin session. The handoff grants no decision authority.", "requestSchemaRef": null, "responseSchemaRef": "getHumanAgentApprovalReview.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-human-agent-approval-review.md" } }, "markdownUrl": "/docs/api/get-human-agent-approval-review.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "decideHumanAgentApprovalReview", "method": "POST", "path": "/api/account/agent-approval-reviews/{approvalRef}/{handoffRef}/decision", "routePath": "/account/agent-approval-reviews/:approvalRef/:handoffRef/decision", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Decide the reviewed approval", "description": "Records one exact reviewed decision and its request-local answer in a transaction. Current authority, handoff, review hash and answer are rechecked on replay; recording a decision does not confirm execution.", "requestSchemaRef": null, "responseSchemaRef": "decideHumanAgentApprovalReview.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/decide-human-agent-approval-review.md" } }, "markdownUrl": "/docs/api/decide-human-agent-approval-review.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "getHumanAgentApprovalSettings", "method": "GET", "path": "/api/account/agent-approval-settings/{agentRef}", "routePath": "/account/agent-approval-settings/:agentRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: Get human agent approval settings", "description": "Returns the human agent approval settings scoped to the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getHumanAgentApprovalSettings.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-human-agent-approval-settings.md" } }, "markdownUrl": "/docs/api/get-human-agent-approval-settings.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "updateHumanAgentApprovalSettings", "method": "PATCH", "path": "/api/account/agent-approval-settings/{agentRef}", "routePath": "/account/agent-approval-settings/:agentRef", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: Update human agent approval settings", "description": "Updates human agent approval settings without changing tenant ownership.", "requestSchemaRef": "updateHumanAgentApprovalSettings.request.v1", "responseSchemaRef": "updateHumanAgentApprovalSettings.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/update-human-agent-approval-settings.md" } }, "markdownUrl": "/docs/api/update-human-agent-approval-settings.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "listHumanAgentApprovalDelegations", "method": "GET", "path": "/api/account/agent-approval-delegations?agentRef={agentRef}", "routePath": "/account/agent-approval-delegations", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: List human agent approval delegations", "description": "Lists human agent approval delegations scoped to the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "listHumanAgentApprovalDelegations.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/list-human-agent-approval-delegations.md" } }, "markdownUrl": "/docs/api/list-human-agent-approval-delegations.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "createHumanAgentApprovalDelegation", "method": "POST", "path": "/api/account/agent-approval-delegations", "routePath": "/account/agent-approval-delegations", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: Create human agent approval delegation", "description": "Creates human agent approval delegation and returns its stable reference after idempotency checks.", "requestSchemaRef": "createHumanAgentApprovalDelegation.request.v1", "responseSchemaRef": "createHumanAgentApprovalDelegation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/create-human-agent-approval-delegation.md" } }, "markdownUrl": "/docs/api/create-human-agent-approval-delegation.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "getHumanAgentApprovalDelegation", "method": "GET", "path": "/api/account/agent-approval-delegations/{delegationRef}", "routePath": "/account/agent-approval-delegations/:delegationRef", "requiredScope": null, "idempotencyRequired": false, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: Get human agent approval delegation", "description": "Returns the human agent approval delegation scoped to the verified tenant.", "requestSchemaRef": null, "responseSchemaRef": "getHumanAgentApprovalDelegation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/get-human-agent-approval-delegation.md" } }, "markdownUrl": "/docs/api/get-human-agent-approval-delegation.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } }, { "operationId": "revokeHumanAgentApprovalDelegation", "method": "POST", "path": "/api/account/agent-approval-delegations/{delegationRef}/revoke", "routePath": "/account/agent-approval-delegations/:delegationRef/revoke", "requiredScope": null, "idempotencyRequired": true, "surface": "human_rest", "authClass": "human_session", "availabilityPolicy": "human_session", "domain": "approvals", "requiredRolePolicy": "agent_approval_control", "approvalClass": "human_required", "approvalMode": "human", "billingRequirement": "included", "trustRequirement": "account_security", "status": "implemented", "launchState": "feature-gated", "availability": "available", "reason": null, "summary": "Approvals: Revoke human agent approval delegation", "description": "Revokes human agent approval delegation and rejects subsequent access.", "requestSchemaRef": "revokeHumanAgentApprovalDelegation.request.v1", "responseSchemaRef": "revokeHumanAgentApprovalDelegation.response.v1", "eventChannelRefs": [], "recommendsPairingFor": [], "artifactRefs": { "openApi": { "status": "implemented", "href": "/openapi.json" }, "jsonSchema": { "status": "implemented", "href": "/agent-public-contracts/v1/schemas.json" }, "arazzo": { "status": "implemented", "href": "/arazzo.yaml" }, "asyncApi": { "status": "planned", "href": "/asyncapi.yaml" }, "mcp": { "status": "not_exposed", "href": "/docs/mcp.md" }, "cli": { "status": "not_exposed", "href": "/docs/cli.md" }, "markdown": { "status": "implemented", "href": "/docs/api/revoke-human-agent-approval-delegation.md" } }, "markdownUrl": "/docs/api/revoke-human-agent-approval-delegation.md", "includedIn": [ "/docs/account/llms.txt", "/docs/security/llms.txt" ], "rest": { "status": "implemented", "resource": "https://neotask.ai/api/account", "pendingReason": null }, "mcp": { "status": "not_exposed", "resource": "https://neotask.ai/mcp", "toolName": null, "resourceRef": null, "pendingReason": "human_session_only" }, "cli": { "status": "not_exposed", "command": null, "outputSchemaRef": "AgentCliEnvelope.v1", "pendingReason": "human_session_only" } } ], "scopes": [ { "id": "root", "url": "/llms.txt", "domainOwner": "all public agent surfaces", "canonicalSkill": "/agent-onboarding/SKILL.md", "includedMarkdownPages": [], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "agent-onboarding", "url": "/agent-onboarding/llms.txt", "domainOwner": "onboarding", "canonicalSkill": "/agent-skills/account-and-approvals/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-companies.md", "/docs/api/get-agent-company.md", "/docs/api/list-agent-company-agents.md", "/docs/api/list-insight-boards.md", "/docs/api/get-insight-board.md", "/docs/api/get-insight-board-publication.md", "/docs/api/publish-insight-board.md", "/docs/api/unpublish-insight-board.md", "/docs/api/rotate-insight-board-link.md", "/docs/api/set-insight-board-visibility.md", "/docs/api/list-insight-board-grants.md", "/docs/api/create-insight-board-grant.md", "/docs/api/revoke-insight-board-grant.md", "/docs/api/get-agent-profile.md", "/docs/api/get-agent-capabilities.md", "/docs/api/get-agent-onboarding.md", "/docs/api/list-agents.md", "/docs/api/create-agent.md", "/docs/api/get-agent.md", "/docs/api/update-agent.md", "/docs/api/archive-agent.md", "/docs/api/restore-agent.md", "/docs/api/get-agent-effective-tools.md", "/docs/api/get-agent-tool-policy.md", "/docs/api/update-agent-tool-policy.md", "/docs/api/get-usage.md", "/docs/api/list-desktop-download-options.md", "/docs/api/revoke-registration.md", "/docs/api/create-agent-account-pairing-handoff.md", "/docs/api/get-agent-account-pairing-handoff.md", "/docs/api/cancel-agent-account-pairing-handoff.md", "/docs/api/get-human-agent-account-pairing-handoff.md", "/docs/api/confirm-human-agent-account-pairing-handoff.md", "/docs/api/list-human-agent-registrations.md", "/docs/api/update-human-agent-registration-label.md", "/docs/api/revoke-human-agent-registration.md", "/docs/api/list-human-agent-runners.md", "/docs/api/inspect-human-runner-enrollment-review.md", "/docs/api/resolve-human-runner-enrollment-review.md", "/docs/api/inspect-human-agent-claim-move.md", "/docs/api/resolve-human-agent-claim-move.md", "/docs/api/update-human-agent-runner-label.md", "/docs/api/rotate-human-agent-runner.md", "/docs/api/revoke-human-agent-runner.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "api", "url": "/docs/api/llms.txt", "domainOwner": "public operation registry", "canonicalSkill": null, "includedMarkdownPages": [ "/docs/api/list-agent-companies.md", "/docs/api/get-agent-company.md", "/docs/api/list-agent-company-agents.md", "/docs/api/list-agent-company-tasks.md", "/docs/api/get-agent-company-task.md", "/docs/api/list-agent-company-runs.md", "/docs/api/get-agent-company-run.md", "/docs/api/list-insight-boards.md", "/docs/api/get-insight-board.md", "/docs/api/get-insight-board-publication.md", "/docs/api/publish-insight-board.md", "/docs/api/unpublish-insight-board.md", "/docs/api/rotate-insight-board-link.md", "/docs/api/set-insight-board-visibility.md", "/docs/api/list-insight-board-grants.md", "/docs/api/create-insight-board-grant.md", "/docs/api/revoke-insight-board-grant.md", "/docs/api/get-agent-profile.md", "/docs/api/get-agent-capabilities.md", "/docs/api/get-agent-onboarding.md", "/docs/api/list-agents.md", "/docs/api/create-agent.md", "/docs/api/get-agent.md", "/docs/api/update-agent.md", "/docs/api/archive-agent.md", "/docs/api/restore-agent.md", "/docs/api/get-agent-effective-tools.md", "/docs/api/get-agent-tool-policy.md", "/docs/api/update-agent-tool-policy.md", "/docs/api/list-agent-conversations.md", "/docs/api/create-agent-conversation.md", "/docs/api/get-agent-conversation.md", "/docs/api/archive-agent-conversation.md", "/docs/api/restore-agent-conversation.md", "/docs/api/list-agent-conversation-messages.md", "/docs/api/create-agent-conversation-turn.md", "/docs/api/get-agent-conversation-turn.md", "/docs/api/cancel-agent-conversation-turn.md", "/docs/api/list-agent-conversation-turn-events.md", "/docs/api/stream-agent-conversation-turn-events.md", "/docs/api/list-tasks.md", "/docs/api/create-task.md", "/docs/api/list-agent-cron-jobs.md", "/docs/api/create-agent-cron-job.md", "/docs/api/get-agent-cron-job.md", "/docs/api/update-agent-cron-job.md", "/docs/api/enable-agent-cron-job.md", "/docs/api/disable-agent-cron-job.md", "/docs/api/run-agent-cron-job.md", "/docs/api/list-agent-cron-job-runs.md", "/docs/api/delete-agent-cron-job.md", "/docs/api/list-agent-automation-catalog.md", "/docs/api/list-agent-automations.md", "/docs/api/create-agent-automation.md", "/docs/api/get-agent-automation.md", "/docs/api/update-agent-automation.md", "/docs/api/delete-agent-automation.md", "/docs/api/start-agent-automation.md", "/docs/api/get-agent-automation-status.md", "/docs/api/pause-agent-automation.md", "/docs/api/resume-agent-automation.md", "/docs/api/cancel-agent-automation.md", "/docs/api/list-agent-automation-runs.md", "/docs/api/get-run.md", "/docs/api/create-run.md", "/docs/api/list-agent-run-events.md", "/docs/api/stream-agent-run-events.md", "/docs/api/list-agent-autonomy-goals.md", "/docs/api/create-agent-autonomy-goal.md", "/docs/api/get-agent-autonomy-goal.md", "/docs/api/update-agent-autonomy-goal.md", "/docs/api/start-agent-autonomy-goal.md", "/docs/api/get-agent-autonomy-goal-status.md", "/docs/api/steer-agent-autonomy-goal.md", "/docs/api/pause-agent-autonomy-goal.md", "/docs/api/resume-agent-autonomy-goal.md", "/docs/api/cancel-agent-autonomy-goal.md", "/docs/api/list-agent-autonomy-goal-runs.md", "/docs/api/list-agent-approvals.md", "/docs/api/get-agent-approval.md", "/docs/api/create-agent-approval-handoff.md", "/docs/api/get-agent-approval-handoff.md", "/docs/api/cancel-agent-approval-handoff.md", "/docs/api/list-agent-approval-events.md", "/docs/api/stream-agent-approval-events.md", "/docs/api/get-effective-agent-approval-policy.md", "/docs/api/create-agent-approval-settings-handoff.md", "/docs/api/get-agent-approval-settings-handoff.md", "/docs/api/cancel-agent-approval-settings-handoff.md", "/docs/api/decide-agent-approval.md", "/docs/api/get-usage.md", "/docs/api/list-agent-skills.md", "/docs/api/list-desktop-download-options.md", "/docs/api/request-agent-skill-configuration.md", "/docs/api/get-agent-mcp-catalog.md", "/docs/api/get-agent-cli-metadata.md", "/docs/api/list-agent-models.md", "/docs/api/set-agent-model.md", "/docs/api/get-agent-mail-capabilities.md", "/docs/api/request-agent-mail-membership.md", "/docs/api/join-agent-mail-membership.md", "/docs/api/get-agent-mail-membership.md", "/docs/api/approve-agent-mail-membership.md", "/docs/api/suspend-agent-mail-membership.md", "/docs/api/leave-agent-mail-membership.md", "/docs/api/revoke-agent-mail-membership.md", "/docs/api/list-agent-mail-identities.md", "/docs/api/get-agent-mail-identity.md", "/docs/api/list-agent-mail-peers.md", "/docs/api/get-agent-mail-peer.md", "/docs/api/send-agent-mail-message.md", "/docs/api/reply-agent-mail-message.md", "/docs/api/list-agent-mail-inbox.md", "/docs/api/get-agent-mail-events.md", "/docs/api/get-agent-mail-delivery.md", "/docs/api/acknowledge-agent-mail-delivery.md", "/docs/api/mark-agent-mail-read.md", "/docs/api/revoke-registration.md", "/docs/api/create-agent-account-pairing-handoff.md", "/docs/api/request-agent-checkout-handoff.md", "/docs/api/get-agent-account-pairing-handoff.md", "/docs/api/cancel-agent-account-pairing-handoff.md", "/docs/api/create-runner-enrollment.md", "/docs/api/list-agent-runners.md", "/docs/api/rotate-agent-runner.md", "/docs/api/revoke-agent-runner.md", "/docs/api/list-agent-integration-catalog.md", "/docs/api/list-agent-integration-connections.md", "/docs/api/create-agent-integration-attempt.md", "/docs/api/get-agent-integration-attempt.md", "/docs/api/cancel-agent-integration-attempt.md", "/docs/api/attach-agent-integration.md", "/docs/api/detach-agent-integration.md", "/docs/api/revoke-agent-integration.md", "/docs/api/get-agent-mail-thread.md", "/docs/api/search-agent-mail-threads.md", "/docs/api/summarize-agent-mail-thread.md", "/docs/api/request-agent-mail-contact.md", "/docs/api/respond-agent-mail-contact.md", "/docs/api/list-agent-mail-contacts.md", "/docs/api/set-agent-mail-contact-policy.md", "/docs/api/list-agent-mail-sectors.md", "/docs/api/get-agent-mail-sector-feed.md", "/docs/api/broadcast-agent-mail-sector.md", "/docs/api/announce-agent-mail-handoff.md", "/docs/api/attach-agent-mail-trace.md", "/docs/api/wait-for-agent-mail-events.md", "/docs/api/recover-agent-mail-events.md", "/docs/api/export-agent-mail-data.md", "/docs/api/erase-agent-mail-data.md", "/docs/api/revoke-agent-mail-access.md", "/docs/api/search-construct-packages.md", "/docs/api/get-construct-package.md", "/docs/api/list-construct-package-versions.md", "/docs/api/get-construct-release-readiness.md", "/docs/api/match-construct-content.md", "/docs/api/resolve-construct-artifact.md", "/docs/api/get-construct-grant-manifest.md", "/docs/api/report-construct-install.md", "/docs/api/report-construct-package.md", "/docs/api/get-human-agent-integration-credential-handoff.md", "/docs/api/complete-human-agent-integration-credential-handoff.md", "/docs/api/get-human-agent-account-pairing-handoff.md", "/docs/api/confirm-human-agent-account-pairing-handoff.md", "/docs/api/list-human-agent-registrations.md", "/docs/api/update-human-agent-registration-label.md", "/docs/api/revoke-human-agent-registration.md", "/docs/api/list-human-agent-runners.md", "/docs/api/inspect-human-runner-enrollment-review.md", "/docs/api/resolve-human-runner-enrollment-review.md", "/docs/api/inspect-human-agent-claim-move.md", "/docs/api/resolve-human-agent-claim-move.md", "/docs/api/update-human-agent-runner-label.md", "/docs/api/rotate-human-agent-runner.md", "/docs/api/revoke-human-agent-runner.md", "/docs/api/cancel-human-agent-approval-settings-handoff.md", "/docs/api/prepare-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-review.md", "/docs/api/decide-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-settings.md", "/docs/api/update-human-agent-approval-settings.md", "/docs/api/list-human-agent-approval-delegations.md", "/docs/api/create-human-agent-approval-delegation.md", "/docs/api/get-human-agent-approval-delegation.md", "/docs/api/revoke-human-agent-approval-delegation.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "cli", "url": "/docs/cli/llms.txt", "domainOwner": "cli", "canonicalSkill": "/agent-skills/tools-models-and-skills/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-skills.md", "/docs/api/request-agent-skill-configuration.md", "/docs/api/get-agent-cli-metadata.md", "/docs/api/list-agent-models.md", "/docs/api/set-agent-model.md", "/docs/api/search-construct-packages.md", "/docs/api/get-construct-package.md", "/docs/api/list-construct-package-versions.md", "/docs/api/get-construct-release-readiness.md", "/docs/api/match-construct-content.md", "/docs/api/resolve-construct-artifact.md", "/docs/api/get-construct-grant-manifest.md", "/docs/api/report-construct-install.md", "/docs/api/report-construct-package.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "mcp", "url": "/docs/mcp/llms.txt", "domainOwner": "mcp", "canonicalSkill": "/agent-skills/tools-models-and-skills/SKILL.md", "includedMarkdownPages": [ "/docs/api/get-agent-mcp-catalog.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "chat", "url": "/docs/chat/llms.txt", "domainOwner": "chat", "canonicalSkill": "/agent-skills/chat/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-company-tasks.md", "/docs/api/get-agent-company-task.md", "/docs/api/list-agent-company-runs.md", "/docs/api/get-agent-company-run.md", "/docs/api/list-agent-conversations.md", "/docs/api/create-agent-conversation.md", "/docs/api/get-agent-conversation.md", "/docs/api/archive-agent-conversation.md", "/docs/api/restore-agent-conversation.md", "/docs/api/list-agent-conversation-messages.md", "/docs/api/create-agent-conversation-turn.md", "/docs/api/get-agent-conversation-turn.md", "/docs/api/cancel-agent-conversation-turn.md", "/docs/api/list-agent-conversation-turn-events.md", "/docs/api/stream-agent-conversation-turn-events.md", "/docs/api/list-tasks.md", "/docs/api/create-task.md", "/docs/api/get-run.md", "/docs/api/create-run.md", "/docs/api/list-agent-run-events.md", "/docs/api/stream-agent-run-events.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "automations", "url": "/docs/automations/llms.txt", "domainOwner": "automation", "canonicalSkill": "/agent-skills/automations/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-cron-jobs.md", "/docs/api/create-agent-cron-job.md", "/docs/api/get-agent-cron-job.md", "/docs/api/update-agent-cron-job.md", "/docs/api/enable-agent-cron-job.md", "/docs/api/disable-agent-cron-job.md", "/docs/api/run-agent-cron-job.md", "/docs/api/list-agent-cron-job-runs.md", "/docs/api/delete-agent-cron-job.md", "/docs/api/list-agent-automation-catalog.md", "/docs/api/list-agent-automations.md", "/docs/api/create-agent-automation.md", "/docs/api/get-agent-automation.md", "/docs/api/update-agent-automation.md", "/docs/api/delete-agent-automation.md", "/docs/api/start-agent-automation.md", "/docs/api/get-agent-automation-status.md", "/docs/api/pause-agent-automation.md", "/docs/api/resume-agent-automation.md", "/docs/api/cancel-agent-automation.md", "/docs/api/list-agent-automation-runs.md", "/docs/api/list-agent-autonomy-goals.md", "/docs/api/create-agent-autonomy-goal.md", "/docs/api/get-agent-autonomy-goal.md", "/docs/api/update-agent-autonomy-goal.md", "/docs/api/start-agent-autonomy-goal.md", "/docs/api/get-agent-autonomy-goal-status.md", "/docs/api/steer-agent-autonomy-goal.md", "/docs/api/pause-agent-autonomy-goal.md", "/docs/api/resume-agent-autonomy-goal.md", "/docs/api/cancel-agent-autonomy-goal.md", "/docs/api/list-agent-autonomy-goal-runs.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "integrations", "url": "/docs/integrations/llms.txt", "domainOwner": "integration", "canonicalSkill": "/agent-skills/integrations/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-integration-catalog.md", "/docs/api/list-agent-integration-connections.md", "/docs/api/create-agent-integration-attempt.md", "/docs/api/get-agent-integration-attempt.md", "/docs/api/cancel-agent-integration-attempt.md", "/docs/api/attach-agent-integration.md", "/docs/api/detach-agent-integration.md", "/docs/api/revoke-agent-integration.md", "/docs/api/get-human-agent-integration-credential-handoff.md", "/docs/api/complete-human-agent-integration-credential-handoff.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "mail", "url": "/docs/mail/llms.txt", "domainOwner": "coordination_mail", "canonicalSkill": "/agent-skills/mail/SKILL.md", "includedMarkdownPages": [ "/docs/api/get-agent-mail-capabilities.md", "/docs/api/request-agent-mail-membership.md", "/docs/api/join-agent-mail-membership.md", "/docs/api/get-agent-mail-membership.md", "/docs/api/approve-agent-mail-membership.md", "/docs/api/suspend-agent-mail-membership.md", "/docs/api/leave-agent-mail-membership.md", "/docs/api/revoke-agent-mail-membership.md", "/docs/api/list-agent-mail-identities.md", "/docs/api/get-agent-mail-identity.md", "/docs/api/list-agent-mail-peers.md", "/docs/api/get-agent-mail-peer.md", "/docs/api/send-agent-mail-message.md", "/docs/api/reply-agent-mail-message.md", "/docs/api/list-agent-mail-inbox.md", "/docs/api/get-agent-mail-events.md", "/docs/api/get-agent-mail-delivery.md", "/docs/api/acknowledge-agent-mail-delivery.md", "/docs/api/mark-agent-mail-read.md", "/docs/api/get-agent-mail-thread.md", "/docs/api/search-agent-mail-threads.md", "/docs/api/summarize-agent-mail-thread.md", "/docs/api/request-agent-mail-contact.md", "/docs/api/respond-agent-mail-contact.md", "/docs/api/list-agent-mail-contacts.md", "/docs/api/set-agent-mail-contact-policy.md", "/docs/api/list-agent-mail-sectors.md", "/docs/api/get-agent-mail-sector-feed.md", "/docs/api/broadcast-agent-mail-sector.md", "/docs/api/announce-agent-mail-handoff.md", "/docs/api/attach-agent-mail-trace.md", "/docs/api/wait-for-agent-mail-events.md", "/docs/api/recover-agent-mail-events.md", "/docs/api/export-agent-mail-data.md", "/docs/api/erase-agent-mail-data.md", "/docs/api/revoke-agent-mail-access.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "runner", "url": "/docs/runner/llms.txt", "domainOwner": "runner", "canonicalSkill": "/agent-skills/runner-and-desktop/SKILL.md", "includedMarkdownPages": [ "/docs/api/create-runner-enrollment.md", "/docs/api/list-agent-runners.md", "/docs/api/rotate-agent-runner.md", "/docs/api/revoke-agent-runner.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "account", "url": "/docs/account/llms.txt", "domainOwner": "account", "canonicalSkill": "/agent-skills/account-and-approvals/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-companies.md", "/docs/api/get-agent-company.md", "/docs/api/list-agent-company-agents.md", "/docs/api/list-insight-boards.md", "/docs/api/get-insight-board.md", "/docs/api/get-insight-board-publication.md", "/docs/api/publish-insight-board.md", "/docs/api/unpublish-insight-board.md", "/docs/api/rotate-insight-board-link.md", "/docs/api/set-insight-board-visibility.md", "/docs/api/list-insight-board-grants.md", "/docs/api/create-insight-board-grant.md", "/docs/api/revoke-insight-board-grant.md", "/docs/api/get-agent-profile.md", "/docs/api/get-agent-capabilities.md", "/docs/api/get-agent-onboarding.md", "/docs/api/list-agents.md", "/docs/api/create-agent.md", "/docs/api/get-agent.md", "/docs/api/update-agent.md", "/docs/api/archive-agent.md", "/docs/api/restore-agent.md", "/docs/api/get-agent-effective-tools.md", "/docs/api/get-agent-tool-policy.md", "/docs/api/update-agent-tool-policy.md", "/docs/api/list-agent-approvals.md", "/docs/api/get-agent-approval.md", "/docs/api/create-agent-approval-handoff.md", "/docs/api/get-agent-approval-handoff.md", "/docs/api/cancel-agent-approval-handoff.md", "/docs/api/list-agent-approval-events.md", "/docs/api/stream-agent-approval-events.md", "/docs/api/get-effective-agent-approval-policy.md", "/docs/api/create-agent-approval-settings-handoff.md", "/docs/api/get-agent-approval-settings-handoff.md", "/docs/api/cancel-agent-approval-settings-handoff.md", "/docs/api/decide-agent-approval.md", "/docs/api/get-usage.md", "/docs/api/list-desktop-download-options.md", "/docs/api/revoke-registration.md", "/docs/api/create-agent-account-pairing-handoff.md", "/docs/api/request-agent-checkout-handoff.md", "/docs/api/get-agent-account-pairing-handoff.md", "/docs/api/cancel-agent-account-pairing-handoff.md", "/docs/api/get-human-agent-account-pairing-handoff.md", "/docs/api/confirm-human-agent-account-pairing-handoff.md", "/docs/api/list-human-agent-registrations.md", "/docs/api/update-human-agent-registration-label.md", "/docs/api/revoke-human-agent-registration.md", "/docs/api/list-human-agent-runners.md", "/docs/api/inspect-human-runner-enrollment-review.md", "/docs/api/resolve-human-runner-enrollment-review.md", "/docs/api/inspect-human-agent-claim-move.md", "/docs/api/resolve-human-agent-claim-move.md", "/docs/api/update-human-agent-runner-label.md", "/docs/api/rotate-human-agent-runner.md", "/docs/api/revoke-human-agent-runner.md", "/docs/api/cancel-human-agent-approval-settings-handoff.md", "/docs/api/prepare-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-review.md", "/docs/api/decide-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-settings.md", "/docs/api/update-human-agent-approval-settings.md", "/docs/api/list-human-agent-approval-delegations.md", "/docs/api/create-human-agent-approval-delegation.md", "/docs/api/get-human-agent-approval-delegation.md", "/docs/api/revoke-human-agent-approval-delegation.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" }, { "id": "security", "url": "/docs/security/llms.txt", "domainOwner": "security and lifecycle controls", "canonicalSkill": "/agent-skills/security-and-data/SKILL.md", "includedMarkdownPages": [ "/docs/api/list-agent-companies.md", "/docs/api/get-agent-company.md", "/docs/api/list-agent-company-agents.md", "/docs/api/list-insight-boards.md", "/docs/api/get-insight-board.md", "/docs/api/get-insight-board-publication.md", "/docs/api/publish-insight-board.md", "/docs/api/unpublish-insight-board.md", "/docs/api/rotate-insight-board-link.md", "/docs/api/set-insight-board-visibility.md", "/docs/api/list-insight-board-grants.md", "/docs/api/create-insight-board-grant.md", "/docs/api/revoke-insight-board-grant.md", "/docs/api/get-agent-profile.md", "/docs/api/list-agents.md", "/docs/api/create-agent.md", "/docs/api/get-agent.md", "/docs/api/update-agent.md", "/docs/api/archive-agent.md", "/docs/api/restore-agent.md", "/docs/api/get-agent-effective-tools.md", "/docs/api/get-agent-tool-policy.md", "/docs/api/update-agent-tool-policy.md", "/docs/api/list-agent-approvals.md", "/docs/api/get-agent-approval.md", "/docs/api/create-agent-approval-handoff.md", "/docs/api/get-agent-approval-handoff.md", "/docs/api/cancel-agent-approval-handoff.md", "/docs/api/list-agent-approval-events.md", "/docs/api/stream-agent-approval-events.md", "/docs/api/get-effective-agent-approval-policy.md", "/docs/api/create-agent-approval-settings-handoff.md", "/docs/api/get-agent-approval-settings-handoff.md", "/docs/api/cancel-agent-approval-settings-handoff.md", "/docs/api/decide-agent-approval.md", "/docs/api/get-usage.md", "/docs/api/list-desktop-download-options.md", "/docs/api/revoke-agent-mail-membership.md", "/docs/api/revoke-registration.md", "/docs/api/create-agent-account-pairing-handoff.md", "/docs/api/request-agent-checkout-handoff.md", "/docs/api/get-agent-account-pairing-handoff.md", "/docs/api/cancel-agent-account-pairing-handoff.md", "/docs/api/revoke-agent-runner.md", "/docs/api/revoke-agent-integration.md", "/docs/api/export-agent-mail-data.md", "/docs/api/erase-agent-mail-data.md", "/docs/api/revoke-agent-mail-access.md", "/docs/api/get-human-agent-account-pairing-handoff.md", "/docs/api/confirm-human-agent-account-pairing-handoff.md", "/docs/api/list-human-agent-registrations.md", "/docs/api/update-human-agent-registration-label.md", "/docs/api/revoke-human-agent-registration.md", "/docs/api/list-human-agent-runners.md", "/docs/api/inspect-human-runner-enrollment-review.md", "/docs/api/resolve-human-runner-enrollment-review.md", "/docs/api/inspect-human-agent-claim-move.md", "/docs/api/resolve-human-agent-claim-move.md", "/docs/api/update-human-agent-runner-label.md", "/docs/api/rotate-human-agent-runner.md", "/docs/api/revoke-human-agent-runner.md", "/docs/api/cancel-human-agent-approval-settings-handoff.md", "/docs/api/prepare-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-review.md", "/docs/api/decide-human-agent-approval-review.md", "/docs/api/get-human-agent-approval-settings.md", "/docs/api/update-human-agent-approval-settings.md", "/docs/api/list-human-agent-approval-delegations.md", "/docs/api/create-human-agent-approval-delegation.md", "/docs/api/get-human-agent-approval-delegation.md", "/docs/api/revoke-human-agent-approval-delegation.md" ], "minimumContractVersion": "v1", "replacements": [], "redirects": [], "launchState": "live", "authenticatedCapabilitiesUrl": "/api/agent/v1/capabilities" } ], "skills": [ { "id": "account-and-approvals", "url": "/agent-skills/account-and-approvals/SKILL.md", "scopeId": "account", "operationIds": [ "listAgentCompanies", "getAgentCompany", "listAgentCompanyAgents", "listInsightBoards", "getInsightBoard", "getInsightBoardPublication", "publishInsightBoard", "unpublishInsightBoard", "rotateInsightBoardLink", "setInsightBoardVisibility", "listInsightBoardGrants", "createInsightBoardGrant", "revokeInsightBoardGrant", "getAgentProfile", "getAgentCapabilities", "getAgentOnboarding", "listAgents", "createAgent", "getAgent", "updateAgent", "archiveAgent", "restoreAgent", "getAgentEffectiveTools", "getAgentToolPolicy", "updateAgentToolPolicy", "listAgentApprovals", "getAgentApproval", "createAgentApprovalHandoff", "getAgentApprovalHandoff", "cancelAgentApprovalHandoff", "listAgentApprovalEvents", "streamAgentApprovalEvents", "getEffectiveAgentApprovalPolicy", "createAgentApprovalSettingsHandoff", "getAgentApprovalSettingsHandoff", "cancelAgentApprovalSettingsHandoff", "decideAgentApproval", "getUsage", "listDesktopDownloadOptions", "revokeAgentRegistration", "createAgentAccountPairingHandoff", "requestAgentCheckoutHandoff", "getAgentAccountPairingHandoff", "cancelAgentAccountPairingHandoff", "getHumanAgentAccountPairingHandoff", "confirmHumanAgentAccountPairingHandoff", "listHumanAgentRegistrations", "updateHumanAgentRegistrationLabel", "revokeHumanAgentRegistration", "listHumanAgentRunners", "inspectHumanRunnerEnrollmentReview", "resolveHumanRunnerEnrollmentReview", "inspectHumanAgentClaimMove", "resolveHumanAgentClaimMove", "updateHumanAgentRunnerLabel", "rotateHumanAgentRunner", "revokeHumanAgentRunner", "cancelHumanAgentApprovalSettingsHandoff", "prepareHumanAgentApprovalReview", "getHumanAgentApprovalReview", "decideHumanAgentApprovalReview", "getHumanAgentApprovalSettings", "updateHumanAgentApprovalSettings", "listHumanAgentApprovalDelegations", "createHumanAgentApprovalDelegation", "getHumanAgentApprovalDelegation", "revokeHumanAgentApprovalDelegation" ] }, { "id": "chat", "url": "/agent-skills/chat/SKILL.md", "scopeId": "chat", "operationIds": [ "listAgentCompanyTasks", "getAgentCompanyTask", "listAgentCompanyRuns", "getAgentCompanyRun", "listAgentConversations", "createAgentConversation", "getAgentConversation", "archiveAgentConversation", "restoreAgentConversation", "listAgentConversationMessages", "createAgentConversationTurn", "getAgentConversationTurn", "cancelAgentConversationTurn", "listAgentConversationTurnEvents", "streamAgentConversationTurnEvents", "listTasks", "createTask", "getRun", "createRun", "listAgentRunEvents", "streamAgentRunEvents" ] }, { "id": "tools-models-and-skills", "url": "/agent-skills/tools-models-and-skills/SKILL.md", "scopeId": "cli", "operationIds": [ "listAgentSkills", "requestAgentSkillConfiguration", "getAgentMcpCatalog", "getAgentCliMetadata", "listAgentModels", "setAgentModel", "searchConstructPackages", "getConstructPackage", "listConstructPackageVersions", "getConstructReleaseReadiness", "matchConstructContent", "resolveConstructArtifact", "getConstructGrantManifest", "reportConstructInstall", "reportConstructPackage" ] }, { "id": "automations", "url": "/agent-skills/automations/SKILL.md", "scopeId": "automations", "operationIds": [ "listAgentCronJobs", "createAgentCronJob", "getAgentCronJob", "updateAgentCronJob", "enableAgentCronJob", "disableAgentCronJob", "runAgentCronJob", "listAgentCronJobRuns", "deleteAgentCronJob", "listAgentAutomationCatalog", "listAgentAutomations", "createAgentAutomation", "getAgentAutomation", "updateAgentAutomation", "deleteAgentAutomation", "startAgentAutomation", "getAgentAutomationStatus", "pauseAgentAutomation", "resumeAgentAutomation", "cancelAgentAutomation", "listAgentAutomationRuns", "listAgentAutonomyGoals", "createAgentAutonomyGoal", "getAgentAutonomyGoal", "updateAgentAutonomyGoal", "startAgentAutonomyGoal", "getAgentAutonomyGoalStatus", "steerAgentAutonomyGoal", "pauseAgentAutonomyGoal", "resumeAgentAutonomyGoal", "cancelAgentAutonomyGoal", "listAgentAutonomyGoalRuns" ] }, { "id": "integrations", "url": "/agent-skills/integrations/SKILL.md", "scopeId": "integrations", "operationIds": [ "listAgentIntegrationCatalog", "listAgentIntegrationConnections", "createAgentIntegrationAttempt", "getAgentIntegrationAttempt", "cancelAgentIntegrationAttempt", "attachAgentIntegration", "detachAgentIntegration", "revokeAgentIntegration", "getHumanAgentIntegrationCredentialHandoff", "completeHumanAgentIntegrationCredentialHandoff" ] }, { "id": "runner-and-desktop", "url": "/agent-skills/runner-and-desktop/SKILL.md", "scopeId": "runner", "operationIds": [ "createRunnerEnrollment", "listAgentRunners", "rotateAgentRunner", "revokeAgentRunner" ] }, { "id": "mail", "url": "/agent-skills/mail/SKILL.md", "scopeId": "mail", "operationIds": [ "getAgentMailCapabilities", "requestAgentMailMembership", "joinAgentMailMembership", "getAgentMailMembership", "approveAgentMailMembership", "suspendAgentMailMembership", "leaveAgentMailMembership", "revokeAgentMailMembership", "listAgentMailIdentities", "getAgentMailIdentity", "listAgentMailPeers", "getAgentMailPeer", "sendAgentMailMessage", "replyAgentMailMessage", "listAgentMailInbox", "getAgentMailEvents", "getAgentMailDelivery", "acknowledgeAgentMailDelivery", "markAgentMailRead", "getAgentMailThread", "searchAgentMailThreads", "summarizeAgentMailThread", "requestAgentMailContact", "respondAgentMailContact", "listAgentMailContacts", "setAgentMailContactPolicy", "listAgentMailSectors", "getAgentMailSectorFeed", "broadcastAgentMailSector", "announceAgentMailHandoff", "attachAgentMailTrace", "waitForAgentMailEvents", "recoverAgentMailEvents", "exportAgentMailData", "eraseAgentMailData", "revokeAgentMailAccess" ] }, { "id": "billing-pairing-and-lifecycle", "url": "/agent-skills/billing-pairing-and-lifecycle/SKILL.md", "scopeId": "account", "operationIds": [ "listAgentCompanies", "getAgentCompany", "listAgentCompanyAgents", "listInsightBoards", "getInsightBoard", "getInsightBoardPublication", "publishInsightBoard", "unpublishInsightBoard", "rotateInsightBoardLink", "setInsightBoardVisibility", "listInsightBoardGrants", "createInsightBoardGrant", "revokeInsightBoardGrant", "getAgentProfile", "listAgents", "createAgent", "getAgent", "updateAgent", "archiveAgent", "restoreAgent", "getAgentEffectiveTools", "getAgentToolPolicy", "updateAgentToolPolicy", "getUsage", "listDesktopDownloadOptions", "revokeAgentRegistration", "createAgentAccountPairingHandoff", "requestAgentCheckoutHandoff", "getAgentAccountPairingHandoff", "cancelAgentAccountPairingHandoff", "getHumanAgentAccountPairingHandoff", "confirmHumanAgentAccountPairingHandoff", "listHumanAgentRegistrations", "updateHumanAgentRegistrationLabel", "revokeHumanAgentRegistration", "listHumanAgentRunners", "inspectHumanRunnerEnrollmentReview", "resolveHumanRunnerEnrollmentReview", "inspectHumanAgentClaimMove", "resolveHumanAgentClaimMove", "updateHumanAgentRunnerLabel", "rotateHumanAgentRunner", "revokeHumanAgentRunner" ] }, { "id": "security-and-data", "url": "/agent-skills/security-and-data/SKILL.md", "scopeId": "security", "operationIds": [ "listAgentCompanies", "getAgentCompany", "listAgentCompanyAgents", "listInsightBoards", "getInsightBoard", "getInsightBoardPublication", "publishInsightBoard", "unpublishInsightBoard", "rotateInsightBoardLink", "setInsightBoardVisibility", "listInsightBoardGrants", "createInsightBoardGrant", "revokeInsightBoardGrant", "getAgentProfile", "listAgents", "createAgent", "getAgent", "updateAgent", "archiveAgent", "restoreAgent", "getAgentEffectiveTools", "getAgentToolPolicy", "updateAgentToolPolicy", "listAgentApprovals", "getAgentApproval", "createAgentApprovalHandoff", "getAgentApprovalHandoff", "cancelAgentApprovalHandoff", "listAgentApprovalEvents", "streamAgentApprovalEvents", "getEffectiveAgentApprovalPolicy", "createAgentApprovalSettingsHandoff", "getAgentApprovalSettingsHandoff", "cancelAgentApprovalSettingsHandoff", "decideAgentApproval", "getUsage", "listDesktopDownloadOptions", "revokeAgentMailMembership", "revokeAgentRegistration", "createAgentAccountPairingHandoff", "requestAgentCheckoutHandoff", "getAgentAccountPairingHandoff", "cancelAgentAccountPairingHandoff", "revokeAgentRunner", "revokeAgentIntegration", "exportAgentMailData", "eraseAgentMailData", "revokeAgentMailAccess", "getHumanAgentAccountPairingHandoff", "confirmHumanAgentAccountPairingHandoff", "listHumanAgentRegistrations", "updateHumanAgentRegistrationLabel", "revokeHumanAgentRegistration", "listHumanAgentRunners", "inspectHumanRunnerEnrollmentReview", "resolveHumanRunnerEnrollmentReview", "inspectHumanAgentClaimMove", "resolveHumanAgentClaimMove", "updateHumanAgentRunnerLabel", "rotateHumanAgentRunner", "revokeHumanAgentRunner", "cancelHumanAgentApprovalSettingsHandoff", "prepareHumanAgentApprovalReview", "getHumanAgentApprovalReview", "decideHumanAgentApprovalReview", "getHumanAgentApprovalSettings", "updateHumanAgentApprovalSettings", "listHumanAgentApprovalDelegations", "createHumanAgentApprovalDelegation", "getHumanAgentApprovalDelegation", "revokeHumanAgentApprovalDelegation" ] } ], "entryPoints": { "onboardingSkill": "/agent-onboarding/SKILL.md", "authentication": "/auth.md", "capabilities": "/api/agent/v1/capabilities", "contractBundle": "/agent-public-contracts/v1/bundle.json", "operations": "/agent-public-contracts/v1/operations.json", "apiDocs": "/docs/api/llms.txt", "compatibility": "/llms-full.txt", "mcpResource": "https://neotask.ai/mcp" } }