# Agent Registry API API

> Agent Registry API API on Apizie: 27 endpoints (Gets details of a single immutable Revision., Updates Skill metadata or overrides active pointers/state using REST standard PATCH., Deletes a specific revision (restricted to admins to purge accidentally committed secrets)., Lists information about the supported locations for this service. This method lists locations based on the…, …) 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/dev-tools:google-agentregistry/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:google-agentregistry`
- Category: Dev Tools
- Status: byok
- Source: https://docs.cloud.google.com/agent-registry/overview
- Page: https://zieapi.vercel.app/api/dev-tools/google-agentregistry
- OpenAPI: https://zieapi.vercel.app/api/dev-tools/google-agentregistry/openapi.json

Agent Registry is a centralized, unified catalog that lets you store, discover, and govern Model Context Protocol (MCP) servers, tools, and AI agents within Google Cloud.

## Endpoints

### Gets details of a single immutable Revision.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Target revision name. |

### Updates Skill metadata or overrides active pointers/state using REST standard PATCH.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Identifier. Resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}` The `{skill}` segment acts as the… |
| requestId | string | no | Optional. Signed UUID request idempotency token. |
| updateMask | string | no | Optional. Standard update target mask mapping relative fields. |
| body | object | yes | JSON request body |

### Deletes a specific revision (restricted to admins to purge accidentally committed secrets).
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. Target revision name to remove. |
| requestId | string | no | Optional. Signed UUID request idempotency token. |

### Lists information about the supported locations for this service. This method lists locations based on the…
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| extraLocationTypes | string | no | Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage. |
| filter | string | no | A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is… |
| name | string | yes | The resource that owns the locations collection, if applicable. |
| pageSize | integer | no | The maximum number of results to return. If not set, the service selects a default. |
| pageToken | string | no | A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page. |

### Lists Agents under an AI Application.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-ai-applications-agents-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. Parent value (AI Application) for ListAiApplicationAgentsRequest. Format:… |

### Searches Agents in a given project and location.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-agents-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Parent value for SearchAgentsRequest. Format: `projects/{project}/locations/{location}`. |
| body | object | yes | JSON request body |

### Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not…
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-get-iam-policy` (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)… |

### Lists AI Applications in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-ai-applications-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filtering results. |
| orderBy | string | no | Optional. Hint for how to order the results. |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. Parent project and location to query. Format: `projects/{project}/locations/{location}` |

### Sets the access control policy on the specified resource. Replaces any existing policy. Can return…
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-set-iam-policy` (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 |

### Returns permissions that a caller has on the specified resource. If the resource does not exist, this will…
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-test-iam-permissions` (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 Endpoints in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-endpoints-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. A query string used to filter the list of endpoints returned. The filter expression must follow AIP-160 syntax. Filtering is… |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. The project and location to list endpoints in. Expected format: `projects/{project}/locations/{location}`. |

### Lists McpServers in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-mcp-servers-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filtering results |
| orderBy | string | no | Optional. Hint for how to order the results |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. Parent value for ListMcpServersRequest. Format: `projects/{project}/locations/{location}`. |

### Lists Bindings in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-bindings-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. A query string used to filter the list of bindings returned. The filter expression must follow AIP-160 syntax. |
| orderBy | string | no | Optional. Hint for how to order the results |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. Page size is 500 if unspecified and is capped at `500` even… |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. The project and location to list bindings in. Expected format: `projects/{project}/locations/{location}`. |

### Creates a new Binding in a given project and location.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-bindings-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bindingId | string | no | Required. The ID to use for the binding, which will become the final component of the binding's resource name. This value should be 4-63… |
| parent | string | yes | Required. The project and location to create the Binding in. Expected format: `projects/{project}/locations/{location}`. |
| requestId | string | no | Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will… |
| body | object | yes | JSON request body |

### Fetches available Bindings.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-bindings-fetch-available` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. Page size is 500 if unspecified and is capped at `500` even… |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. The parent, in the format `projects/{project}/locations/{location}`. |
| sourceIdentifier | string | no | The identifier of the source Agent. Format: * `urn:agent:{publisher}:{namespace}:{name}` |
| targetIdentifier | string | no | Optional. The identifier of the target Agent, MCP Server, or Endpoint. Format: * `urn:agent:{publisher}:{namespace}:{name}` *… |

### Lists Findings in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-findings-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Filtering results |
| orderBy | string | no | Optional. Hint for how to order the results |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. Parent value for ListFindingsRequest. Format: `projects/{project}/locations/{location}`. |

### Searches McpServers in a given project and location.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-mcp-servers-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Parent value for SearchMcpServersRequest. Format: `projects/{project}/locations/{location}`. |
| body | object | yes | JSON request body |

### Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the…
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-operations-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | The name of the operation resource to be cancelled. |
| body | object | yes | JSON request body |

### Lists operations that match the specified filter in the request. If the server doesn't support this method,…
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | The standard list filter. |
| name | string | yes | The name of the operation's parent resource. |
| pageSize | integer | no | The standard list page size. |
| pageToken | string | no | The standard list page token. |
| returnPartialSuccess | boolean | no | When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the… |

### Lists all Publishers in a location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-publishers-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. Page limit size. |
| pageToken | string | no | Optional. Page offset token. |
| parent | string | yes | Required. Parent location to query. Format: `projects/{project}/locations/{location}` |

### Lists Services in a given project and location.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-services-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. A query string used to filter the list of services returned. The filter expression must follow AIP-160 syntax. Filtering is… |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. The project and location to list services in. Expected format: `projects/{project}/locations/{location}`. |

### Creates a new Service in a given project and location.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-services-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The project and location to create the Service in. Expected format: `projects/{project}/locations/{location}`. |
| requestId | string | no | Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will… |
| serviceId | string | no | Required. The ID to use for the service, which will become the final component of the service's resource name. This value should be 4-63… |
| body | object | yes | JSON request body |

### Lists logical Skills available in a project.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon… |
| orderBy | string | no | Optional. Hint for how to order the results |
| pageSize | integer | no | Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| pageToken | string | no | Optional. A token identifying a page of results the server should return. |
| parent | string | yes | Required. Parent value for ListSkillsRequest |

### ========================================================================= # Skills Collection APIs Creates a…
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The project and location location to bootstrap. |
| requestId | string | no | Optional. Signed UUID request idempotency token. |
| skillId | string | no | Required. Custom, user-defined unique container identifier. Must be unique within the parent project and location. This value should be… |
| body | object | yes | JSON request body |

### Custom deep-search method to filter by frontmatter or query SKILL.md text blobs.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based… |
| pageSize | integer | no | Optional. The maximum number of search results to return per page. The page size is capped at `100`, even if a larger value is specified.… |
| pageToken | string | no | Optional. If present, retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of… |
| parent | string | yes | Required. Parent value for SearchSkillsRequest. Format: `projects/{project}/locations/{location}`. |
| searchString | string | no | Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be… |
| searchType | string | no | Optional. The type of search. |

### Lists all revisions belonging to a parent Skill.
`GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | Optional. Page limit size. |
| pageToken | string | no | Optional. Page offset token. |
| parent | string | yes | Required. Parent logical container name to query. |

### Creates a new immutable revision and triggers validation pipelines.
`POST https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. Parent logical container name. |
| requestId | string | no | Optional. Signed UUID request idempotency token. |
| skillRevisionId | string | no | Optional. Custom, user-defined unique revision identifier. Format: 4-63 characters, matching regex `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$` |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Agent Registry API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/dev-tools:google-agentregistry/agentregistry-projects-locations-skills-revisions-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Agent Registry 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 dev-tools:google-agentregistry.

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