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

# POST /v23/customers/{+customerId}/batchJobs:mutate

`POST /v23/customers/{+customerId}/batchJobs:mutate`

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

## Path parameters

- `customerId` 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.
      - `nextAddSequenceToken` string — Output only. The next sequence token to use when adding operations. Only set when the batch job status is PENDING.
      - `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"
        - `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"
        - `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.
        - `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.
      - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'RUNNING' | 'DONE' — Output only. Status of this batch job.
      - `resourceName` string — Immutable. The resource name of the batch job. Batch job resource names have the form: `customers/{customer_id}/batchJobs/{batch_job_id}`
      - `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.
      - `id` string, int64 — Output only. ID 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

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)