Skip to main content
POST
Extract Agents from File
Use this API to extract agent definitions from an uploaded file. The file is parsed by an LLM and the response returns a list of structured agent configurations that can be passed straight into Create Agent. 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

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

1. Extract from a CSV checklist

2. Extract from a PDF checklist

Response

Success Response

FieldTypeDescription
data.extractionResult.agentsobject[]Array of extracted agent configurations ready for Create Agent.
data.extractionResult.summarystringHuman-readable summary of the extraction.
data.extractionResult.skippedobject[]Rows the engine could not turn into agents (with the reason for each).

Failure Response

Errors: INVALID_ARGUMENT (missing or empty fileBase64 / mimeType, or unsupported MIME type).