---
title: "Deprecated: use GET /plugins/app:{app}/share?connection_id={id}. List who may call through one of the caller's connections with a key [read]"
method: GET
path: "/connectors/connections/{id}/grants"
tags: ["connectors"]
deprecated: true
---

# Deprecated: use GET /plugins/app:{app}/share?connection_id={id}. List who may call through one of the caller's connections with a key \[read\]

`GET /connectors/connections/{id}/grants`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/connectors/connections/{id}/grants`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated: use `GET /plugins/app:{app}/share?connection_id={id}`. Still served exactly as before; every answer carries a `Deprecation` header. Every grant on the connection, workspace by workspace, with the calls made under each. 404 for a connection that is not the caller's.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `grants` ConnectionGrant[], required
    - `id` string, required
    - `connection_id` string, required
    - `workspace` object, required
      - `slug` string, required
      - `name` string, required
    - `key` object, nullable, required: The one key the grant is for; null when every key of the workspace may use it.
      - `id` string, required
      - `name` string, required
    - `created_at` string, date-time, required
    - `use_count` integer, required: Calls made under this grant so far.
    - `uses` object[], required: The newest calls, at most 20.
      - `key_id` string, required
      - `method` string, required
      - `host` string, required
      - `status` integer, required
      - `at` string, date-time, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/connectors/connections/:id/grants/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)