# Neuron Tasks API

**Canonical:** https://apis.io/apis/neuron-ng/neuron-ng-tasks-api/  
**Provider:** Neuron — https://apis.io/providers/neuron-ng/  
**Base URL:** https://api.neuron.ng/api/v1  
**Documentation:** https://neuron.ng/docs

Neuron Tasks API is one of 25 APIs that [Neuron](https://apis.io/providers/neuron-ng/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Scheduled, goal-directed autonomous bot tasks — a natural-language instruction run on a schedule (cron/interval/once/manual) via an agentic tool-loop, with run history and AI drafting

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/tasks/bot/{botId}` | List a bot's tasks |
| POST | `/tasks/bot/{botId}` | Create a task for a bot |
| PUT | `/tasks/{id}` | Update a task (partial) |
| DELETE | `/tasks/{id}` | Delete a task (soft delete; stops it running) |
| POST | `/tasks/{id}/toggle` | Pause/resume a task |
| POST | `/tasks/{id}/run` | Run a task now (queues an immediate run) |
| GET | `/tasks/{id}/runs` | Get a task's run history (paginated) |
| POST | `/tasks/bot/{botId}/ai-draft` | Draft a task from a natural-language description (does not create it) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/neuron-ng/openapi/neuron-ng-tasks-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/neuron-ng/json-schema/neuron-ng-bot-task-schema.json

## Other Neuron APIs (12)

- [Neuron Account API](https://apis.io/apis/neuron-ng/neuron-ng-account-api-api/)
- [Neuron Approvals API](https://apis.io/apis/neuron-ng/neuron-ng-approvals-api/)
- [Neuron Audit API](https://apis.io/apis/neuron-ng/neuron-ng-audit-api/)
- [Neuron Auth API](https://apis.io/apis/neuron-ng/neuron-ng-auth-api/)
- [Neuron Billing API](https://apis.io/apis/neuron-ng/neuron-ng-billing-api/)
- [Neuron Blog API](https://apis.io/apis/neuron-ng/neuron-ng-blog-api/)
- [Neuron Bot API](https://apis.io/apis/neuron-ng/neuron-ng-bot-api-api/)
- [Neuron Bot Setup API](https://apis.io/apis/neuron-ng/neuron-ng-bot-setup-api/)
- [Neuron Bots API](https://apis.io/apis/neuron-ng/neuron-ng-bots-api/)
- [Neuron Builtin Tools API](https://apis.io/apis/neuron-ng/neuron-ng-builtin-tools-api/)
- [Neuron Channels API](https://apis.io/apis/neuron-ng/neuron-ng-channels-api/)
- [Neuron Conversations API](https://apis.io/apis/neuron-ng/neuron-ng-conversations-api/)

## Tags

Task

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/neuron-ng` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/neuron-ng/neuron-ng-tasks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/neuron-ng/.
