2026-10-26
▼ ▲ agentregistry.projects.locations.findings.list
Parameter Order : parent
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/findings
Parameters :
filter
Description : Optional. Filtering results
Location : query
Type : string
pageToken
Location : query
Description : Optional. A token identifying a page of results the server should return.
Type : string
orderBy
Location : query
Type : string
Description : Optional. Hint for how to order the results
pageSize
Location : query
Type : integer
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
Format : int32
parent
Type : string
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
Required : Yes
Description : Required. Parent value for ListFindingsRequest. Format: `projects/{project}/locations/{location}`.
HTTP Method : GET
Path : v1/{+parent}/findings
Description : Lists Findings in a given project and location.
Scopes :
▼ ▲ agentregistry.projects.locations.findings.get
Description : Gets details of a single Finding.
Scopes :
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/findings/{findingsId}
Path : v1/{+name}
Parameters :
name
Description : Required. The name of the Finding to retrieve. Format: `projects/{project}/locations/{location}/findings/{finding}`.
Type : string
Required : Yes
Pattern : ^projects/[^/]+/locations/[^/]+/findings/[^/]+$
Location : path
Parameter Order : name
HTTP Method : GET
▼ ▲ agentregistry.projects.locations.skills.create
Path : v1/{+parent}/skills
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills
Description : ========================================================================= # Skills Collection APIs Creates a Skill resource container, optionally publishing the initial SkillRevision inline in a single, atomic CRUD roundtrip.
Parameters :
skillId
Description : Required. Custom, user-defined unique container identifier. Must be unique within the parent project and location. This value should be 4-64 characters, and valid characters are `/a-z-/`.
Type : string
Location : query
parent
Required : Yes
Description : Required. The project and location location to bootstrap.
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
Type : string
requestId
Location : query
Description : Optional. Signed UUID request idempotency token.
Type : string
HTTP Method : POST
Parameter Order : parent
Scopes :
▼ ▲ agentregistry.projects.locations.skills.patch
Parameters :
name
Type : string
Location : path
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`).
Required : Yes
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
requestId
Type : string
Location : query
Description : Optional. Signed UUID request idempotency token.
updateMask
Type : string
Location : query
Description : Optional. Standard update target mask mapping relative fields.
Format : google-fieldmask
Description : Updates Skill metadata or overrides active pointers/state using REST standard PATCH.
Parameter Order : name
HTTP Method : PATCH
Scopes :
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
Path : v1/{+name}
▼ ▲ agentregistry.projects.locations.skills.get
HTTP Method : GET
Parameters :
name
Required : Yes
Description : Required. Target resource container name.
Location : path
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Type : string
Scopes :
Usemediadownloadservice : Yes
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
Path : v1/{+name}
Description : Fetches the active configuration and metadata of a Skill.
Supportsmediadownload : Yes
Parameter Order : name
▼ ▲ agentregistry.projects.locations.skills.list
Parameter Order : parent
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills
Scopes :
Path : v1/{+parent}/skills
Description : Lists logical Skills available in a project.
Parameters :
orderBy
Type : string
Description : Optional. Hint for how to order the results
Location : query
pageSize
Type : integer
Description : Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
Format : int32
Location : query
parent
Required : Yes
Type : string
Description : Required. Parent value for ListSkillsRequest
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
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
pageToken
Description : Optional. A token identifying a page of results the server should return.
Location : query
Type : string
HTTP Method : GET
▼ ▲ agentregistry.projects.locations.skills.delete
Parameters :
requestId
Description : Optional. Signed UUID request idempotency token.
Location : query
Type : string
name
Type : string
Location : path
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Description : Required. Target Skill container name to remove.
Required : Yes
force
Location : query
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.
Type : boolean
HTTP Method : DELETE
Parameter Order : name
Path : v1/{+name}
Scopes :
Description : Deletes a Skill container along with all its revisions.
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}
▼ ▲ agentregistry.projects.locations.skills.search
Parameters :
filter
Type : string
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
pageSize
Type : integer
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.
Location : query
Format : int32
parent
Required : Yes
Type : string
Pattern : ^projects/[^/]+/locations/[^/]+$
Location : path
Description : Required. Parent value for SearchSkillsRequest. Format: `projects/{project}/locations/{location}`.
pageToken
Type : string
Location : query
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.
searchType
Description : Optional. The type of search.
Enum :
Location : query
Type : string
Enum Descriptions :
searchString
Type : string
Location : query
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`.
Scopes :
Description : Custom deep-search method to filter by frontmatter or query SKILL.md text blobs.
HTTP Method : GET
Path : v1/{+parent}/skills:search
Parameter Order : parent
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills:search
▼ ▲ agentregistry.projects.locations.skills.revisions.create
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions
Description : Creates a new immutable revision and triggers validation pipelines.
Scopes :
Parameter Order : parent
Parameters :
requestId
Description : Optional. Signed UUID request idempotency token.
Location : query
Type : string
parent
Required : Yes
Description : Required. Parent logical container name.
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Location : path
Type : string
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])?$`
Path : v1/{+parent}/revisions
HTTP Method : POST
▼ ▲ agentregistry.projects.locations.skills.revisions.get
Parameters :
name
Required : Yes
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+/revisions/[^/]+$
Location : path
Type : string
Description : Required. Target revision name.
HTTP Method : GET
Scopes :
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions/{revisionsId}
Path : v1/{+name}
Usemediadownloadservice : Yes
Description : Gets details of a single immutable Revision.
Parameter Order : name
Supportsmediadownload : Yes
▼ ▲ agentregistry.projects.locations.skills.revisions.list
Path : v1/{+parent}/revisions
Parameter Order : parent
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions
Description : Lists all revisions belonging to a parent Skill.
Scopes :
Parameters :
pageToken
Location : query
Type : string
Description : Optional. Page offset token.
pageSize
Location : query
Type : integer
Description : Optional. Page limit size.
Format : int32
parent
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+$
Required : Yes
Type : string
Description : Required. Parent logical container name to query.
Location : path
HTTP Method : GET
▼ ▲ agentregistry.projects.locations.skills.revisions.delete
Path : v1/{+name}
Parameter Order : name
Scopes :
HTTP Method : DELETE
Description : Deletes a specific revision (restricted to admins to purge accidentally committed secrets).
Parameters :
name
Pattern : ^projects/[^/]+/locations/[^/]+/skills/[^/]+/revisions/[^/]+$
Description : Required. Target revision name to remove.
Required : Yes
Type : string
Location : path
requestId
Description : Optional. Signed UUID request idempotency token.
Type : string
Location : query
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}/revisions/{revisionsId}
▼ ▲ agentregistry.projects.locations.publishers.list
Scopes :
Path : v1/{+parent}/publishers
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/publishers
Description : Lists all Publishers in a location.
HTTP Method : GET
Parameter Order : parent
Parameters :
pageSize
Format : int32
Description : Optional. Page limit size.
Location : query
Type : integer
parent
Location : path
Type : string
Required : Yes
Pattern : ^projects/[^/]+/locations/[^/]+$
Description : Required. Parent location to query. Format: `projects/{project}/locations/{location}`
pageToken
Description : Optional. Page offset token.
Type : string
Location : query
▼ ▲ agentregistry.projects.locations.publishers.get
Flat Path : v1/projects/{projectsId}/locations/{locationsId}/publishers/{publishersId}
Description : Fetches details of a specific Publisher.
Path : v1/{+name}
Parameters :
name
Description : Required. Target publisher resource name. Format: `projects/{project}/locations/{location}/publishers/{publisher}`
Required : Yes
Type : string
Location : path
Pattern : ^projects/[^/]+/locations/[^/]+/publishers/[^/]+$
HTTP Method : GET
Parameter Order : name
Scopes :