---
title: "List presets"
method: GET
path: "/api/library/presets"
tags: ["v2", "presets"]
---

# List presets

`GET /api/library/presets`

Retrieve a paginated list of presets for the current user.

## Query parameters

- `page` integer
- `page_size` integer
- `graph_id` string, nullable, required — Allows to filter presets by a specific agent graph

## Response `200`

Successful Response

- LibraryAgentPresetResponse — Response schema for a list of agent presets and pagination info.
  - `presets` LibraryAgentPreset[], required
    - `graph_id` string, required
    - `graph_version` integer, required
    - `inputs` object, required
    - `credentials` object, required
    - `name` string, required
    - `description` string, required
    - `is_active` boolean
    - `id` string, required
    - `user_id` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `organization_id` string, nullable
    - `team_id` string, nullable
    - `webhook_id` string, nullable
    - `webhook` Webhook, required
      - `id` string
      - `user_id` string, required
      - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
      - `credentials_id` string, required
      - `webhook_type` string, required
      - `resource` string, required
      - `events` string[], required
      - `config` object
      - `secret` string, required
      - `organization_id` string, nullable
      - `team_id` string, nullable
      - `provider_webhook_id` string, required
      - `url` string, required
    - `expert_id` string, nullable
  - `pagination` Pagination, required
    - `total_items` integer, required — Total number of items.
    - `total_pages` integer, required — Total number of pages.
    - `current_page` integer, required — Current_page page number.
    - `page_size` integer, required — Number of items per page.

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-08-20** `ae1be5efc67a` — 1 warning
  - added the new `device_code` enum value to the `presets/items/credentials/additionalProperties/type` response property for the response status `200`
- **2026-08-06** `3dfd3128358f` — 1 info
  - added the optional property `presets/items/expert_id` to the response with the `200` status
- **2026-07-09** `183f82172fec` — 4 info
  - added the optional property `presets/items/organization_id` to the response with the `200` status
  - added the optional property `presets/items/team_id` to the response with the `200` status
  - added the optional property `presets/items/webhook/anyOf[subschema #1: Webhook]/organization_id` to the response with the `200` status
  - added the optional property `presets/items/webhook/anyOf[subschema #1: Webhook]/team_id` to the response with the `200` status
- **2026-04-30** `8c84efcb3afb` — 4 warning
  - removed the optional property `presets/items/organization_id` from the response with the `200` status
  - removed the optional property `presets/items/team_id` from the response with the `200` status
  - removed the optional property `presets/items/webhook/anyOf[subschema #1: Webhook]/organization_id` from the response with the `200` status
  - removed the optional property `presets/items/webhook/anyOf[subschema #1: Webhook]/team_id` from the response with the `200` status

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/library/presets/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)