Actor builds6

Actor runs10

Actor tasks15

Actors9

Actors/Actor builds6

Actors/Actor runs11

Actors/Actor versions13

Actors/Webhook collection1

Default dataset6

Default key-value store9

Default request queue15

Last Actor run's abort1

Last Actor run's default dataset6

Last Actor run's default key-value store9

Last Actor run's default request queue15

Last Actor run's log1

Last Actor run's metamorph1

Last Actor run's reboot1

Last Actor task run's abort1

Last Actor task run's default dataset6

Last Actor task run's default key-value store9

Last Actor task run's default request queue15

Last Actor task run's log1

Last Actor task run's metamorph1

Last Actor task run's reboot1

Logs1

Schedules7

Storage/Datasets9

Storage/Key-value stores12

Storage/Request queues7

Storage/Request queues/Requests5

Storage/Request queues/Requests locks5

Store1

Tools4

Tools/Encoding2

Users5

Users/Usage6

Webhooks/Webhook dispatches2

Webhooks/Webhooks7

Storage/Request queues

Batch add requests to request queue

Changed on Oct 27, 2026

Adds requests to the queue in batch. The maximum requests in batch is limited to 25. The response contains an array of unprocessed and processed requests. If any add operation fails because the request queue rate limit is exceeded or an internal failure occurs, the failed request is returned in the unprocessedRequests response parameter. You can resend these requests to add. It is recommended to use an exponential backoff algorithm for these retries. If a request with the same uniqueKey was already present in the queue, then it returns an ID of the existing request.

post/v2/request-queues/{queueId}/requests/batch

Request

Base URL
https://api.apify.com
Auth
- HTTP bearer
- or API key in query parameter token

Path parameters

queueIdstring required

Example:WkzbQMuFYuamGv3YF

Queue ID or username~queue-name.

Query parameters

clientKeystring

Example:client-abc

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. For details, see the hadMultipleClients field returned by the Get request queue head endpoint.

forefrontstring

Example:false

Determines if request should be added to the head of the queue or to the end. Default value is false (end of queue).

Request body

uniqueKeystring required

A unique key used for request de-duplication. Requests with the same unique key are considered identical.

urlstring required

The URL of the request.

retryCountinteger

The number of times this request has been retried.

loadedUrlstring nullable

The final URL that was loaded, after redirects (if any).

headersobject nullable

HTTP headers sent with the request.

userDataRequestUserData

Custom user data attached to the request. Can contain arbitrary fields.

noRetryboolean nullable

Indicates whether the request should not be retried if processing fails.

errorMessagesstring[] nullable

Error messages recorded from failed processing attempts.

handledAtstring date-time nullable

The timestamp when the request was marked as handled, if applicable.

Example request

[
  {
    "uniqueKey": "GET|60d83e70|e3b0c442|https://apify.com",
    "url": "https://apify.com",
    "method": "GET",
    "loadedUrl": "https://apify.com/jobs",
    "userData": {
      "label": "DETAIL",
      "customField": "custom-value"
    },
    "handledAt": "2019-06-16T10:23:31.607Z"
  }
]

Response

Example response

{
  "data": {
    "processedRequests": [
      {
        "requestId": "YiKoxjkaS9gjGTqhF",
        "uniqueKey": "http://example.com",
        "wasAlreadyPresent": true,
        "wasAlreadyHandled": false
      }
    ],
    "unprocessedRequests": [
      {
        "uniqueKey": "http://example.com/2",
        "url": "http://example.com/2",
        "method": "GET"
      }
    ]
  }
}

Changes

Oct 27, 2026ec76185eb934 Revision changes
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Oct 20, 202616b486b0397a Revision changes
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new full-permissions-require-verified-owner enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new input-validation-timed-out enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new mcp-connector-actor-not-allowed enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new more-public-actors-require-verified-owner enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new readme-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new schemas-required enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new standby-deployment-invalid enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-account enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status
- warning
  added the new too-many-public-actor-tasks-per-actor enum value to the / response property for the response status

Operation history (6 revisions)