# Chat and runs

Launch state: **Live**. This index is generated from the public operation registry (contract v1).

Domain owner: **chat**.
- Canonical skill: [/agent-skills/chat/SKILL.md](https://neotask.ai/agent-skills/chat/SKILL.md)
- Authenticated capability snapshot: [/api/agent/v1/capabilities](https://neotask.ai/api/agent/v1/capabilities)
- Knowledge manifest: [/agent-public-contracts/v1/knowledge-manifest.json](https://neotask.ai/agent-public-contracts/v1/knowledge-manifest.json)

Read the capability snapshot before a request. A page documents the contract; it does not grant access. Planned rows are listed for discovery and have no mounted route.

## Operation pages

- [List company tasks](https://neotask.ai/docs/api/list-agent-company-tasks.md): `GET /api/agent/v1/companies/{companyRef}/tasks`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Read a company task](https://neotask.ai/docs/api/get-agent-company-task.md): `GET /api/agent/v1/companies/{companyRef}/tasks/{taskRef}`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [List company runs](https://neotask.ai/docs/api/list-agent-company-runs.md): `GET /api/agent/v1/companies/{companyRef}/runs`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Read a company run](https://neotask.ai/docs/api/get-agent-company-run.md): `GET /api/agent/v1/companies/{companyRef}/runs/{runRef}`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [List agent conversations](https://neotask.ai/docs/api/list-agent-conversations.md): `GET /api/agent/v1/conversations`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [Create an agent conversation](https://neotask.ai/docs/api/create-agent-conversation.md): `POST /api/agent/v1/conversations`, scope `neotask:conversations:write`, status **implemented**, reason `none`
- [Read an agent conversation](https://neotask.ai/docs/api/get-agent-conversation.md): `GET /api/agent/v1/conversations/{conversationRef}`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [Archive an agent conversation](https://neotask.ai/docs/api/archive-agent-conversation.md): `POST /api/agent/v1/conversations/{conversationRef}/archive`, scope `neotask:conversations:write`, status **implemented**, reason `none`
- [Restore an agent conversation](https://neotask.ai/docs/api/restore-agent-conversation.md): `POST /api/agent/v1/conversations/{conversationRef}/restore`, scope `neotask:conversations:write`, status **implemented**, reason `none`
- [List conversation messages](https://neotask.ai/docs/api/list-agent-conversation-messages.md): `GET /api/agent/v1/conversations/{conversationRef}/messages`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [Create a conversation turn](https://neotask.ai/docs/api/create-agent-conversation-turn.md): `POST /api/agent/v1/conversations/{conversationRef}/turns`, scope `neotask:conversations:write`, status **implemented, currently setup_required**, reason `runner_not_enrolled`
- [Read a conversation turn](https://neotask.ai/docs/api/get-agent-conversation-turn.md): `GET /api/agent/v1/conversations/{conversationRef}/turns/{turnRef}`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [Cancel a conversation turn](https://neotask.ai/docs/api/cancel-agent-conversation-turn.md): `POST /api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/cancel`, scope `neotask:conversations:write`, status **implemented**, reason `none`
- [Recover conversation turn events](https://neotask.ai/docs/api/list-agent-conversation-turn-events.md): `GET /api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/events`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [Stream conversation turn events](https://neotask.ai/docs/api/stream-agent-conversation-turn-events.md): `GET /api/agent/v1/conversations/{conversationRef}/turns/{turnRef}/events/stream`, scope `neotask:conversations:read`, status **implemented**, reason `none`
- [List tasks in the current account](https://neotask.ai/docs/api/list-tasks.md): `GET /api/agent/v1/tasks`, scope `neotask:tasks:read`, status **implemented**, reason `none`
- [Create a task in the current account](https://neotask.ai/docs/api/create-task.md): `POST /api/agent/v1/tasks`, scope `neotask:tasks:write`, status **implemented**, reason `none`
- [Read an asynchronous run](https://neotask.ai/docs/api/get-run.md): `GET /api/agent/v1/runs/{runId}`, scope `neotask:runs:read`, status **implemented**, reason `none`
- [Start an asynchronous task run](https://neotask.ai/docs/api/create-run.md): `POST /api/agent/v1/runs`, scope `neotask:runs:write`, status **implemented, currently setup_required**, reason `runner_not_enrolled`
- [Recover run events](https://neotask.ai/docs/api/list-agent-run-events.md): `GET /api/agent/v1/runs/{runRef}/events`, scope `neotask:runs:read`, status **implemented**, reason `none`
- [Stream run events](https://neotask.ai/docs/api/stream-agent-run-events.md): `GET /api/agent/v1/runs/{runRef}/events/stream`, scope `neotask:runs:read`, status **implemented**, reason `none`