find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/advisorppc-com:advisorppc-com-agent-builder-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AdvisorPPC Agent Builder API
  version: 0.1.0
tags:
- name: agent-builder
paths:
  /api/agents/builder/chat:
    post:
      tags:
      - agent-builder
      summary: Builder Chat
      operationId: builder_chat_api_agents_builder_chat_post
      security:
      - HTTPBearer: []
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BuilderChatIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/builder/sessions/{sid}:
    get:
      tags:
      - agent-builder
      summary: Get Builder Session
      operationId: get_builder_session_api_agents_builder_sessions__sid__get
      security:
      - HTTPBearer: []
      parameters:
      - name: sid
        in: path
        required: true
        schema:
          type: integer
          title: Sid
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Builder Session Api Agents Builder Sessions  Sid  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/builder/tools:
    get:
      tags:
      - agent-builder
      summary: Builder Tools
      operationId: builder_tools_api_agents_builder_tools_get
      security:
      - HTTPBearer: []
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Builder Tools Api Agents Builder Tools Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/custom:
    post:
      tags:
      - agent-builder
      summary: Create Custom Agent
      description: Create a tenant-scoped custom AgentDefinition from a validated draft.
      operationId: create_custom_agent_api_agents_custom_post
      security:
      - HTTPBearer: []
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveCustomIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentCardOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/custom/{key}:
    delete:
      tags:
      - agent-builder
      summary: Delete Custom Agent
      description: 'Delete one of this workspace''s custom agents.


        It leaves the catalog, its manager is paused so the scheduler never runs

        it again, and it frees a place under the custom-agent limit. The row is

        archived rather than removed, so its past runs, recommendations and audit

        trail stay readable. Built-in managers cannot be deleted (404).'
      operationId: delete_custom_agent_api_agents_custom__key__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          title: Key
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: X-Tenant-Id
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AgentCardOut:
      properties:
        key:
          type: string
          title: Key
        name:
          type: string
          title: Name
        platform:
          type: string
          title: Platform
        description:
          type: string
          title: Description
        placement_lock:
          additionalProperties: true
          type: object
          title: Placement Lock
        read_tools:
          items:
            type: string
          type: array
          title: Read Tools
        write_tools:
          items:
            type: string
          type: array
          title: Write Tools
        writes_enabled:
          type: boolean
          title: Writes Enabled
        version:
          type: integer
          title: Version
        enabled:
          type: boolean
          title: Enabled
        instance:
          anyOf:
          - $ref: '#/components/schemas/AgentInstanceOut'
          - type: 'null'
        last_run:
          anyOf:
          - $ref: '#/components/schemas/RunSummaryOut'
          - type: 'null'
        pending_questions:
          type: integer
          title: Pending Questions
        is_custom:
          type: boolean
          title: Is Custom
          default: false
        status:
          type: string
          title: Status
          default: active
        how_it_works:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: How It Works
        recommended_for:
          items:
            type: string
          type: array
          title: Recommended For
      type: object
      required:
      - key
      - name
      - platform
      - description
      - placement_lock
      - read_tools
      - write_tools
      - writes_enabled
      - version
      - enabled
      - instance
      - last_run
      - pending_questions
      title: AgentCardOut
      description: 'One agent card = the global definition merged with this tenant''s

        instance state (enabled?, last run, pending-question count).'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AgentDraft:
      properties:
        name:
          type: string
          maxLength: 200
          minLength: 1
          title: Name
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        goal:
          type: string
          maxLength: 1000
          title: Goal
          default: ''
        system_prompt:
          type: string
          maxLength: 20000
          minLength: 1
          title: System Prompt
        tools:
          items:
            type: string
          type: array
          maxItems: 64
          title: Tools
        model:
          type: string
          maxLength: 80
          title: Model
          default: ''
        effort:
          type: string
          maxLength: 20
          title: Effort
          default: ''
      type: object
      required:
      - name
      - system_prompt
      title: AgentDraft
      description: 'The builder''s structured output: a complete, validatable definition.'
    SaveCustomIn:
      properties:
        builder_session_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Builder Session Id
        draft:
          anyOf:
          - $ref: '#/components/schemas/AgentDraft'
          - type: 'null'
      type: object
      title: SaveCustomIn
    AgentInstanceOut:
      properties:
        id:
          type: integer
          title: Id
        display_name:
          type: string
          title: Display Name
        status:
          type: string
          title: Status
        health:
          type: string
          title: Health
          default: healthy
        last_health_detail:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Health Detail
        accounts:
          additionalProperties:
            type: string
          type: object
          title: Accounts
        anomaly_hold:
          type: boolean
          title: Anomaly Hold
          default: false
        automation:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Automation
        next_run_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Next Run At
        stopped:
          type: boolean
          title: Stopped
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - display_name
      - status
      - created_at
      title: AgentInstanceOut
      description: 'This tenant''s enabled instance of a definition (present only once the

        tenant has hit /enable).'
    BuilderChatIn:
      properties:
        message:
          type: string
          maxLength: 4000
          minLength: 1
          title: Message
        builder_session_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Builder Session Id
      type: object
      required:
      - message
      title: BuilderChatIn
    RunSummaryOut:
      properties:
        id:
          type: integer
          title: Id
        status:
          type: string
          title: Status
        summary:
          anyOf:
          - type: string
          - type: 'null'
          title: Summary
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
      - id
      - status
      - summary
      - created_at
      title: RunSummaryOut
      description: 'Compact last-run line shown on an agent card (full detail lives in

        RunOut on the task tab).'
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer