---
title: "POST /v1/indexing/{+name}/items:poll"
method: POST
path: "/v1/indexing/{+name}/items:poll"
tags: ["indexing"]
---

# POST /v1/indexing/{+name}/items:poll

`POST /v1/indexing/{+name}/items:poll`

Polls for unreserved items from the indexing queue and marks a set as reserved, starting with items that have the oldest timestamp from the highest priority ItemStatus. The priority order is as follows: ERROR MODIFIED NEW_ITEM ACCEPTED Reserving items ensures that polling from other threads cannot create overlapping sets. After handling the reserved items, the client should put items back into the unreserved state, either by calling index, or by calling push with the type REQUEUE. Items automatically become available (unreserved) after 4 hours even if no update or push method is called. This API requires an admin or service account to execute. The service account used is the one whitelisted in the corresponding data source.

## Path parameters

- `name` string, required

## Request body

- PollItemsRequest
  - `debugOptions` DebugOptions — Shared request debug options for all cloudsearch RPC methods.
    - `enableDebugging` boolean — If you are asked by Google to help with debugging, set this field. Otherwise, ignore this field.
  - `limit` integer — Maximum number of items to return. The maximum value is 100 and the default value is 20.
  - `queue` string — Queue name to fetch items from. If unspecified, PollItems will fetch from 'default' queue. The maximum length is 100 characters.
  - `connectorName` string — The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}
  - `statusCodes` string[] — Limit the items polled to the ones with these statuses.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudsearch.md) · [All operations](https://skmtc.dev/google/apis/cloudsearch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudsearch/revisions/d64d6afc59a6/schema)