Skip to Content
kosemdocs
ReferenceAPIAgents

List secret agent grants

Lists the agents that can use a secret, the most recently granted first. Grants aren't in the secret's IAM policy, so this takes what reading its policy takes. The title of a private agent is left out.

GET
/v1/projects/{project}/secrets/{secret}/agentGrants

Lists the agents that can use a secret, the most recently granted first.

Grants aren't in the secret's IAM policy, so this takes what reading its policy takes. The title of a private agent is left out.

Authorization

bearer
headerAuthorizationBearer <token>

An access token, or an API key.

Path Parameters

project*string

The project's ID.

Match^prj_[0-7][0-9a-hjkmnp-tv-z]{25}$
secret*string

The secret's ID.

Match^sec_[0-7][0-9a-hjkmnp-tv-z]{25}$

Query Parameters

pageSize?integer

Maximum number of items to return. Defaults to 50; values above 500 are treated as 500.

Formatint32
Range0 <= value
pageToken?string

Page token from a previous response.

Response Body

OK

application/json
  1. response
grants*array<>

Grants, the most recent first.

nextPageToken*string

Token for the next page; empty on the last page.

Example Request
curl -X GET 'https://api.kosem.ai/v1/projects/string/secrets/string/agentGrants'
Example Response
{
  "grants": [
    {
      "agent": "string",
      "createTime": "2019-08-24T14:15:22Z",
      "grantor": "string",
      "private": true,
      "title": "string"
    }
  ],
  "nextPageToken": "string"
}