---
title: "List the workspace's agent grants"
method: GET
path: "/agent/grants"
tags: ["Agents"]
---

# List the workspace's agent grants

`GET /agent/grants`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/agent/grants`
- Auth: HTTP bearer

Every grant of the workspace with the current month's spend, for the console's manage screen. Needs a tenant API key held by an owner or admin (`agent:manage`). Refresh tokens are never returned.

## Response `200`

The grants

- AgentGrantList
  - `grants` AgentGrant[], required
    - `id` string, required: Starts with `grt_`.
    - `tenant_id` string, required
    - `agent_client_id` string, required
    - `application_id` string: The application the grant is bound to.
    - `authorized_by` string: The member who approved it.
    - `agent_name` string, required
    - `scopes` AgentScope[], required
    - `can_purchase` boolean, required: True when the grant carries `domains:purchase`.
    - `spend_cap_cents` integer, required: The monthly spend cap in US cents (0 without purchase access).
    - `expires_at` string, date-time: Absent for persistent access.
    - `created_at` string, date-time, required
    - `revoked_at` string, date-time: Present once the access was ended.
    - `spend_this_period_cents` integer, required: Spent against the cap this month.
    - `period` string, required: The month `spend_this_period_cents` counts, `YYYY-MM` (UTC).

## Other responses

- `401`: Error envelope: {code, title, details}.
- `403`: Error envelope: {code, title, details}.
- `503`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)