Docs

Files

Upload files, attach them to runs, and transcribe audio.

AxAgent has a files library. Upload files once and attach them to any run. The agent can read them and use them in its work.

Coming Q4 2026

AxAgent launches in Q4 2026. The API below may change before launch.

Enable files

const agent = await axerity.agents.create({
  model: 'anthropic/claude-sonnet-5.5',
  modules: { files: true },
})

Upload a file

Use the Files API to upload a file. The returned ID starts with file_.

files.ts
import fs from 'node:fs'

const file = await axerity.files.upload({
  file: fs.createReadStream('contract.pdf'),
})

Attach files to a run

Pass file IDs in files.

const run = await axerity.runs.create({
  agent: agent.id,
  input: 'List the key dates in this contract',
  files: [file.id],
})

To get typed data back from a file, combine this with structured output.

Transcription

Turn audio into text with axerity.transcriptions.create().

transcribe.ts
import fs from 'node:fs'

const transcript = await axerity.transcriptions.create({
  file: fs.createReadStream('support-call.mp3'),
})

console.log(transcript.text)

You can save the transcript to memory so the agent remembers it later.

On this page