Discovery — GreenPT Docs

GET

GET https://api.greenpt.ai/v1/agents

Two response modes depending on the request:

No Authorization header, or an Accept: text/markdown header — a markdown document describing the available agents, readable without an API key.
An authenticated request not asking for markdown — a JSON listing of every agent and the input fields it accepts.

curl https://api.greenpt.ai/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "agents": [
    {
      "id": "default",
      "displayName": "Agent",
      "description": "Works a task to completion using web search, page scraping, document and image analysis, and meeting-recording transcription.",
      "tools": ["web_search", "web_crawl", "document_parse", "vision", "audio_transcribe", "save_data", "save_file"],
      "input": {
        "type": "object",
        "properties": {
          "question": { "type": "string", "description": "What you want the agent to do" },
          "documentUrl": { "type": "string", "description": "URL of a document to analyze (PDF, DOCX, etc.)" },
          "audioUrl": { "type": "string", "description": "URL of a meeting recording to transcribe" }
        },
        "required": ["question"]
      }
    }
  ]
}