# BigQuery Reservation API API

> BigQuery Reservation API API on Apizie: 20 endpoints (Returns information about the reservation., Updates an existing assignment. Only the `priority` field can be updated., Deletes a assignment. No expansion will happen. Example: * Organization `organizationA` contains two…, Looks up assignments for a specified resource for a particular region. If the request is about a project: 1.…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-bigqueryreservation`
- Category: Analytics
- Status: byok
- Source: https://cloud.google.com/bigquery/
- Page: https://zieapi.vercel.app/api/analytics/googleapis-bigqueryreservation
- OpenAPI: https://zieapi.vercel.app/api/analytics/googleapis-bigqueryreservation/openapi.json

A service to modify your BigQuery reservations.

## Endpoints

### Returns information about the reservation.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Resource name of the reservation to retrieve. E.g., `projects/myproject/locations/US/reservations/team1-prod` |

### Updates an existing assignment. Only the `priority` field can be updated.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Output only. Name of the resource. E.g.: `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. The assignment_id must… |
| updateMask | string | no | Standard field mask for the set of fields to be updated. |
| body | object | yes | JSON request body |

### Deletes a assignment. No expansion will happen. Example: * Organization `organizationA` contains two…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Name of the resource, e.g. `projects/myproject/locations/US/reservations/team1-prod/assignments/123` |

### Looks up assignments for a specified resource for a particular region. If the request is about a project: 1.…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-search-all-assignment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return per page. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. The resource name with location (project name could be the wildcard '-'), e.g.: `projects/-/locations/US`. |
| query | string | no | Please specify resource name as assignee in the query. Examples: * `assignee=projects/myproject` * `assignee=folders/123` *… |

### Deprecated: Looks up assignments for a specified resource for a particular region. If the request is about a…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-search-assignments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return per page. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. The resource name of the admin project(containing project and location), e.g.: `projects/myproject/locations/US`. |
| query | string | no | Please specify resource name as assignee in the query. Examples: * `assignee=projects/myproject` * `assignee=folders/123` *… |

### Lists all the capacity commitments for the admin project.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-capacity-commitments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. Resource name of the parent reservation. E.g., `projects/myproject/locations/US` |

### Creates a new capacity commitment resource.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-capacity-commitments-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| capacityCommitmentId | string | no | The optional capacity commitment ID. Capacity commitment name will be generated automatically if this field is empty. This field must only… |
| enforceSingleAdminProjectPerOrg | boolean | no | If true, fail the request if another project in the organization has a capacity commitment. |
| parent | string | yes | Required. Resource name of the parent reservation. E.g., `projects/myproject/locations/US` |
| body | object | yes | JSON request body |

### Merges capacity commitments of the same plan into a single commitment. The resulting capacity commitment has…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-capacity-commitments-3` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Parent resource that identifies admin project and location e.g., `projects/myproject/locations/us` |
| body | object | yes | JSON request body |

### Splits capacity commitment to two commitments of the same plan and `commitment_end_time`. A common use case…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-capacity-commitments-4` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The resource name e.g.,: `projects/myproject/locations/US/capacityCommitments/123` |
| body | object | yes | JSON request body |

### Lists all the reservation groups for the project in the specified location.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservation-groups-li` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return per page. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. The parent resource name containing project and location, e.g.: `projects/myproject/locations/US` |

### Creates a new reservation group.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservation-groups-cr` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Project, location. E.g., `projects/myproject/locations/US` |
| reservationGroupId | string | no | Required. The reservation group ID. It must only contain lower case alphanumeric characters or dashes. It must start with a letter and… |
| body | object | yes | JSON request body |

### Lists all the reservations for the project in the specified location.
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return per page. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. The parent resource name containing project and location, e.g.: `projects/myproject/locations/US` |

### Creates a new reservation resource.
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Project, location. E.g., `projects/myproject/locations/US` |
| reservationId | string | no | The reservation ID. It must only contain lower case alphanumeric characters or dashes. It must start with a letter and must not end with a… |
| body | object | yes | JSON request body |

### Fail over a reservation to the secondary location. The operation should be done in the current secondary…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-failover` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Resource name of the reservation to failover. E.g., `projects/myproject/locations/US/reservations/team1-prod` |
| body | object | yes | JSON request body |

### Gets the access control policy for a resource. May return: * A`NOT_FOUND` error if the resource doesn't…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-3` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| options.requestedPolicyVersion | integer | no | Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid… |
| resource | string | yes | REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names)… |

### Sets an access control policy for a resource. Replaces any existing policy. Supported resources are: -…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-4` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| resource | string | yes | REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names)… |
| body | object | yes | JSON request body |

### Gets your permissions on a resource. Returns an empty set of permissions if the resource doesn't exist.…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-5` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| resource | string | yes | REQUIRED: The resource for which the policy detail is being requested. See [Resource… |
| body | object | yes | JSON request body |

### Lists assignments. Only explicitly created assignments will be returned. Example: * Organization…
`GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-6` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of items to return per page. |
| pageToken | string | no | The next_page_token value returned from a previous List request, if any. |
| parent | string | yes | Required. The parent resource name e.g.: `projects/myproject/locations/US/reservations/team1-prod` Or:… |

### Creates an assignment object which allows the given project to submit jobs of a certain type using slots…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-7` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| assignmentId | string | no | The optional assignment ID. Assignment name will be generated automatically if this field is empty. This field must only contain lower… |
| parent | string | yes | Required. The parent resource name of the assignment E.g. `projects/myproject/locations/US/reservations/team1-prod` |
| body | object | yes | JSON request body |

### Moves an assignment under a new reservation. This differs from removing an existing assignment and…
`POST https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-assignme-8` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The resource name of the assignment, e.g. `projects/myproject/locations/US/reservations/team1-prod/assignments/123` |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the BigQuery Reservation API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/analytics:googleapis-bigqueryreservation/bigqueryreservation-projects-locations-reservations-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the BigQuery Reservation API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. BigQuery Reservation API itself also needs your own key from googleapis.com.

### Can AI agents use the BigQuery Reservation API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-bigqueryreservation.

### What is the status of the BigQuery Reservation API API?
Needs your own provider key (bring your own key)