Agents

Replace Agent Permissions

Changed on

Replace all permissions for an agent.

put/agents/{agent_id}/permissions

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /agents/{agent_id}/permissions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Path parameters

agent_idstring required

ID of the agent.

Example:agnt_6968b3984d1c238dbe7e2e29

Request body

permissionsstring[] required

The full set of permissions the agent should hold.

Example request

{
  "permissions": [
    "apis:read",
    "capabilities:execute"
  ]
}

Response

Successful Response

permissionsstring[] required

Permissions currently granted to the agent.

Example response

{
  "permissions": [
    "apis:read",
    "capabilities:execute"
  ]
}

Changes