Skip to main content
POST
Extract Agents from File
Use this API to extract agent definitions from an uploaded file. An LLM parses the file and returns a list of draft agent definitions: a name, a description, and a consolidated QA prompt for each. Map prompt onto the instructions field of Create Agent and supply the remaining config blocks yourself. Extraction does not produce contextGathering or execution config; use Resolve Config to derive those from the extracted prompt. Useful for migrating an existing QA checklist (CSV / Excel / PDF / plain text) into agents in bulk.

Endpoint

POST https://api.velt.dev/v2/agents/extract

Headers

string
required
Your API key.
string
required

Body

Params

object
required

Example Requests

1. Extract from a CSV checklist

2. Extract from a PDF checklist

Response

Success Response

Extracted agent fields (agents[]):
Extraction returns at most 50 agents per file. Anything beyond that is dropped from agents[], and totalTasksParsed still reflects the full count found in the file.

Failure Response

Errors:
  • INVALID_ARGUMENT: missing, empty, or whitespace-only fileBase64; missing or empty mimeType; an unsupported MIME type; or a file whose decoded size exceeds 5 MB.
  • INTERNAL: the ingest pipeline failed to process the file, or it produced no readable content.
  • DEADLINE_EXCEEDED: the ingest pipeline did not finish within the processing budget.
  • UNAVAILABLE: the ingest queue is temporarily unavailable. Retry the request.