---
updatedAt: 2026-09-04T01:56:54.000Z
agentTools:
  projectIndex: https://developer.tiliter.com/llms.txt
---

# List Available Agents

Returns a list of all available vision AI agents with their capabilities and metadata.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Vision Agent Platform API",
    "description": "Backend API for Vision Agent Platform with multi-provider LLM integration",
    "version": "1.0.0"
  },
  "paths": {
    "/api/v2/agents/": {
      "get": {
        "tags": [
          "Agents"
        ],
        "summary": "List Available Agents",
        "description": "Returns a list of all available vision AI agents with their capabilities and metadata.",
        "operationId": "list_agents_handler_api_v2_agents__get",
        "parameters": [
          {
            "name": "X-API-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "X-API-Key",
              "description": "Your API key for authentication"
            },
            "description": "Your API key for authentication"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/AgentDefinition"
                },
                "title": "Agents"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "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"
      },
      "FileType": {
        "description": "Enumeration of input file types",
        "enum": [
          "Image",
          "PDF"
        ],
        "title": "FileType",
        "type": "string"
      },
      "LLMProvider": {
        "description": "Enumeration of supported LLM models. Each value has a mandatory\nvendor family - see `LLMProvider.family`.",
        "enum": [
          "sam3",
          "gemini-2.0-flash",
          "gemini-2.5-flash",
          "gemini-2.5-flash-lite",
          "gemini-2.5-pro",
          "gemini-2.5-flash-image",
          "gemini-3-flash-preview",
          "gemini-3-pro-preview",
          "gemini-3-pro-image-preview",
          "gemini-3.1-pro-preview",
          "gemini-3.8-flash",
          "gpt-4-turbo-preview",
          "gpt-4o",
          "gpt-4o-mini",
          "gpt-image-1",
          "gpt-image-2",
          "gpt-5",
          "gpt-5-mini",
          "gpt-5-nano",
          "gpt-5.1",
          "gpt-5.1-mini",
          "gpt-5.1-codex",
          "gpt-5.2-pro",
          "gpt-6-luna-decisions",
          "claude-opus-4-7",
          "claude-sonnet-4-6",
          "claude-haiku-4-5"
        ],
        "title": "LLMProvider",
        "type": "string"
      },
      "AgentDefinition": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "Agent identifier",
            "minLength": 5,
            "pattern": "([a-z-]+)-v(\\d+)$",
            "title": "Id",
            "type": "string"
          },
          "nice_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Human-friendly display name shown in UI.",
            "title": "Nice Name"
          },
          "description": {
            "description": "Short description of what the agent does.",
            "title": "Description",
            "type": "string"
          },
          "llm_provider": {
            "$ref": "#/components/schemas/LLMProvider",
            "default": "gemini-3-flash-preview",
            "description": "Default LLM provider used to run this agent."
          },
          "max_output_tokens": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Maximum number of output tokens for the LLM response. If None, uses the default. Set higher for agents that return large outputs like base64 images.",
            "title": "Max Output Tokens"
          },
          "tags": {
            "description": "Free-form tags used for grouping in the UI and catalogue.",
            "items": {
              "type": "string"
            },
            "title": "Tags",
            "type": "array"
          },
          "frozen": {
            "description": "If True, treat the agent's spec as immutable (production-frozen).",
            "title": "Frozen",
            "type": "boolean"
          },
          "hidden_in_prod": {
            "default": false,
            "description": "If True, the endpoint for this agent is not exposed in production environments (defaults to False)",
            "title": "Hidden In Prod",
            "type": "boolean"
          },
          "reference_support": {
            "default": false,
            "description": "Indicates whether the agent accepts optional reference_files (multiple auxiliary images) alongside the primary input",
            "title": "Reference Support",
            "type": "boolean"
          },
          "min_num_reference_files": {
            "anyOf": [
              {
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional lower bound on the number of reference files the agent needs to run. When set (>= 0), the generated request schema constrains reference_files with min_length; if the value is > 0, reference_files becomes a required field. Default None means no lower bound (reference_files can be omitted). Setting this implies reference_support=True. Not surfaced on the agents-list endpoint - frontend derives the bound from the fetched OpenAPI spec.",
            "title": "Min Num Reference Files"
          },
          "max_num_reference_files": {
            "anyOf": [
              {
                "minimum": 1,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Optional upper bound on the number of reference files the agent accepts. When set, the generated request schema constrains reference_files with max_length. Default None means no explicit upper bound (the global MAX_REFERENCE_FILES cap still applies). Setting this implies reference_support=True. Not surfaced on the agents-list endpoint - frontend derives the bound from the fetched OpenAPI spec.",
            "title": "Max Num Reference Files"
          },
          "uses_image_generation": {
            "default": false,
            "description": "If True, this agent requests image generation (LLM should return images along with text).",
            "title": "Uses Image Generation",
            "type": "boolean"
          },
          "validated": {
            "default": false,
            "description": "If True, this agent has been validated by Tiliter internal testing for production use.",
            "title": "Validated",
            "type": "boolean"
          },
          "instruction_prompt_variables_schema": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "description": "Pydantic schema (as a class) for the agent's structured input parameters. None when the agent has no parameters.",
            "title": "Instruction Prompt Variables Schema"
          },
          "instruction_prompt_template": {
            "description": "Jinja-style prompt template rendered with the agent's input parameters before calling the LLM.",
            "title": "Instruction Prompt Template",
            "type": "string"
          },
          "llm_response_schema": {
            "description": "Schema the LLM is asked to return. When `llm_response_post_processing_fn` is None this is also the public API response schema; when set, the fn's return-type annotation determines the public API response schema.",
            "title": "Llm Response Schema"
          },
          "output_prompt_template": {
            "description": "Template fragment appended to the prompt to constrain the LLM's output shape.",
            "title": "Output Prompt Template",
            "type": "string"
          },
          "reports_token_usage": {
            "default": false,
            "description": "If True, the response's `input_tokens` and `output_tokens` are filled from the provider's reported usage. The API response schema must declare both fields.",
            "title": "Reports Token Usage",
            "type": "boolean"
          },
          "supported_file_types": {
            "description": "MIME-family file types the agent accepts as primary input (e.g. images, pdf).",
            "items": {
              "$ref": "#/components/schemas/FileType"
            },
            "title": "Supported File Types",
            "type": "array"
          },
          "report_narrative_fields": {
            "description": "Response fields checked in order to build the narrative shown in the job screen and PDF report. First non-empty value wins.",
            "items": {
              "type": "string"
            },
            "title": "Report Narrative Fields",
            "type": "array"
          },
          "criteria_fields": {
            "description": "Input parameter fields checked in order when a selection step precedes this agent. When set, the selection option description/header is injected into the first matching field at runtime, and frontends lock and pre-fill these fields accordingly.",
            "items": {
              "type": "string"
            },
            "title": "Criteria Fields",
            "type": "array"
          }
        },
        "required": [
          "id",
          "nice_name",
          "description",
          "tags",
          "frozen",
          "instruction_prompt_variables_schema",
          "instruction_prompt_template",
          "llm_response_schema",
          "output_prompt_template",
          "supported_file_types",
          "report_narrative_fields"
        ],
        "title": "AgentDefinition",
        "type": "object"
      }
    }
  },
  "servers": [
    {
      "url": "https://api.ai.vision.tiliter.com",
      "description": "Production API"
    }
  ],
  "tags": [
    {
      "name": "Agents",
      "description": "List and discover available vision AI agents."
    }
  ]
}
```