Skip to main content
GET
/
policies
/
{policyName}
/
usages
List resources using a policy
curl --request GET \
  --url https://api.blaxel.ai/v0/policies/{policyName}/usages \
  --header 'Authorization: Bearer <token>'
{
  "agents": [
    {}
  ],
  "functions": [
    {}
  ],
  "jobs": [
    {}
  ],
  "models": [
    {}
  ],
  "sandboxes": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.blaxel.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

OAuth2 authentication with JWT tokens

Path Parameters

​
policyName
string
required

Unique name identifier of the policy

Response

200 - application/json

successful operation

Resources currently referencing a policy. Returned by GET /policies/{name}/usages so the policies UI can render attachments without fetching the agents/models/functions listings full.

​
agents
object[]

Names of agents whose spec.policies contains this policy.

​
functions
object[]

Names of functions whose spec.policies contains this policy.

​
jobs
object[]

Names of jobs whose spec.policies contains this policy.

​
models
object[]

Names of models whose spec.policies contains this policy.

​
sandboxes
object[]

Names of sandboxes whose spec.policies contains this policy.

Last modified on May 20, 2026