---
title: "List project agent credential metadata (never contents)"
method: GET
path: "/v1/agent-credentials"
tags: ["Agent credentials"]
---

# List project agent credential metadata (never contents)

`GET /v1/agent-credentials`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/agent-credentials`
- Auth: HTTP bearer

## Query parameters

- `project_id` string, uuid
- `check_access` boolean

## Response `200`

Default Response

- object[]
  - `app` union, required
    - 'claude'
    - 'codex'
  - `updated_at` string, date-time, required
  - `fingerprint` string, nullable, required
  - `files` object[], required
    - `path` string, required
  - `scope` 'account'
  - `status` union
    - 'ready'
    - 'needs_sign_in'
  - `expires_at` string, date-time, nullable
  - `access` object: Claude only, with check_access=true: a live check of the account login with Claude.
    - `verdict` union, required: What Claude answered when asked with the account login (check_access=true): usable, refused (sign in to Claude again), or unknown (nothing was learned; ask again).
      - 'usable'
      - 'refused'
      - 'unknown'
    - `checked_at` string, date-time, required

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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