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

# POST /v1/indexing/{+name}:push

`POST /v1/indexing/{+name}:push`

Pushes an item onto a queue for later polling and updating. 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

- PushItemRequest
  - `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.
  - `item` PushItem — Represents an item to be pushed to the indexing queue.
    - `type` 'UNSPECIFIED' | 'MODIFIED' | 'NOT_MODIFIED' | 'REPOSITORY_ERROR' | 'REQUEUE' — The type of the push operation that defines the push behavior.
    - `structuredDataHash` string — Structured data hash of the item according to the repository. If specified, this is used to determine how to modify this item's status. Setting this field and the type field results in argument error. The maximum length is 2048 characters.
    - `metadataHash` string — The metadata hash of the item according to the repository. If specified, this is used to determine how to modify this item's status. Setting this field and the type field results in argument error. The maximum length is 2048 characters.
    - `contentHash` string — Content hash of the item according to the repository. If specified, this is used to determine how to modify this item's status. Setting this field and the type field results in argument error. The maximum length is 2048 characters.
    - `payload` string, byte — Provides additional document state information for the connector, such as an alternate repository ID and other metadata. The maximum length is 8192 bytes.
    - `queue` string — Queue to which this item belongs. The `default` queue is chosen if this field is not specified. The maximum length is 512 characters.
    - `repositoryError` RepositoryError — Errors when the connector is communicating to the source repository.
      - `type` 'UNKNOWN' | 'NETWORK_ERROR' | 'DNS_ERROR' | 'CONNECTION_ERROR' | 'AUTHENTICATION_ERROR' | 'AUTHORIZATION_ERROR' | 'SERVER_ERROR' | 'QUOTA_EXCEEDED' | 'SERVICE_UNAVAILABLE' | 'CLIENT_ERROR' — The type of error.
      - `errorMessage` string — Message that describes the error. The maximum allowable length of the message is 8192 characters.
      - `httpStatusCode` integer — Error codes. Matches the definition of HTTP status codes.
  - `connectorName` string — The name of connector making this call. Format: datasources/{source_id}/connectors/{ID}

## 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)