---
title: "POST /v23/customers/{customersId}/batchJobs:mutate"
method: POST
path: "/v23/customers/{customersId}/batchJobs:mutate"
tags: ["customers"]
---

# POST /v23/customers/{customersId}/batchJobs:mutate

`POST /v23/customers/{customersId}/batchJobs:mutate`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{customersId}/batchJobs:mutate`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/doubleclicksearch`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch`
- TypeScript: <https://skmtc.dev/google/apis/searchads360/docs/v23/customers/:customersId/batchJobs:mutate/post.ts> (a function with typed inputs; its response is checked against the schema)

Mutates a batch job. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]() [ResourceCountLimitExceededError]()

## Path parameters

- `customersId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateBatchJobRequest: Request message for BatchJobService.MutateBatchJob.
  - `operation` GoogleAdsSearchads360V23ServicesBatchJobOperation: A single operation on a batch job.
    - `create` GoogleAdsSearchads360V23ResourcesBatchJob: A list of mutates being processed asynchronously. The mutates are uploaded by the user. The mutates themselves aren't readable and the results of the job can only be read using BatchJobService.ListBatchJobResults.
      - `id` string, int64: Output only. ID of this batch job.
      - `longRunningOperation` string: Output only. The resource name of the long-running operation that can be used to poll for completion. Only set when the batch job status is RUNNING or DONE.
      - `metadata` GoogleAdsSearchads360V23ResourcesBatchJobBatchJobMetadata: Additional information about the batch job. This message is also used as metadata returned in batch job Long Running Operations.
        - `completionDateTime` string: Output only. The time when this batch job was completed. Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00"
        - `creationDateTime` string: Output only. The time when this batch job was created. Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00"
        - `estimatedCompletionRatio` number, double: Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. This is empty if the job hasn't started running yet.
        - `executedOperationCount` string, int64: Output only. The number of mutate operations executed by the batch job. Present only if the job has started running.
        - `executionLimitSeconds` integer: Immutable. The approximate upper bound for how long a batch job can be executed, in seconds. If the job runs more than the given upper bound, the job will be canceled.
        - `operationCount` string, int64: Output only. The number of mutate operations in the batch job.
        - `startDateTime` string: Output only. The time when this batch job started running. Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:30"
      - `nextAddSequenceToken` string: Output only. The next sequence token to use when adding operations. Only set when the batch job status is PENDING.
      - `resourceName` string: Immutable. The resource name of the batch job. Batch job resource names have the form: `customers/{customer_id}/batchJobs/{batch_job_id}`
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'RUNNING' | 'DONE': Output only. Status of this batch job.
    - `remove` string: Remove operation: The batch job must not have been run. A resource name for the removed batch job is expected, in this format: `customers/{customer_id}/batchJobs/{batch_job_id}`

## Response `200`

Successful response

- GoogleAdsSearchads360V23ServicesMutateBatchJobResponse: Response message for BatchJobService.MutateBatchJob.
  - `result` GoogleAdsSearchads360V23ServicesMutateBatchJobResult: The result for the batch job mutate.
    - `resourceName` string: The resource name of the batch job.

---

[API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)