---
title: "Builder search"
method: GET
path: "/api/builder/search"
tags: ["v2", "store", "private"]
---

# Builder search

`GET /api/builder/search`

Search for blocks (including integrations), marketplace agents, and user library agents.

## Query parameters

- `search_query` string, nullable
- `filter` string, nullable
- `search_id` string, nullable
- `by_creator` string[], nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- SearchResponse
  - `items` union[], required
    - union
      - BlockInfo
        - `id` string, required
        - `name` string, required
        - `inputSchema` object, required
        - `outputSchema` object, required
        - `costs` BlockCost[], required
          - `cost_amount` integer, required
          - `cost_filter` object, required
          - `cost_type` 'run' | 'byte' | 'second' | 'items' | 'cost_usd' | 'tokens', required
          - `cost_divisor` integer
          - `token_rate` TokenRateDisplay — Public per-1M-token USD rates surfaced to the builder UI. Populated only on LLM block costs whose model has a TOKEN_COST rate. cache_* fields are set only when the provider publishes a distinct cached-token rate (Anthropic). Display-only — billing always uses the internal credit math in `BlockCost.cost_amount`.
            - `input_usd_per_1m` number, required
            - `output_usd_per_1m` number, required
            - `cache_read_usd_per_1m` number, nullable
            - `cache_creation_usd_per_1m` number, nullable
        - `description` string, required
        - `categories` object[], required
        - `contributors` object[], required
        - `staticOutput` boolean, required
        - `uiType` string, required
      - LibraryAgent — Represents an agent in the library, including metadata for display and user interaction within the system.
        - `id` string, required
        - `graph_id` string, required
        - `graph_version` integer, required
        - `image_url` string, nullable, required
        - `creator_name` string, required
        - `creator_image_url` string, required
        - `status` 'COMPLETED' | 'HEALTHY' | 'WAITING' | 'ERROR', required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `last_run_at` string, date-time, nullable
        - `name` string, required
        - `description` string, required
        - `instructions` string, nullable
        - `input_schema` object, required
        - `output_schema` object, required
        - `credentials_input_schema` object, nullable, required — Input schema for credentials required by the agent
        - `has_external_trigger` boolean, required — Whether the agent has an external trigger (e.g. webhook) node
        - `has_human_in_the_loop` boolean, required — Whether the agent has human-in-the-loop blocks
        - `has_sensitive_action` boolean, required — Whether the agent has sensitive action blocks
        - `trigger_setup_info` GraphTriggerInfo
          - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
          - `config_schema` object, required — Input schema for the trigger block
          - `credentials_input_name` string, nullable, required
        - `new_output` boolean, required
        - `execution_count` integer
        - `success_rate` number, nullable
        - `avg_correctness_score` number, nullable
        - `recent_executions` RecentExecution[] — List of recent executions with status, score, and summary
          - `status` string, required
          - `correctness_score` number, nullable
          - `activity_summary` string, nullable
        - `can_access_graph` boolean, required — Indicates whether the same user owns the corresponding graph
        - `is_latest_version` boolean, required
        - `is_favorite` boolean, required
        - `folder_id` string, nullable
        - `folder_name` string, nullable
        - `is_hidden` boolean
        - `recommended_schedule_cron` string, nullable
        - `is_scheduled` boolean — Whether this agent has active execution schedules
        - `next_scheduled_run` string, nullable — ISO 8601 timestamp of the next scheduled run, if any
        - `settings` GraphSettings
          - `human_in_the_loop_safe_mode` boolean
          - `sensitive_action_safe_mode` boolean
          - `builder_chat_session_id` string, nullable
        - `marketplace_listing` MarketplaceListing — Marketplace listing information for a library agent.
          - `id` string, required
          - `name` string, required
          - `slug` string, required
          - `creator` MarketplaceListingCreator, required — Creator information for a marketplace listing.
            - `name` string, required
            - `id` string, required
            - `slug` string, required
      - StoreAgent
        - `slug` string, required
        - `agent_name` string, required
        - `agent_image` string, required
        - `creator` string, required
        - `creator_avatar` string, required
        - `sub_heading` string, required
        - `description` string, required
        - `runs` integer, required
        - `rating` number, required
        - `agent_graph_id` string, required
  - `search_id` string, required
  - `total_items` object, required
  - `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

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)