Method: tagKeys.getNamespaced

Retrieves a TagKey by its namespaced name. This method will return PERMISSION_DENIED if the key does not exist or the user does not have permission to view it.

HTTP request


The URL uses gRPC Transcoding syntax.

Query parameters



Required. A namespaced tag key name in the format {parentId}/{tagKeyShort}, such as 42/foo for a key with short name "foo" under the organization with ID 42 or r2-d2/bar for a key with short name "bar" under the project r2-d2.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of TagKey.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.