Skip to main content
Control which agent identities can access specific vault secrets. Access rules are per-secret — you grant an identity access to one secret at a time. An identity without an access rule for a given secret cannot read it.

Grant identity access

Grant an agent identity access to a specific secret. Use an admin-scoped API key to create a new grant. When an agent creates a secret, it automatically receives access and does not need a separate grant. If you can read the secret and the requested grant already exists, this endpoint returns 409 Conflict, including when you use an agent-scoped key. An agent-scoped key cannot create a new grant and receives 403 Forbidden.

Path parameters

Request body

Request example

JSON

Response (201)

JSON

Error responses

Code examples


List access rules

List all identity access rules for a secret.

Path parameters

Response (200)

JSON

Code examples


Revoke identity access

Revoke an identity’s access to a secret. Returns 204 No Content on success.

Path parameters

Code examples


Access rule object