---
title: "List Declared Configurations"
method: GET
path: "/api/v1/playbooks/declared-configurations"
tags: ["playbooks"]
---

# List Declared Configurations

`GET /api/v1/playbooks/declared-configurations`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/playbooks/declared-configurations`
- Auth: none declared

Return an editor-only, allowlisted declaration history for Evidence.

The full Playbook serializer contains prompts, examples, tools, and notes.
Reusing it for the Blueprint-adjacent card would make a frontend omission
the only disclosure control, so this endpoint constructs the narrow
projection server-side after resolving current personal/workspace edit
authority.

## Query parameters

- `agent_id` string, uuid, required
- `limit` integer

## Response `200`

Successful Response

- DeclaredConfigurationCollection
  - `items` DeclaredConfigurationRead[], required
    - `version` integer, required
    - `is_active` boolean, required
    - `is_default` boolean, required
    - `playbook_type` string, required
    - `model` string, required
    - `temperature` number, required
    - `max_tokens` integer, required
    - `top_p` number, required
    - `last_updated_at` string, date-time, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)