# Vaaya File Upload

> Vaaya File Upload is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Uploads files to the Vaaya platform for use in agent-powered workflows such as demos, outreach, and content generation.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/files/upload
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-file-upload-7ca129bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H6S_vgtBRw8pnpfGez1Sp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vaaya-file-upload-7ca129bc -d '<json body>'
```

Example prompt: Upload this file to Vaaya so I can use it in my agent workflow — here's the document I want to store.

## When to prefer this

Choose this endpoint when you need to stage a file (document, image, spreadsheet, etc.) into the Vaaya platform before using it in downstream agent workflows such as demo building, outreach automation, contact enrichment, or graphic generation. This is the entry point for file-based assets in the Vaaya ecosystem.

## Known failure modes

- File too large — returns error if the file exceeds platform size limits
- Unsupported file type — returns error if the MIME type is not accepted
- Authentication or payment failure — x402 payment not completed, call rejected
- Malformed request — missing file content or required multipart fields returns 400 error
- Network timeout — large file uploads may time out

## How this service works

Store a file from the local machine in your persistent Vaaya file library. Returns put_url (PUT the raw bytes there with curl) plus file_id and get_url. Files persist across tasks — check files/list before re-uploading. Max 100MB per file.

## Output

Returns a confirmation of the upload along with a file reference (such as a URL or ID) that can be used by subsequent Vaaya agent workflow steps to access or process the uploaded file.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "filename": {
       "type": "string",
       "minLength": 1,
       "maxLength": 200
      },
      "size_bytes": {
       "type": "integer",
       "exclusiveMinimum": 0,
       "maximum": 104857600
      },
      "mime": {
       "type": "string",
       "maxLength": 100
      },
      "tags": {
       "type": "array",
       "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
       },
       "maxItems": 10
      },
      "note": {
       "type": "string",
       "maxLength": 500
      }
     },
     "required": [
      "filename",
      "size_bytes"
     ],
     "additionalProperties": false,
     "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-file-upload-7ca129bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)