Type to search.

Get an agent's access control list

Base URL
https://{kibana_url}
  • GET /api/agent_builder/agents/{id}/access_control
  • GET /s/{space_id}/api/agent_builder/agents/{id}/access_control
Auth The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Get the access control for a specific agent. Callers without permission to manage access control receive permissions.update_access_control: false and only their own entry. To learn more about agents, refer to the agents documentation.

Required privileges

Privileges agentBuilder:read

Path parameters

space_id string optional

An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

id string required

The unique identifier of the agent whose access control to retrieve.

Responses

200

Indicates a successful response

application/json
404

Not Found — no agent with this ID is visible to the caller. Matches the existing agentNotFound shape, so unprivileged callers cannot probe for hidden agents.

application/json