---
name: neotask-billing-pairing-and-lifecycle
description: Create safe human handoffs for billing, pairing, and account lifecycle actions.
---

# Billing, pairing, and lifecycle

Launch state: **Live**.

Create safe human handoffs for billing, pairing, and account lifecycle actions.

Read [the authenticated capabilities](https://neotask.ai/api/agent/v1/capabilities) before each request. It is the current account decision for scope, claim, setup, approval, plan, quota, model, and service state.

Use [the account index](https://neotask.ai/docs/account/llms.txt) for the linked Markdown pages.

## Rules

- A documented operation does not grant permission.
- Use a row only when its capability record reports `scopeGranted: true`, `availability: "available"`, and the required launch state.
- Planned rows are contract records. Their routes are not mounted and must not be called.
- Keep bearer tokens, provider credentials, handoff handles, and tenant identifiers out of URLs, logs, and generated content.
- Follow any returned claim, approval, pairing, integration, or checkout action through the human flow. Do not complete a human-only action as the agent.

## Operations

- [List authorized companies](https://neotask.ai/docs/api/list-agent-companies.md): `GET /api/agent/v1/companies`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Read a company overview](https://neotask.ai/docs/api/get-agent-company.md): `GET /api/agent/v1/companies/{companyRef}`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [List configured company agents](https://neotask.ai/docs/api/list-agent-company-agents.md): `GET /api/agent/v1/companies/{companyRef}/agents`, scope `neotask:companies:read`, status **implemented, currently claim_required**, reason `claim_required`
- [List saved boards in the verified company boundary.](https://neotask.ai/docs/api/list-insight-boards.md): `GET /api/agent/v1/boards`, scope `neotask:boards:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Read one saved board in the verified company boundary.](https://neotask.ai/docs/api/get-insight-board.md): `GET /api/agent/v1/boards/{boardId}`, scope `neotask:boards:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Read hosted publication state without a link secret.](https://neotask.ai/docs/api/get-insight-board-publication.md): `GET /api/agent/v1/boards/{boardId}/publication`, scope `neotask:boards:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Publish a saved version; public links require an exact human approval.](https://neotask.ai/docs/api/publish-insight-board.md): `POST /api/agent/v1/boards/{boardId}/publish`, scope `neotask:boards:publish`, status **implemented, currently claim_required**, reason `claim_required`
- [Unpublish the hosted board and revoke its active links.](https://neotask.ai/docs/api/unpublish-insight-board.md): `POST /api/agent/v1/boards/{boardId}/unpublish`, scope `neotask:boards:publish`, status **implemented, currently claim_required**, reason `claim_required`
- [Rotate the hosted link; the new secret is returned once.](https://neotask.ai/docs/api/rotate-insight-board-link.md): `POST /api/agent/v1/boards/{boardId}/rotate-link`, scope `neotask:boards:publish`, status **implemented, currently claim_required**, reason `claim_required`
- [Change visibility; public access requires an exact human approval.](https://neotask.ai/docs/api/set-insight-board-visibility.md): `PUT /api/agent/v1/boards/{boardId}/visibility`, scope `neotask:boards:share`, status **implemented, currently claim_required**, reason `claim_required`
- [List viewer-only grants for one board.](https://neotask.ai/docs/api/list-insight-board-grants.md): `GET /api/agent/v1/boards/{boardId}/grants`, scope `neotask:boards:share`, status **implemented, currently claim_required**, reason `claim_required`
- [Create one viewer-only grant subject to publication caps.](https://neotask.ai/docs/api/create-insight-board-grant.md): `POST /api/agent/v1/boards/{boardId}/grants`, scope `neotask:boards:share`, status **implemented, currently claim_required**, reason `claim_required`
- [Revoke one grant so the next viewer request is denied.](https://neotask.ai/docs/api/revoke-insight-board-grant.md): `DELETE /api/agent/v1/boards/{boardId}/grants/{grantId}`, scope `neotask:boards:share`, status **implemented, currently claim_required**, reason `claim_required`
- [Read the current agent identity and account](https://neotask.ai/docs/api/get-agent-profile.md): `GET /api/agent/v1/me`, scope `neotask:profile:read`, status **implemented**, reason `none`
- [List agents in the current account](https://neotask.ai/docs/api/list-agents.md): `GET /api/agent/v1/agents`, scope `neotask:agents:read`, status **implemented**, reason `none`
- [Create an agent in the current account](https://neotask.ai/docs/api/create-agent.md): `POST /api/agent/v1/agents`, scope `neotask:agents:write`, status **implemented**, reason `none`
- [Read one managed agent](https://neotask.ai/docs/api/get-agent.md): `GET /api/agent/v1/agents/{agentRef}`, scope `neotask:agents:read`, status **implemented**, reason `none`
- [Update one managed agent](https://neotask.ai/docs/api/update-agent.md): `PATCH /api/agent/v1/agents/{agentRef}`, scope `neotask:agents:write`, status **implemented**, reason `none`
- [Archive a managed agent](https://neotask.ai/docs/api/archive-agent.md): `POST /api/agent/v1/agents/{agentRef}/archive`, scope `neotask:agents:write`, status **implemented**, reason `none`
- [Restore a managed agent](https://neotask.ai/docs/api/restore-agent.md): `POST /api/agent/v1/agents/{agentRef}/restore`, scope `neotask:agents:write`, status **implemented**, reason `none`
- [Read effective tools for an agent](https://neotask.ai/docs/api/get-agent-effective-tools.md): `GET /api/agent/v1/agents/{agentRef}/tools`, scope `neotask:catalog:read`, status **implemented**, reason `none`
- [Read an agent tool policy](https://neotask.ai/docs/api/get-agent-tool-policy.md): `GET /api/agent/v1/agents/{agentRef}/tool-policy`, scope `neotask:agents:read`, status **implemented**, reason `none`
- [Update an agent tool policy](https://neotask.ai/docs/api/update-agent-tool-policy.md): `PATCH /api/agent/v1/agents/{agentRef}/tool-policy`, scope `neotask:agents:configure`, status **implemented, currently claim_required**, reason `claim_required`
- [Read current plan usage](https://neotask.ai/docs/api/get-usage.md): `GET /api/agent/v1/usage`, scope `neotask:usage:read`, status **implemented**, reason `none`
- [List signed desktop downloads](https://neotask.ai/docs/api/list-desktop-download-options.md): `GET /api/agent/v1/desktop/downloads`, scope `neotask:catalog:read`, status **implemented, currently claim_required**, reason `human_control_required`
- [Revoke the current agent registration](https://neotask.ai/docs/api/revoke-registration.md): `DELETE /api/agent/v1/registration`, scope `neotask:registration:revoke`, status **implemented**, reason `none`
- [Create a human account pairing handoff](https://neotask.ai/docs/api/create-agent-account-pairing-handoff.md): `POST /api/agent/v1/account/pairing-handoffs`, scope `neotask:account:pair`, status **implemented, currently claim_required**, reason `claim_required`
- [Request a paid-plan checkout handoff](https://neotask.ai/docs/api/request-agent-checkout-handoff.md): `POST /api/agent/checkout-handoffs/request`, scope `neotask:billing:handoff`, status **implemented, currently plan_required**, reason `plan_required`
- [Read a human account pairing handoff](https://neotask.ai/docs/api/get-agent-account-pairing-handoff.md): `GET /api/agent/v1/account/pairing-handoffs/{handoffRef}`, scope `neotask:account:pair`, status **implemented, currently claim_required**, reason `claim_required`
- [Cancel a human account pairing handoff](https://neotask.ai/docs/api/cancel-agent-account-pairing-handoff.md): `POST /api/agent/v1/account/pairing-handoffs/{handoffRef}/cancel`, scope `neotask:account:pair`, status **implemented, currently claim_required**, reason `claim_required`
- [Account: Inspect an agent pairing](https://neotask.ai/docs/api/get-human-agent-account-pairing-handoff.md): `GET /api/account/agent-pairing-handoffs/{handoffRef}`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Confirm an agent pairing](https://neotask.ai/docs/api/confirm-human-agent-account-pairing-handoff.md): `POST /api/account/agent-pairing-handoffs/{handoffRef}/confirm`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: List agent registrations](https://neotask.ai/docs/api/list-human-agent-registrations.md): `GET /api/account/agent-security/registrations`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Label an agent registration](https://neotask.ai/docs/api/update-human-agent-registration-label.md): `PATCH /api/account/agent-security/registrations/{registrationRef}`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Revoke an agent registration](https://neotask.ai/docs/api/revoke-human-agent-registration.md): `POST /api/account/agent-security/registrations/{registrationRef}/revoke`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: List agent runners](https://neotask.ai/docs/api/list-human-agent-runners.md): `GET /api/account/agent-security/runners`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Review a runner installation](https://neotask.ai/docs/api/inspect-human-runner-enrollment-review.md): `GET /api/account/agent-security/runner-enrollments/{reviewRef}`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Decide a runner installation request](https://neotask.ai/docs/api/resolve-human-runner-enrollment-review.md): `POST /api/account/agent-security/runner-enrollments/{reviewRef}/decision`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Review moving a claimed agent into your account](https://neotask.ai/docs/api/inspect-human-agent-claim-move.md): `GET /api/account/agent-claim-moves/{moveRef}`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Confirm or cancel moving a claimed agent](https://neotask.ai/docs/api/resolve-human-agent-claim-move.md): `POST /api/account/agent-claim-moves/{moveRef}/decision`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Label an agent runner](https://neotask.ai/docs/api/update-human-agent-runner-label.md): `PATCH /api/account/agent-security/runners/{runnerRef}`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Rotate an agent runner](https://neotask.ai/docs/api/rotate-human-agent-runner.md): `POST /api/account/agent-security/runners/{runnerRef}/rotate`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Account: Revoke an agent runner](https://neotask.ai/docs/api/revoke-human-agent-runner.md): `POST /api/account/agent-security/runners/{runnerRef}/revoke`, scope `human session`, status **human-session only**, reason `human_session_only`

Full API index: https://neotask.ai/docs/api/llms.txt
MCP resource: `https://neotask.ai/mcp`