Skip to Content
kosemdocs
ReferenceAPIAgents

List agent grants

Lists the access profiles and secrets granted to an agent, with scopes, expiry times, and usage stats.

GET
/v1/projects/{project}/agents/{agent}/grants

Lists the access profiles and secrets granted to an agent, with scopes, expiry times, and usage stats.

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}$
agent*string

The agent's ID.

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

Response Body

OK

application/json
  1. response
grants*array<>

Grants held by the agent, oldest first.

Example Request
curl -X GET 'https://api.kosem.ai/v1/projects/string/agents/string/grants'
Example Response
{
  "grants": [
    {
      "alias": "string",
      "createTime": "2019-08-24T14:15:22Z",
      "expireTime": "2019-08-24T14:15:22Z",
      "grantor": "string",
      "id": "string",
      "lastUsedTime": "2019-08-24T14:15:22Z",
      "provider": "string",
      "scope": {
        "property1": null,
        "property2": null
      },
      "target": "string",
      "targetKind": "ACCESS_PROFILE",
      "useCount": 0
    }
  ]
}