# Apify Actors/Actor versions API

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

Apify Actors/Actor versions 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 Actors/Actor versions. The published artifact set on APIs.io includes an OpenAPI specification.

The API endpoints in this section allow you to manage your Apify Actors versions. - The version object contains the source code of a specific version of an Actor. - The `sourceType` property indicates where the source code is hosted, and based on its value the Version object has the following additional property: | **Value** | **Description** | |---|---| | `"SOURCE_FILES"` | Source code is comprised of multiple files specified in the `sourceFiles` array. Each item of the array is an object with the following fields:<br/> - `name`: File path and name<br/> - `format`: Format of the content, can be either `"TEXT"` or `"BASE64"`<br/> - `content`: File content<br/><br/>Source files can be shown and edited in the Apify Console's Web IDE. | | `"GIT_REPO"` | Source code is cloned from a Git repository, whose URL is specified in the `gitRepoUrl` field. | | `"TARBALL"` | Source code is downloaded using a tarball or Zip file from a URL specified in the `tarballUrl` field. | |`"GITHUB_GIST"`| Source code is taken from a GitHub Gist, whose URL is specified in the `gitHubGistUrl` field. | For more information about source code and Actor versions, check out [Source code](https://docs.apify.com/platform/actors/development/actor-definition/source-code) in Actors documentation.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/actors/{actorId}/versions` | Get list of versions |
| POST | `/v2/actors/{actorId}/versions` | Create version |
| GET | `/v2/actors/{actorId}/versions/{versionNumber}` | Get version |
| PUT | `/v2/actors/{actorId}/versions/{versionNumber}` | Update version |
| POST | `/v2/actors/{actorId}/versions/{versionNumber}` | Update version (POST) |
| DELETE | `/v2/actors/{actorId}/versions/{versionNumber}` | Delete version |
| GET | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars` | Get list of environment variables |
| POST | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars` | Create environment variable |
| GET | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}` | Get environment variable |
| PUT | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}` | Update environment variable |
| POST | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}` | Update environment variable (POST) |
| DELETE | `/v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}` | Delete environment variable |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/apify/openapi/apify-actors-actor-versions-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 Actor tasks API](https://apis.io/apis/apify/apify-actor-tasks-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/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

Actors/Actor versions

---

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