# Apify Actor tasks API

**Canonical:** https://apis.io/apis/apify/apify-actor-tasks-api/  
**Provider:** Apify — https://apis.io/providers/apify/  
**Base URL:** https://api.apify.com  
**Documentation:** https://apify.com

Apify Actor tasks API is one of 42 APIs that [Apify](https://apis.io/providers/apify/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Actor tasks. The published artifact set on APIs.io includes an OpenAPI specification.

The API endpoints described in this section enable you to create, manage, delete, and run Apify Actor tasks. For more information, see the [Actor tasks documentation](https://docs.apify.com/platform/actors/running/tasks). :::note For all the API endpoints that accept the `actorTaskId` parameter to specify a task, you can pass either the task ID (e.g. `HG7ML7M8z78YcAPEB`) or a tilde-separated username of the task's owner and the task's name (e.g. `janedoe~my-task`). ::: Some of the API endpoints return run objects. If any such run object contains usage in dollars, your effective unit pricing at the time of query has been used for computation of this dollar equivalent, and hence it should be used only for informative purposes. You can learn more about platform usage in the [documentation](https://docs.apify.com/platform/actors/running/usage-and-resources#usage).

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/actor-tasks` | Get list of tasks |
| POST | `/v2/actor-tasks` | Create task |
| GET | `/v2/actor-tasks/{actorTaskId}` | Get task |
| PUT | `/v2/actor-tasks/{actorTaskId}` | Update task |
| DELETE | `/v2/actor-tasks/{actorTaskId}` | Delete task |
| GET | `/v2/actor-tasks/{actorTaskId}/input` | Get task input |
| PUT | `/v2/actor-tasks/{actorTaskId}/input` | Update task input |
| GET | `/v2/actor-tasks/{actorTaskId}/webhooks` | Get list of webhooks |
| GET | `/v2/actor-tasks/{actorTaskId}/runs` | Get list of task runs |
| POST | `/v2/actor-tasks/{actorTaskId}/runs` | Run task |
| GET | `/v2/actor-tasks/{actorTaskId}/run-sync` | Run task synchronously |
| POST | `/v2/actor-tasks/{actorTaskId}/run-sync` | Run task synchronously |
| GET | `/v2/actor-tasks/{actorTaskId}/run-sync-get-dataset-items` | Run task synchronously and get dataset items |
| POST | `/v2/actor-tasks/{actorTaskId}/run-sync-get-dataset-items` | Run task synchronously and get dataset items |
| GET | `/v2/actor-tasks/{actorTaskId}/runs/last` | Get last run |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/apify/openapi/apify-actor-tasks-api-openapi.yml

## Other Apify APIs (12)

- [Apify Actor Runs API](https://apis.io/apis/apify/apify-actor-runs-api/)
- [Apify Actors API](https://apis.io/apis/apify/apify-actors-api/)
- [Apify Datasets API](https://apis.io/apis/apify/apify-datasets-api/)
- [Apify Key-Value Stores API](https://apis.io/apis/apify/apify-key-value-stores-api/)
- [Apify Request Queues API](https://apis.io/apis/apify/apify-request-queues-api/)
- [Apify Users API](https://apis.io/apis/apify/apify-users-api/)
- [Apify Actor builds API](https://apis.io/apis/apify/apify-actor-builds-api/)
- [Apify Actors/Actor builds API](https://apis.io/apis/apify/apify-actors-actor-builds-api/)
- [Apify Actors/Actor runs API](https://apis.io/apis/apify/apify-actors-actor-runs-api/)
- [Apify Actors/Actor versions API](https://apis.io/apis/apify/apify-actors-actor-versions-api/)
- [Apify Actors/Webhook collection API](https://apis.io/apis/apify/apify-actors-webhook-collection-api/)
- [Apify Default dataset API](https://apis.io/apis/apify/apify-default-dataset-api/)

## Tags

Actor tasks

---

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