abort_build
Aborts an actor build and returns an object that contains all the details about the build. Only builds that are starting or running are aborted. For builds with status FINISHED
, FAILED
, ABORTING
and TIMED-OUT
this call does nothing.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
buildId (required)
Build ID.
Type: string
abort_last_run
Aborts the actor's last run and returns an object that contains all the details about the run. Only runs that are starting or running are aborted. For runs with status FINISHED
, FAILED
, ABORTING
and TIMED-OUT
this call does nothing.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
abort_run
Aborts an actor run and returns an object that contains all the details about the run. Only runs that are starting or running are aborted. For runs with status FINISHED
, FAILED
, ABORTING
and TIMED-OUT
this call does nothing.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
runId (required)
Run ID.
Type: string
add_record_to_actor_last_run_store
Stores a value under a specific key to the actor's last run's key-value store. The value is passed as the PUT payload and it is stored with a MIME content type defined by the Content-Type
request header.
IMPORTANT: The limit of the request payload is 9 MB. If you want to upload a larger record or speed up your upload, use the Direct upload URL endpoint instead.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
recordKey (required)
Key of the record.
Type: string
$body
Type: object
{ }
status
Filter for the run status.
Type: string
add_record_to_store
Stores a value under a specific key to the key-value store. The value is passed as the PUT payload and it is stored with a MIME content type defined by the Content-Type
request header.
IMPORTANT: The limit of the request payload is 9 MB. If you want to upload a larger record or speed up your upload, use the Direct upload URL endpoint instead.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header.
Parameters
recordKey (required)
Key of the record.
Type: string
storeId (required)
Key-value store ID or username~store-name
.
Type: string
$body
Type: object
{ }
add_record_to_task_last_run_store
Stores a value under a specific key to the task's last run's key-value store. The value is passed as the PUT payload and it is stored with a MIME content type defined by the Content-Type
request header.
IMPORTANT: The limit of the request payload is 9 MB. If you want to upload a larger record or speed up your upload, use the Direct upload URL endpoint instead.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
recordKey (required)
Key of the record.
Type: string
$body
Type: object
{ }
status
Filter for the run status.
Type: string
add_request_to_queue
Adds request to the queue. Response contains ID of the request and info if request was already present in the queue or handled. If request with same uniqueKey
was already present in the queue then returns an ID of existing request.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
add_request_to_queue_for_actor_last_run
Adds request to actor's last run's queue. Response contains ID of the request and info if request was already present in the queue or handled. If request with same uniqueKey
was already present in the queue then returns an ID of existing request.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
status
Filter for the run status.
Type: string
add_request_to_queue_for_task_last_run
Adds request to task's last run's queue. Response contains ID of the request and info if request was already present in the queue or handled. If request with same uniqueKey
was already present in the queue then returns an ID of existing request.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
status
Filter for the run status.
Type: string
build_actor
Builds an actor.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
betaPackages
If true
or 1
then the actor is built with beta versions of Apify NPM packages. By default, the build uses latest
packages.
Type: boolean
tag
Tag to be applied to the build on success. By default, the tag is taken from actor version's buildTag
property.
Type: string
useCache
If true
or 1
, the system will use a cache to speed up the build process. By default, cache is not used.
Type: boolean
version
Actor version number to be built.
Type: string
waitForFinish
The maximum number of seconds the server waits for the build to finish. By default it is 0
, the maximum value is 300
.
Type: integer
create_actor
Creates a new actor with settings specified by the actor object passed as JSON in the POST payload. The response is the full actor object.
Parameters
$body
Type: object
{
"versions" : [ {
"sourceCode" : "Required string",
"sourceType" : "Required string",
"buildTag" : "Required string",
"baseDockerImage" : "string",
"applyEnvVarsToBuild" : "boolean",
"envVars" : [ [ {
"isSecret" : "boolean",
"name" : "string",
"value" : "string",
"key" : "string"
} ] ],
"versionNumber" : "Required string"
} ],
"restartOnError" : "boolean",
"name" : "Required string",
"description" : "string",
"isPublic" : "Required boolean",
"title" : "string"
}
create_dataset
Creates dataset of given name and returns its object. If dataset with given name already exists then returns its object.
Parameters
name
Custom unique name to easily identify the store in the future.
Type: string
create_key_value_store
Creates a key-value store with a specific name. The response is the same object as returned by the Get store endpoint.
If there is another store with the same name, the endpoint does not create a new one and returns the existing object instead.
Parameters
name
Custom unique name to easily identify the store in the future.
Type: string
create_request_queue
Creates queue of given name and returns its object. If a queue with the given name already exists then the endpoint returns its object.
Parameters
name
Custom unique name to easily identify the store in the future.
Type: string
create_task
Create a new task with settings specified by the object passed as JSON in the POST payload.
Parameters
$body
Type: object
{
"input" : {
"body" : "string",
"contentType" : "Required string"
},
"actId" : "string",
"name" : "string",
"options" : {
"build" : "string",
"memoryMbytes" : "number",
"timeoutSecs" : "number"
}
}
create_version
Creates actor version.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{
"sourceCode" : "Required string",
"sourceType" : "Required string",
"buildTag" : "Required string",
"baseDockerImage" : "string",
"applyEnvVarsToBuild" : "boolean",
"envVars" : [ [ {
"isSecret" : "boolean",
"name" : "string",
"value" : "string",
"key" : "string"
} ] ],
"versionNumber" : "Required string"
}
create_webhook
Creates a new webhook with settings provided by the webhook object passed as JSON in the payload. The response is the created webhook object.
To make sure that the same webhook is not created twice, use the idempotencyKey
parameter. Multiple calls to create webhook with the same idempotency key will only create the webhook with the first call and return the existing webhook on subsequent calls. Idempotency keys must be unique, so use a UUID or another random string with enough entropy.
Parameters
$body
Type: object
{
"isAdHoc" : "boolean",
"condition" : {
"actorTaskId" : "string"
},
"ignoreSslErrors" : "boolean",
"idempotencyKey" : "string",
"requestUrl" : "Required string",
"eventTypes" : [ "string" ],
"payloadTemplate" : "string"
}
delete_actor
Deletes an actor.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
delete_actor_last_run_key_value_store
Deletes an actor's last run's key-value store.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
delete_dataset
Deletes given dataset.
Parameters
datasetId (required)
Dataset ID or username~dataset-name
.
Type: string
delete_dataset_for_actor_last_run
Deletes actor's last run's dataset.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
delete_dataset_for_task_last_run
Deletes task's last run's dataset.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
delete_key_value_store
Deletes a key-value store.
Parameters
storeId (required)
Key-value store ID or username~store-name
.
Type: string
delete_last_run_key_value_store
Deletes an actor's last run's key-value store.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
delete_request_from_queue
Deletes given request from queue.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
requestId (required)
Request ID.
Type: string
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
delete_request_from_queue_for_actor_last_run
Deletes given request from actor's last run's queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
requestId (required)
Request ID.
Type: string
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
status
Filter for the run status.
Type: string
delete_request_from_queue_for_task_last_run
Deletes given request from task's last run's queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
requestId (required)
Request ID.
Type: string
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
status
Filter for the run status.
Type: string
delete_request_queue
Deletes given queue.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
delete_request_queue_for_actor_last_run
Deletes actor's last_run's request queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
delete_request_queue_for_task_last_run
Deletes task's last_run's request queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
delete_task
Delete the task specified through the actorTaskId
parameter.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
delete_version_for_actor
Deletes a version for an actor.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
versionNumber (required)
Actor major and minor version of the actor.
Type: string
delete_webhook
Deletes an webhook.
Parameters
webhookId (required)
Webhook ID.
Type: string
get_actor
Gets an object that contains all the details about a specific actor.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
get_actor_last_run_direct_upload_url
Generates a unique URL that can be used to upload a record under a specific key to the actor's last run's key-value store. The record must be uploaded to the resulting URL using a PUT request.
This endpoint is useful if your record is larger than the limit imposed by the Put record endpoint (i.e. 9 MB) or if you want to get the maximum speed for your upload.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header to your request.
IMPORTANT: The Content-Type
and Content-Encoding
headers sent in both requests must match!
Parameters
Content-Type (required)
Type: string
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
recordKey (required)
Key of the record.
Type: string
status
Filter for the run status.
Type: string
get_actor_last_run_key_value_store
Gets an object that contains all the details about an actor's last run's key-value store.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
get_build_for_actor
Gets an object that contains all the details about a specific build of an actor.
By passing the optional waitForFinish=1
parameter the API endpoint will synchronously wait for the build to finish. This is useful to avoid periodic polling when waiting for an actor build to finish.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
buildId (required)
Build ID.
Type: string
waitForFinish
The maximum number of seconds the server waits for the build to finish. By default it is 0
, the maximum value is 300
.
Type: integer
get_current_user_data
This operation has no parameters
get_dataset
Returns dataset object for given dataset ID.
Parameters
datasetId (required)
Dataset ID or username~dataset-name
.
Type: string
get_dataset_for_actor_last_run
Returns dataset object for the actor's last run.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
get_dataset_for_task_last_run
Returns dataset object for the task's last run.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
get_direct_upload_url
Generates a unique URL that can be used to upload a record under a specific key to the key-value store. The record must be uploaded to the resulting URL using a PUT request.
This endpoint is useful if your record is larger than the limit imposed by the Put record endpoint (i.e. 9 MB) or if you want to get the maximum speed for your upload.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header to your request.
IMPORTANT: The Content-Type
and Content-Encoding
headers sent in both requests must match!
Parameters
Content-Type (required)
Type: string
recordKey (required)
Key of the record.
Type: string
storeId (required)
Key-value store ID or username~store-name
.
Type: string
get_head_of_queue
Returns given number of first requests from the queue.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
hadMultipleClients
Is true
if the queue was accessed by more than one clients (with unique or empty clientKey
). This field is used by Apify SDK to determine whether the local cache is consistent with the remote storage, and thus optimize certain operations.
Type: boolean
get_head_of_queue_for_actor_last_run
Returns given number of first requests from the actor's last run's queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
hadMultipleClients
Is true
if the queue was accessed by more than one clients (with unique or empty clientKey
). This field is used by Apify SDK to determine whether the local cache is consistent with the remote storage, and thus optimize certain operations.
Type: boolean
status
Filter for the run status.
Type: string
get_head_of_queue_for_task_last_run
Returns given number of first requests from the task's last run's queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
hadMultipleClients
Is true
if the queue was accessed by more than one clients (with unique or empty clientKey
). This field is used by Apify SDK to determine whether the local cache is consistent with the remote storage, and thus optimize certain operations.
Type: boolean
status
Filter for the run status.
Type: string
get_items_in_actor_last_run_dataset
Returns data stored in the actor's last run's dataset in a desired format. The format of the response depends on "format" query parameter. Note that CSV, XLSX and HTML tables are limited to 500 columns and the column names cannot be longer than 200 characters. JSON, XML and RSS formats do not have such restrictions.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
attachment
If true or 1 then the response will define the Content-Disposition: attachment header, forcing a web browser to download the file rather than to display it. By default this header is not present.
Type: boolean
bom
All text responses are encoded in UTF-8 encoding. By default, the format=csv files are prefixed with the UTF-8 Byte Order Mark (BOM), while json, jsonl, xml, html and rss files are not. If you want to override this default behavior, specify bom=1 query parameter to include the BOM or bom=0 to skip it.
Type: boolean
delimiter
A delimiter character for CSV files, only used if format=csv. The default delimiter is a simple comma (,).
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
fields
A comma-separated list of fields which should be picked from the items, only these fields will remain in the resulting record objects. Note that the fields in the outputted items are sorted the same way as they are specified in the fields query parameter. You can use this feature to effectively fix the output format.
Type: array
[ "string" ]
format
Format of the results.
Type: string
Potential values: json, jsonl, csv, html, xlsx, xml, rss
omit
A comma-separated list of fields which should be omitted from the items.
Type: array
[ "string" ]
skipHeaderRow
If true or 1 then header row in the csv format is skipped.
Type: boolean
status
Filter for the run status.
Type: string
unwind
Name of a field which should be unwound. If the field is an array then every element of the array will become a separate record and merged with parent object. If the unwound field is an object then it is merged with the parent object If the unwound field is missing or its value is neither an array nor an object and therefore cannot be merged with a parent object then the item gets preserved as it is. Note that the unwound items ignore the desc parameter.
Type: string
xmlRoot
Overrides default root element name of xml output. By default the root element is items.
Type: string
xmlRow
Overrides default element name that wraps each page or page function result object in xml output. By default the element name is item.
Type: string
get_items_in_dataset
Returns data stored in the dataset in a desired format. The format of the response depends on "format" query parameter. Note that CSV, XLSX and HTML tables are limited to 500 columns and the column names cannot be longer than 200 characters. JSON, XML and RSS formats do not have such restrictions.
Parameters
datasetId (required)
Dataset ID or username~dataset-name
.
Type: string
attachment
If true or 1 then the response will define the Content-Disposition: attachment header, forcing a web browser to download the file rather than to display it. By default this header is not present.
Type: boolean
bom
All text responses are encoded in UTF-8 encoding. By default, the format=csv files are prefixed with the UTF-8 Byte Order Mark (BOM), while json, jsonl, xml, html and rss files are not. If you want to override this default behavior, specify bom=1 query parameter to include the BOM or bom=0 to skip it.
Type: boolean
delimiter
A delimiter character for CSV files, only used if format=csv. The default delimiter is a simple comma (,).
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
fields
A comma-separated list of fields which should be picked from the items, only these fields will remain in the resulting record objects. Note that the fields in the outputted items are sorted the same way as they are specified in the fields query parameter. You can use this feature to effectively fix the output format.
Type: array
[ "string" ]
format
Format of the results.
Type: string
Potential values: json, jsonl, csv, html, xlsx, xml, rss
omit
A comma-separated list of fields which should be omitted from the items.
Type: array
[ "string" ]
skipHeaderRow
If true or 1 then header row in the csv format is skipped.
Type: boolean
unwind
Name of a field which should be unwound. If the field is an array then every element of the array will become a separate record and merged with parent object. If the unwound field is an object then it is merged with the parent object If the unwound field is missing or its value is neither an array nor an object and therefore cannot be merged with a parent object then the item gets preserved as it is. Note that the unwound items ignore the desc parameter.
Type: string
xmlRoot
Overrides default root element name of xml output. By default the root element is items.
Type: string
xmlRow
Overrides default element name that wraps each page or page function result object in xml output. By default the element name is item.
Type: string
get_items_in_task_last_run_dataset
Returns data stored in the task's last run's dataset in a desired format. The format of the response depends on "format" query parameter. Note that CSV, XLSX and HTML tables are limited to 500 columns and the column names cannot be longer than 200 characters. JSON, XML and RSS formats do not have such restrictions.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
attachment
If true or 1 then the response will define the Content-Disposition: attachment header, forcing a web browser to download the file rather than to display it. By default this header is not present.
Type: boolean
bom
All text responses are encoded in UTF-8 encoding. By default, the format=csv files are prefixed with the UTF-8 Byte Order Mark (BOM), while json, jsonl, xml, html and rss files are not. If you want to override this default behavior, specify bom=1 query parameter to include the BOM or bom=0 to skip it.
Type: boolean
delimiter
A delimiter character for CSV files, only used if format=csv. The default delimiter is a simple comma (,).
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
fields
A comma-separated list of fields which should be picked from the items, only these fields will remain in the resulting record objects. Note that the fields in the outputted items are sorted the same way as they are specified in the fields query parameter. You can use this feature to effectively fix the output format.
Type: array
[ "string" ]
format
Format of the results.
Type: string
Potential values: json, jsonl, csv, html, xlsx, xml, rss
omit
A comma-separated list of fields which should be omitted from the items.
Type: array
[ "string" ]
skipHeaderRow
If true or 1 then header row in the csv format is skipped.
Type: boolean
status
Filter for the run status.
Type: string
unwind
Name of a field which should be unwound. If the field is an array then every element of the array will become a separate record and merged with parent object. If the unwound field is an object then it is merged with the parent object If the unwound field is missing or its value is neither an array nor an object and therefore cannot be merged with a parent object then the item gets preserved as it is. Note that the unwound items ignore the desc parameter.
Type: string
xmlRoot
Overrides default root element name of xml output. By default the root element is items.
Type: string
xmlRow
Overrides default element name that wraps each page or page function result object in xml output. By default the element name is item.
Type: string
get_key_value_store
Gets an object that contains all the details about a specific key-value store.
Parameters
storeId (required)
Key-value store ID or username~store-name
.
Type: string
get_last_run_for_actor
Gets an object that contains all the details about the actor's last run.
By passing the optional waitForFinish=1
parameter the API endpoint will synchronously wait for the build to finish. This is useful to avoid periodic polling when waiting for actor build to complete.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
get_last_run_for_task
Gets an object that contains all the details about the task's last run.
By passing the optional waitForFinish=1
parameter the API endpoint will synchronously wait for the build to finish. This is useful to avoid periodic polling when waiting for actor build to complete.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
get_log
Responds with HTTP status 302 to redirect to an URL containing the requested log. The log has a content type text/plain
and it is encoded as gzip
returned with appropriate HTTP headers.
Parameters
buildOrRunId (required)
ID of the actor build or run.
Type: string
download
If true
or 1
then the web browser will download the log file rather than open it in a tab.
Type: boolean
stream
If true
or 1
then the logs will be streamed as long as the run or build is running.
Type: boolean
get_log_for_actor_last_run
Responds with HTTP status 302 to redirect to an URL containing the actor's last run's log. The log has a content type text/plain
and it is encoded as gzip
returned with appropriate HTTP headers.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
download
If true
or 1
then the web browser will download the log file rather than open it in a tab.
Type: boolean
status
Filter for the run status.
Type: string
stream
If true
or 1
then the logs will be streamed as long as the run or build is running.
Type: boolean
get_log_for_task_last_run
Responds with HTTP status 302 to redirect to an URL containing the task's last run's log. The log has a content type text/plain
and it is encoded as gzip
returned with appropriate HTTP headers.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
download
If true
or 1
then the web browser will download the log file rather than open it in a tab.
Type: boolean
status
Filter for the run status.
Type: string
stream
If true
or 1
then the logs will be streamed as long as the run or build is running.
Type: boolean
get_public_user_data
Returns public information about a specific user account, similar to what can be seen on public profile pages (e.g. https://apify.com/apify).
Parameters
userId (required)
User ID or username.
Type: string
get_record_from_actor_last_run_store
Gets a value stored in the actor's last run's key-value store under a specific key. If the request defines the Accept-Encoding: gzip
HTTP header then the response will be gzipped.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
recordKey (required)
Key of the record.
Type: string
disableRedirect
By default, the API responds with the HTTP 302 status to redirect the client to another URL for faster download of the record. You can set disableRedirect=1
to prevent this behavior and return the record directly.
Type: boolean
status
Filter for the run status.
Type: string
get_record_from_store
Gets a value stored in the key-value store under a specific key. If the request defines the Accept-Encoding: gzip
HTTP header then the response will be gzipped.
Parameters
recordKey (required)
Key of the record.
Type: string
storeId (required)
Key-value store ID or username~store-name
.
Type: string
disableRedirect
By default, the API responds with the HTTP 302 status to redirect the client to another URL for faster download of the record. You can set disableRedirect=1
to prevent this behavior and return the record directly.
Type: boolean
get_record_from_task_last_run_store
Gets a value stored in the task's last run's key-value store under a specific key. If the request defines the Accept-Encoding: gzip
HTTP header then the response will be gzipped.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
recordKey (required)
Key of the record.
Type: string
disableRedirect
By default, the API responds with the HTTP 302 status to redirect the client to another URL for faster download of the record. You can set disableRedirect=1
to prevent this behavior and return the record directly.
Type: boolean
status
Filter for the run status.
Type: string
get_request_from_queue
Returns request from queue.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
requestId (required)
Request ID.
Type: string
get_request_from_queue_for_actor_last_run
Returns request from actor's last run's queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
requestId (required)
Request ID.
Type: string
status
Filter for the run status.
Type: string
get_request_from_queue_for_task_last_run
Returns request from task's last run's queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
requestId (required)
Request ID.
Type: string
status
Filter for the run status.
Type: string
get_request_queue
Returns queue object for given queue ID.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
get_request_queue_for_actor_last_run
Returns queue object for actor's last run's request queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
get_request_queue_for_task_last_run
Returns queue object for task's run's request queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
get_run_for_actor
Gets an object that contains all the details about a specific run of an actor.
By passing the optional waitForFinish=1
parameter the API endpoint will synchronously wait for the build to finish. This is useful to avoid periodic polling when waiting for actor build to complete.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
runId (required)
Run ID.
Type: string
waitForFinish
The maximum number of seconds the server waits for the build to finish. By default it is 0
, the maximum value is 300
.
Type: integer
get_task
Get an object that contains all the details about a task.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
get_task_last_run_direct_upload_url
Generates a unique URL that can be used to upload a record under a specific key to the task's last run's key-value store. The record must be uploaded to the resulting URL using a PUT request.
This endpoint is useful if your record is larger than the limit imposed by the Put record endpoint (i.e. 9 MB) or if you want to get the maximum speed for your upload.
To save bandwidth and speed up your upload, send the request payload compressed with Gzip compression and add the Content-Encoding: gzip
header to your request.
IMPORTANT: The Content-Type
and Content-Encoding
headers sent in both requests must match!
Parameters
Content-Type (required)
Type: string
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
recordKey (required)
Key of the record.
Type: string
status
Filter for the run status.
Type: string
get_task_last_run_key_value_store
Gets an object that contains all the details about an task's last run's key-value store.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
get_version_for_actor
Gets an object that contains all the details about a specific version of an actor.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
versionNumber (required)
Actor major and minor version of the actor.
Type: string
get_webhook
Gets webhook object with all details.
Parameters
webhookId (required)
Webhook ID.
Type: string
get_webhook_dispatch
Gets webhook dispatch object with all details.
Parameters
dispatchId (required)
Webhook dispatch ID.
Type: string
list_actor_last_run_keys_in_store
Returns a list of objects describing keys of an actor's last run's key-value store, as well as some information about the values (e.g. size). This endpoint is paginated using exclusiveStartKey
and limit
parameters.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
status
Filter for the run status.
Type: string
list_actors
Gets the list of all actors that the user created or used. The response is a list of objects where each object contains a basic information about a single actor. To only get actors created by the user, add the my=1
query parameter. The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records. By default, the records are sorted by the createdAt
field in ascending order, therefore you can use pagination to incrementally fetch all actors while new ones are still being created. To sort the records in descending order, use the desc=1
parameter.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
my
If true
or 1
then the returned list only contains items owned by the user.
Type: boolean
list_all_webhook_dispatches
Gets the list of webhook dispatches that the user have. The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records. By default, the records are sorted by the createdAt
field in ascending order. To sort the records in descending order, use the desc=1
parameter.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_builds_for_actor
Gets the list of builds of a specific actor. The response is a JSON with the list of objects where each object contains basic information about a single build.
The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records.
By default, the records are sorted by the startedAt
field in ascending order, therefore you can use pagination to incrementally fetch all builds while new ones are still being started. To sort the records in descending order, use the desc=1
parameter.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_datasets
Lists datasets of user. Response is a JSON array of objects where each object contains basic information about one dataset.
By default, the objects are sorted by the createdAt
field in ascending order, therefore you can use pagination to incrementally fetch all datasets while new ones are still being created. To sort them in descending order, use desc=1
parameter. The endpoint supports pagination using limit
and offset
parameters and it will not return more than 1000 array elements.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
unnamed
If true
then all the items are returned. By default only named items are returned.
Type: boolean
list_dispatches_for_webhook
Gets list of dispatches of a given webhook.
Parameters
webhookId (required)
Webhook ID.
Type: string
list_key_value_stores
Gets the list of key-value stores owned by the user. The response is a list of objects where each objects contains a basic information about a single key-value store.
The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 array elements.
By default, the records are sorted by the createdAt
field in ascending order, therefore you can use pagination to incrementally fetch all key-value stores while new ones are still being created. To sort the records in descending order, use the desc=1
parameter.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
unnamed
If true
then all the items are returned. By default only named items are returned.
Type: boolean
list_keys_in_store
Returns a list of objects describing keys of a given key-value store, as well as some information about the values (e.g. size). This endpoint is paginated using exclusiveStartKey
and limit
parameters.
Parameters
storeId (required)
Key-value store ID or username~store-name
.
Type: string
list_request_queues
Lists request queues of user. Response is a JSON array of objects where each object contains basic information about one queue.
By default, the objects are sorted by the createdAt
field in ascending order, therefore you can use pagination to incrementally fetch all queues while new ones are still being created. To sort them in descending order, use desc=1
parameter. The endpoint supports pagination using limit
and offset
parameters and it will not return more than 1000 array elements.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
unnamed
If true
then all the items are returned. By default only named items are returned.
Type: boolean
list_runs_for_actor
Gets the list of runs of a specific actor. The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 array elements. By default, the records are sorted by the startedAt
field in ascending order, therefore you can use pagination to incrementally fetch all records while new ones are still being created. To sort the records in descending order, use desc=1
parameter.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_runs_for_task
Get a list of runs of a specific task. The endpoint supports pagination using the limit
and offset
parameters, and it does not return more than 1000 array elements. By default, the records are sorted by the startedAt
field in ascending order; therefore you can use pagination to incrementally fetch all records while new ones are still being created. To sort the records in descending order, use the desc=1
parameter.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_task_last_run_keys_in_store
Returns a list of objects describing keys of a task's last run's key-value store, as well as some information about the values (e.g. size). This endpoint is paginated using exclusiveStartKey
and limit
parameters.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
status
Filter for the run status.
Type: string
list_tasks
Gets the list of all tasks that the user created or used. The response is a list of objects where each object contains essential information about a single task.
The endpoint supports pagination using the limit
and offset
parameters, and it does not return more than a 1000 records.
By default, the records are sorted by the createdAt
field in ascending order; therefore you can use pagination to incrementally fetch all tasks while new ones are still being created. To sort the records in descending order, use the desc=1
parameter.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_versions
Gets the list of versions of a specific actor. The response is a JSON with the list of objects where each object contains basic information about a single version.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
list_webhooks
Gets the list of webhooks that the user created. The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records. By default, the records are sorted by the createdAt
field in ascending order. To sort the records in descending order, use the desc=1
parameter.
Parameters
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_webhooks_for_actor
Gets the list of webhooks of a specific actor. The response is a JSON with the list of objects where each object contains basic information about a single webhook.
The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records.
By default, the records are sorted by the createdAt
field in ascending order, to sort the records in descending order, use the desc=1
parameter.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
list_webhooks_for_task
Gets the list of webhooks of a specific actor task. The endpoint supports pagination using the limit
and offset
parameters and it will not return more than 1000 records. By default, the records are sorted by the createdAt
field in ascending order; to sort the records in descending order, use the desc=1
parameter.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
desc
If true
or 1
then the items are sorted by the createdAt
field in descending order.
Type: boolean
metamorph_last_run
Transforms the actor's last run into a run of another actor with a new input. This is useful if you want to use another actor to finish the work of your current actor run, without the need to create a completely new run and waiting for its finish. For the users of your actors, the metamorph operation is transparent, they will just see your actor got the work done.
Internally, the system stops the Docker container corresponding to the actor run and starts a new container using a different Docker image. All the default storages are preserved and the new input is stored under the INPUT-METAMORPH-1
key in the same default key-value store.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
targetActorId (required)
ID of a target actor that the run should be transformed into.
Type: string
build
Specifies the actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the actor (typically latest
).
Type: string
status
Filter for the run status.
Type: string
metamorph_run
Transforms an actor run into a run of another actor with a new input. This is useful if you want to use another actor to finish the work of your current actor run, without the need to create a completely new run and waiting for its finish. For the users of your actors, the metamorph operation is transparent, they will just see your actor got the work done.
Internally, the system stops the Docker container corresponding to the actor run and starts a new container using a different Docker image. All the default storages are preserved and the new input is stored under the INPUT-METAMORPH-1
key in the same default key-value store.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
runId (required)
Run ID.
Type: string
targetActorId (required)
ID of a target actor that the run should be transformed into.
Type: string
build
Specifies the actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the actor (typically latest
).
Type: string
put_items_into_actor_last_run_dataset
Saves an item or an array of items into the actor's last run's dataset. The limit of request payload for dataset is 5mb.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{ }
status
Filter for the run status.
Type: string
put_items_into_dataset
Saves an item or an array of items into dataset. The limit of request payload for dataset is 5mb.
Parameters
datasetId (required)
Dataset ID or username~dataset-name
.
Type: string
$body
Type: object
{ }
put_items_into_task_last_run_dataset
Saves an item or an array of items into the actor's last run's dataset. The limit of request payload for dataset is 5mb.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
$body
Type: object
{ }
status
Filter for the run status.
Type: string
remove_record_from_actor_last_run_store
Removes a record specified by a key from the actor's last run's key-value store.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
recordKey (required)
Key of the record.
Type: string
status
Filter for the run status.
Type: string
remove_record_from_store
Removes a record specified by a key from the key-value store.
Parameters
recordKey (required)
Key of the record.
Type: string
storeId (required)
Key-value store ID or username~store-name
.
Type: string
remove_record_from_task_last_run_store
Removes a record specified by a key from the task's last run's key-value store.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
recordKey (required)
Key of the record.
Type: string
status
Filter for the run status.
Type: string
run_actor
Runs an actor and immediately returns without waiting for the run to finish. The POST payload including its Content-Type
header is passed as INPUT
to the actor (usually application/json). The actor is started with the default options; you can override them using various URL query parameters. The response is the Run object as returned by the Get run API endpoint. If you want to wait for the run to finish and receive the actual output of the actor as the response, please use one of the Run actor synchronously API endpoints instead.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{ }
build
Specifies the actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the actor (typically latest
).
Type: string
memory
Memory limit for the run, in megabytes. By default, the run uses a memory limit specified in the default run configuration for the actor.
Type: integer
timeout
Optional timeout for the run, in seconds. By default, the run uses a timeout specified in the default run configuration for the actor.
Type: integer
waitForFinish
The maximum number of seconds the server waits for the build to finish. By default it is 0
, the maximum value is 300
.
Type: integer
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
run_task
Runs an actor task and immediately returns without waiting for the run to finish.
Optionally, you can override the actor input configuration by passing a JSON object as the POST payload and setting the Content-Type: application/json
HTTP header. Note that if the object in the POST payload does not define a particular input property, the actor run uses the default value defined by the task (or actor's input schema if not defined by the task).
The response is the actor Run object as returned by the Get run endpoint. If you want to wait for the run to finish and receive the actual output of the actor run as the response, use one of the Run task synchronously API endpoints instead.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
$body
Type: object
{ }
waitForFinish
The maximum number of seconds the server waits for the build to finish. By default it is 0
, the maximum value is 300
.
Type: integer
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
sync_run_actor_with_input
Runs a specific actor and returns its output.
The POST payload including its Content-Type
header is passed as INPUT
to the actor (usually application/json). The HTTP response contains actor's OUTPUT
record from its default key-value store.
The actor is started with the default options; you can override them using various URL query parameters. If the actor run exceeds 300 seconds, the HTTP response will have status 408 (Request Timeout).
Beware that it might be impossible to maintain an idle HTTP connection for a long period of time, due to client timeout or network conditions. Make sure your HTTP client is configured to have a long enough connection timeout. If the connection breaks, you will not receive any information about the run and its status.
To run the actor asynchronously, use the Run actor API endpoint instead.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{ }
build
Specifies the actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the actor (typically latest
).
Type: string
memory
Memory limit for the run, in megabytes. By default, the run uses a memory limit specified in the default run configuration for the actor.
Type: integer
outputRecordKey
Key of the record from run's default key-value store to be returned in the response. By default, it is OUTPUT
.
Type: string
timeout
Optional timeout for the run, in seconds. By default, the run uses a timeout specified in the default run configuration for the actor.
Type: integer
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
sync_run_actor_without_input
Runs a specific actor and returns its output. The run must finish in 300 seconds otherwise the API endpoint returns a timeout error. The actor is not passed any input.
Beware that it might be impossible to maintain an idle HTTP connection for a long period of time, due to client timeout or network conditions. Make sure your HTTP client is configured to have a long enough connection timeout. If the connection breaks, you will not receive any information about the run and its status.
To run the actor asynchronously, use the Run actor API endpoint instead.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
build
Specifies the actor build to run. It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the actor (typically latest
).
Type: string
memory
Memory limit for the run, in megabytes. By default, the run uses a memory limit specified in the default run configuration for the actor.
Type: integer
outputRecordKey
Key of the record from run's default key-value store to be returned in the response. By default, it is OUTPUT
.
Type: string
timeout
Optional timeout for the run, in seconds. By default, the run uses a timeout specified in the default run configuration for the actor.
Type: integer
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
sync_run_task_no_input
Run a specific task and return its output. The run must finish in 300 seconds otherwise the API endpoint returns a timeout error.
Beware that it might be impossible to maintain an idle HTTP connection for an extended period, due to client timeout or network conditions. Make sure your HTTP client is configured to have a long enough connection timeout. If the connection breaks, you will not receive any information about the run and its status.
To run the Task asynchronously, use the Run task asynchronously endpoint instead.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
outputRecordKey
Key of the record from run's default key-value store to be returned in the response. By default, it is OUTPUT
.
Type: string
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
sync_run_task_with_input
Runs an actor task and synchronously returns its output. The run must finish in 300 seconds otherwise the API endpoint returns a timeout error.
Optionally, you can override the actor input configuration by passing a JSON object as the POST payload and setting the Content-Type: application/json
HTTP header. Note that if the object in the POST payload does not define a particular input property, the actor run uses the default value defined by the task (or actor's input schema if not defined by the task).
Beware that it might be impossible to maintain an idle HTTP connection for an extended period, due to client timeout or network conditions. Make sure your HTTP client is configured to have a long enough connection timeout. If the connection breaks, you will not receive any information about the run and its status.
Input fields from actor task configuration can be overloaded with values passed as the POST payload. Just make sure to specify Content-Type
header to be application/json
and input to be an object.
To run the task asynchronously, use the Run task API endpoint instead.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
$body
Type: object
{ }
outputRecordKey
Key of the record from run's default key-value store to be returned in the response. By default, it is OUTPUT
.
Type: string
webhooks
Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed. The value is a Base64-encoded JSON array of objects defining the webhooks.
Type: string
update_actor
Updates settings of an actor using values specified by an actor object passed as JSON in the POST payload. If the object does not define a specific property, its value will not be updated.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
$body
Type: object
{
"versions" : [ {
"sourceCode" : "Required string",
"sourceType" : "Required string",
"buildTag" : "Required string",
"baseDockerImage" : "string",
"applyEnvVarsToBuild" : "boolean",
"envVars" : [ [ {
"isSecret" : "boolean",
"name" : "string",
"value" : "string",
"key" : "string"
} ] ],
"versionNumber" : "Required string"
} ],
"restartOnError" : "boolean",
"name" : "Required string",
"description" : "string",
"isPublic" : "Required boolean",
"title" : "string"
}
update_request_in_queue
Updates request in queue. Mark request as handled by setting request.handledAt = new Date()
. If handledAt
is set then request will be removed from head of the queue.
Parameters
queueId (required)
Queue ID or username~queue-name
.
Type: string
requestId (required)
Request ID.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"id" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
update_request_in_queue_for_actor_last_run
Updates request in actor's last run's queue. Mark request as handled by setting request.handledAt = new Date()
. If handledAt
is set then request will be removed from head of the queue.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
requestId (required)
Request ID.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"id" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
status
Filter for the run status.
Type: string
update_request_in_queue_for_taskt_run
Updates request in task's last run's queue. Mark request as handled by setting request.handledAt = new Date()
. If handledAt
is set then request will be removed from head of the queue.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
requestId (required)
Request ID.
Type: string
$body
Type: object
{
"method" : "Required string",
"uniqueKey" : "Required string",
"id" : "Required string",
"url" : "Required string"
}
clientKey
A unique identifier of the client accessing the request queue. It must be a string between 1 and 32 characters long. This identifier is used to determine whether the queue was accessed by multiple clients. If clientKey
is not provided, the system considers this API call to come from a new client.
Type: string
forefront
Determines if request should be added to the head of the queue or to the end. Default value is false
(end of queue).
Type: boolean
status
Filter for the run status.
Type: string
update_task
Update settings of a task using values specified by an object passed as JSON in the POST payload. If the object does not define a specific property, its value is not updated.
Parameters
actorTaskId (required)
Task ID or a tilde-separated owner's username and task's name.
Type: string
$body
Type: object
{
"input" : {
"body" : "string",
"contentType" : "Required string"
},
"actId" : "string",
"name" : "string",
"options" : {
"build" : "string",
"memoryMbytes" : "number",
"timeoutSecs" : "number"
}
}
update_version_for_actor
Updates actor version using values specified by an version object passed as JSON in the POST payload. If the object does not define a specific property, its value will not be updated.
Parameters
actorId (required)
Actor ID or a tilde-separated owner's username and actor name.
Type: string
versionNumber (required)
Actor major and minor version of the actor.
Type: string
$body
Type: object
{
"sourceCode" : "string",
"sourceType" : "string",
"buildTag" : "string",
"baseDockerImage" : "string",
"applyEnvVarsToBuild" : "boolean",
"envVars" : [ [ {
"isSecret" : "boolean",
"name" : "string",
"value" : "string",
"key" : "string"
} ] ],
"versionNumber" : "string"
}
update_webhook
Updates a webhook using values specified by a webhook object passed as JSON in the POST payload. If the object does not define a specific property, its value will not be updated.
Parameters
webhookId (required)
Webhook ID.
Type: string
$body
Type: object
{
"isAdHoc" : "boolean",
"condition" : {
"actorTaskId" : "string"
},
"ignoreSslErrors" : "boolean",
"requestUrl" : "string",
"eventTypes" : [ "string" ],
"payloadTemplate" : "string"
}