---
title: "List the agents the caller has given a connected service to"
method: GET
path: "/api/v1/connections/services/{provider}/grants"
tags: ["Credentials"]
---

# List the agents the caller has given a connected service to

`GET /api/v1/connections/services/{provider}/grants`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/connections/services/{provider}/grants`
- Auth: API key in header `api-key`

Active, paused and proposed (waiting for the agent to accept) grants the caller made for this service (an unscoped grant, "all_services": true, is listed under every service). Needs no live connection, so grants stay visible and revocable after a disconnect. A paused grant carries its pause_reason ("key_changed" when the agent's key changed).

## Path parameters

- `provider` string, required

## Response `200`

OK.

- object
  - `grants` ServiceGrant[]
    - `id` string, uuid
    - `status` 'active' | 'paused' | 'proposed': proposed: given to an agent that is not yours and waiting for it to accept (POST /api/v1/mandates/{id}/accept).
    - `pause_reason` string, nullable
    - `provider` string
    - `capability` 'mcp.call' | 'credential.borrow' | 'null', nullable
    - `all_services` boolean: The grant is unscoped: it covers every service, not just this one.
    - `gives_copy` boolean: true for a REST service: the agent receives a copy of the key, which taking access back does not recall. false for an MCP service: Salt makes the call and the token never leaves.
    - `created_at` string, date-time, nullable
    - `team_id` string, nullable: The team this grant was made for (the team maker), or null.
    - `agent` object
      - `id` string, uuid
      - `username` string
      - `display_name` string, nullable

## Other responses

- `401`: Missing or invalid credentials.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)