---
name: neotask-integrations
description: Discover provider setup and request human-authorized connections.
---

# Integrations

Launch state: **Live**.

Discover provider setup and request human-authorized connections.

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 integrations index](https://neotask.ai/docs/integrations/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 reviewed provider integrations](https://neotask.ai/docs/api/list-agent-integration-catalog.md): `GET /api/agent/v1/integrations/catalog`, scope `neotask:catalog:read`, status **implemented**, reason `none`
- [List verified integration connections](https://neotask.ai/docs/api/list-agent-integration-connections.md): `GET /api/agent/v1/integrations/connections`, scope `neotask:integrations:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Start a provider integration attempt](https://neotask.ai/docs/api/create-agent-integration-attempt.md): `POST /api/agent/v1/integrations/attempts`, scope `neotask:integrations:write`, status **implemented, currently claim_required**, reason `claim_required`
- [Read a provider integration attempt](https://neotask.ai/docs/api/get-agent-integration-attempt.md): `GET /api/agent/v1/integrations/attempts/{attemptId}`, scope `neotask:integrations:read`, status **implemented, currently claim_required**, reason `claim_required`
- [Cancel a provider integration attempt](https://neotask.ai/docs/api/cancel-agent-integration-attempt.md): `POST /api/agent/v1/integrations/attempts/{attemptId}/cancel`, scope `neotask:integrations:write`, status **implemented, currently claim_required**, reason `claim_required`
- [Attach a verified integration](https://neotask.ai/docs/api/attach-agent-integration.md): `POST /api/agent/v1/integrations/connections/{connectionId}/attach`, scope `neotask:integrations:write`, status **implemented, currently claim_required**, reason `claim_required`
- [Detach a verified integration](https://neotask.ai/docs/api/detach-agent-integration.md): `POST /api/agent/v1/integrations/connections/{connectionId}/detach`, scope `neotask:integrations:write`, status **implemented, currently claim_required**, reason `claim_required`
- [Revoke a verified integration](https://neotask.ai/docs/api/revoke-agent-integration.md): `POST /api/agent/v1/integrations/connections/{connectionId}/revoke`, scope `neotask:integrations:security`, status **implemented, currently claim_required**, reason `claim_required`
- [Integrations: Inspect credential setup](https://neotask.ai/docs/api/get-human-agent-integration-credential-handoff.md): `GET /api/account/agent-integrations/{attemptId}/credential`, scope `human session`, status **human-session only**, reason `human_session_only`
- [Integrations: Save a provider API key](https://neotask.ai/docs/api/complete-human-agent-integration-credential-handoff.md): `POST /api/account/agent-integrations/{attemptId}/credential`, 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`