# Cloud Run Admin API

> Cloud Run Admin API skill. Use when working with Cloud Run Admin for {name}, {name}:run, {name}:wait. Covers 16 endpoints.

- Skill: `lap-platform/cloud-run-admin-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lap-platform/cloud-run-admin-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lap-platform/cloud-run-admin-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Lap-Platform (https://skillmd.com/u/lap-platform)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/lap-platform/cloud-run-admin-api

---


# Cloud Run Admin API
API version: v2

## Auth
OAuth2 | OAuth2

## Base URL
https://run.googleapis.com/

## Setup
1. Configure auth: OAuth2 | OAuth2
2. GET /v2/{name}/operations -- verify access
3. POST /v2/{name}:run -- create first resource

## Endpoints

16 endpoints across 7 groups. See references/api-spec.lap for full details.

### {name}
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /v2/{name} | Deletes a Revision. |
| GET | /v2/{name} | Gets information about a Revision. |
| PATCH | /v2/{name} | Updates a Service. |
| GET | /v2/{name}/operations | Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. |

### {name}:run
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/{name}:run | Triggers creation of a new Execution of this Job. |

### {name}:wait
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/{name}:wait | Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state. If the operation is already done, the latest state is immediately returned. If the timeout specified is greater than the default HTTP/RPC timeout, the HTTP/RPC timeout is used. If the server does not support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Note that this method is on a best-effort basis. It may return the latest state before the specified timeout (including immediately), meaning even an immediate response is no guarantee that the operation is done. |

### {parent}
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/{parent}/executions | Lists Executions from a Job. |
| GET | /v2/{parent}/jobs | Lists Jobs. |
| POST | /v2/{parent}/jobs | Creates a Job. |
| GET | /v2/{parent}/revisions | Lists Revisions from a given Service, or from a given location. |
| GET | /v2/{parent}/services | Lists Services. |
| POST | /v2/{parent}/services | Creates a new Service in a given project and location. |
| GET | /v2/{parent}/tasks | Lists Tasks from an Execution of a Job. |

### {resource}:getIamPolicy
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/{resource}:getIamPolicy | Gets the IAM Access Control policy currently in effect for the given Cloud Run Service. This result does not include any inherited policies. |

### {resource}:setIamPolicy
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/{resource}:setIamPolicy | Sets the IAM Access control policy for the specified Service. Overwrites any existing policy. |

### {resource}:testIamPermissions
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/{resource}:testIamPermissions | Returns permissions that a caller has on the specified Project. There are no permissions required for making this API call. |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all operations?" -> GET /v2/{name}/operations
- "List all executions?" -> GET /v2/{parent}/executions
- "List all jobs?" -> GET /v2/{parent}/jobs
- "Create a job?" -> POST /v2/{parent}/jobs
- "List all revisions?" -> GET /v2/{parent}/revisions
- "List all services?" -> GET /v2/{parent}/services
- "Create a service?" -> POST /v2/{parent}/services
- "List all tasks?" -> GET /v2/{parent}/tasks
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Create/update endpoints typically return the created/updated object

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)