Skip to Content
kosemdocs
ReferenceAPIAgents

Get IAM policy

Gets the IAM policy of an agent: who may see it and write to it, apart from the roles on its project. Its creator owns it.

GET
/v1/projects/{project}/agents/{agent}/iam-policy

Gets the IAM policy of an agent: who may see it and write to it, apart from the roles on its project. Its creator owns it.

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
bindings*array<>

Role bindings. Each role appears at most once.

etag*string

Opaque version of the policy. Send it back when setting the policy; the update fails with aborted if the policy changed in between.

Example Request
curl -X GET 'https://api.kosem.ai/v1/projects/string/agents/string/iam-policy'
Example Response
{
  "bindings": [
    {
      "members": [
        "string"
      ],
      "role": "string"
    }
  ],
  "etag": "string"
}