2026-07-23
▼ ▲ agentregistry.projects.locations.publishers.get
Parameter Order : name
Description : Fetches details of a specific Publisher.
HTTP Method : GET
Path : v1alpha/{+name}
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}
Parameters :
name
Type : string
Description : Required. Target publisher resource name. Format: `projects/{project}/locations/{location}/publishers/{publisher}`
Pattern : ^projects/[^/]+/locations/[^/]+/publishers/[^/]+$
Location : path
Required : Yes
▼ ▲ agentregistry.projects.locations.publishers.list
HTTP Method : GET
Description : Lists all Publishers in a location.
Parameter Order : parent
Path : v1alpha/{+parent}/publishers
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/publishers
Parameters :
pageSize
Description : Optional. Page limit size.
Location : query
Type : integer
Format : int32
parent
Description : Required. Parent location to query. Format: `projects/{project}/locations/{location}`
Pattern : ^projects/[^/]+/locations/[^/]+$
Type : string
Location : path
Required : Yes
pageToken
Location : query
Type : string
Description : Optional. Page offset token.
▼ ▲ agentregistry.projects.locations.skills.revisions.get
Parameters :
name
Location : path
Required : Yes
Description : Required. Target revision name.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+/revisions/[^/]+$
Type : string
Supportsmediadownload : Yes
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions/{revisionsId}
Path : v1alpha/{+name}
Scopes :
HTTP Method : GET
Usemediadownloadservice : Yes
Parameter Order : name
Description : Gets details of a single immutable Revision.
▼ ▲ agentregistry.projects.locations.skills.revisions.delete
Description : Deletes a specific revision (restricted to admins to purge accidentally committed secrets).
Parameter Order : name
HTTP Method : DELETE
Path : v1alpha/{+name}
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions/{revisionsId}
Parameters :
name
Type : string
Description : Required. Target revision name to remove.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+/revisions/[^/]+$
Location : path
Required : Yes
requestId
Location : query
Type : string
Description : Optional. Signed UUID request idempotency token.
▼ ▲ agentregistry.projects.locations.skills.revisions.create
Path : v1alpha/{+parent}/revisions
Scopes :
Parameter Order : parent
Description : Creates a new immutable revision and triggers validation pipelines.
HTTP Method : POST
Parameters :
parent
Description : Required. Parent logical container name.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Type : string
Location : path
Required : Yes
skillRevisionId
Location : query
Type : string
Description : Optional. Custom, user-defined unique revision identifier. Format: 4-63 characters, matching regex `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`
requestId
Description : Optional. Signed UUID request idempotency token.
Location : query
Type : string
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions
▼ ▲ agentregistry.projects.locations.skills.revisions.list
Parameter Order : parent
Description : Lists all revisions belonging to a parent Skill.
HTTP Method : GET
Path : v1alpha/{+parent}/revisions
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions
Parameters :
pageSize
Description : Optional. Page limit size.
Location : query
Type : integer
Format : int32
parent
Location : path
Required : Yes
Description : Required. Parent logical container name to query.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Type : string
pageToken
Location : query
Type : string
Description : Optional. Page offset token.
▼ ▲ agentregistry.projects.locations.skills.create
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills
Parameters :
requestId
Location : query
Type : string
Description : Optional. Signed UUID request idempotency token.
skillId
Description : Required. Custom, user-defined unique container identifier. Must be unique within the parent project and location. This value should be 4-63 characters, and valid characters are `/a-z-/`.
Location : query
Type : string
parent
Type : string
Description : Required. The project and location location to bootstrap.
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
Required : Yes
Description : ========================================================================= # Skills Collection APIs Creates a Skill resource container, optionally publishing the initial SkillRevision inline in a single, atomic CRUD roundtrip.
Parameter Order : parent
HTTP Method : POST
Path : v1alpha/{+parent}/skills
Scopes :
▼ ▲ agentregistry.projects.locations.skills.get
Description : Fetches the active configuration and metadata of a Skill.
Parameter Order : name
HTTP Method : GET
Path : v1alpha/{+name}
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
Parameters :
name
Location : path
Required : Yes
Description : Required. Target resource container name.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Type : string
▼ ▲ agentregistry.projects.locations.skills.list
Parameters :
pageToken
Location : query
Type : string
Description : Optional. A token identifying a page of results the server should return.
orderBy
Description : Optional. Hint for how to order the results
Location : query
Type : string
pageSize
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
Location : query
Type : integer
Format : int32
filter
Description : Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
Location : query
Type : string
parent
Location : path
Required : Yes
Type : string
Description : Required. Parent value for ListSkillsRequest
Pattern : ^projects/[^/]+/locations/[^/]+$
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills
Path : v1alpha/{+parent}/skills
Scopes :
Description : Lists logical Skills available in a project.
Parameter Order : parent
HTTP Method : GET
▼ ▲ agentregistry.projects.locations.skills.search
Parameters :
searchType
Enum :
Location : query
Description : Optional. The type of search.
Type : string
Enum Descriptions :
pageToken
Location : query
Type : string
Description : Optional. If present, retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of all other method parameters, must be identical to those in the previous call.
parent
Type : string
Description : Required. Parent value for SearchSkillsRequest. Format: `projects/{project}/locations/{location}`.
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
Required : Yes
filter
Description : Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
Location : query
Type : string
pageSize
Location : query
Type : integer
Format : int32
Description : 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. A negative value will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a default value of `20` will be used. The server may return fewer results than requested.
searchString
Location : query
Type : string
Description : Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills:search
Path : v1alpha/{+parent}/skills:search
Scopes :
HTTP Method : GET
Description : Custom deep-search method to filter by frontmatter or query SKILL.md text blobs.
Parameter Order : parent
▼ ▲ agentregistry.projects.locations.skills.patch
HTTP Method : PATCH
Description : Updates Skill metadata or overrides active pointers/state using REST standard PATCH.
Parameter Order : name
Path : v1alpha/{+name}
Scopes :
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
Parameters :
requestId
Location : query
Type : string
Description : Optional. Signed UUID request idempotency token.
updateMask
Description : Optional. Standard update target mask mapping relative fields.
Location : query
Type : string
Format : google-fieldmask
name
Type : string
Description : Identifier. Resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}` The `{skill}` segment acts as the resource ID. If the skill is associated with a Publisher, this segment typically uses a hyphenated namespace prefix corresponding to the publisher (e.g., `google-workspace-create-docs`).
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Location : path
Required : Yes
▼ ▲ agentregistry.projects.locations.skills.delete
Flat Path : v1alpha/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
Parameters :
requestId
Description : Optional. Signed UUID request idempotency token.
Location : query
Type : string
force
Location : query
Type : boolean
Description : Optional. If set to true, any child SkillRevisions under this Skill will also be deleted. Otherwise, the request will only succeed if the Skill has no child SkillRevisions.
name
Location : path
Required : Yes
Description : Required. Target Skill container name to remove.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Type : string
HTTP Method : DELETE
Parameter Order : name
Description : Deletes a Skill container along with all its revisions.
Path : v1alpha/{+name}
Scopes :