---
title: "List the orgs your personal credentials are granted to (ADR 0068), optionally for one credential."
method: GET
path: "/v1/personal-credential-grants"
tags: ["secrets"]
---

# List the orgs your personal credentials are granted to (ADR 0068), optionally for one credential.

`GET /v1/personal-credential-grants`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/personal-credential-grants`
- Auth: HTTP bearer

List the orgs your personal credentials are granted to (ADR 0068), optionally for one credential. `active` is false when a grant does not work right now: the credential's value expired, its OAuth connection is disconnected, its MCP server is disabled, or you no longer belong to the org. Lists only your own grants, never anyone else's. Never returns values.

Org permission: none (touches no org data).

## Query parameters

- `credential_id` string: Credential id of a secret, OAuth connection, or MCP server in your personal org (secretList or credentialList there).

## Response `200`

Success.

- object
  - `grants` object[], required
    - `credential_id` string, required
    - `credential_kind` 'secret' | 'integration' | 'mcp-server', required
    - `name` string, required
    - `org` object, required
      - `id` string, required
      - `slug` string, required
      - `display_name` string, nullable, required
    - `created_at` string, required
    - `active` boolean, required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

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