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

Failure Response

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