# Koinelix File Upload

> Koinelix File Upload is a paid API for AI agents from api.koinelix.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-11).

Uploads a file (1 byte to 10 MiB) and returns a signed download URL valid for 10 days, paid per-file via x402 with no API key required.

## Facts

- Endpoint: POST https://api.koinelix.com/v1/files?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/koinelix-file-upload-0dc8931f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-sAiObJQ_aNBRgtSkJbtW

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 koinelix-file-upload-0dc8931f -d '<json body>'
```

Example prompt: Upload this PDF report I just generated and give me a download link I can share with my client — it's about 2 MB.

## When to prefer this

Use this endpoint when an agent has a file in memory and needs to make it accessible as a URL — for sharing with a human, passing to another agent, or handing to a tool that only accepts URLs. Ideal for files up to 10 MiB that need a temporary 10-day link. No account or API key setup is required; payment is per-file via x402, making it frictionless for autonomous agents.

## Known failure modes

- File exceeds 10 MiB limit — request rejected with an error indicating size exceeded
- x402 payment fails or insufficient USDC balance — payment-required error returned
- Malformed multipart/form-data or invalid base64 — 400 bad request
- Base64 payload exceeds 8 MiB JSON limit — request rejected
- Network timeout during upload of large file

## How this service works

File upload that returns a signed download link valid for 10 days. Use when an agent holds a file and needs to hand it to a person, another agent or a tool as a URL: file sharing for 1 byte to 10 MiB. The request is multipart/form-data with one part named file, or JSON with the file as base64 (up to 8 MiB). Price: 0.004 USDC per file, paid with x402; no account or API key is needed.

## Output

A signed HTTPS download URL for the uploaded file, valid for 10 days. The agent receives this URL and can share it with people, other agents, or tools that need to fetch the file by URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "file": {
   "type": "string",
   "description": "The file bytes as one multipart part named file."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "url": "https://koinelix.com/oss/<bucket>/files/file_<32 hex>?AWSAccessKeyId=<id>&Expires=<unix>&Signature=<sig>",
   "sha256": "<64 hex>",
   "file_id": "file_<32 hex>",
   "filename": "report.pdf",
   "expires_at": "2026-11-05T00:00:00Z",
   "size_bytes": 1234,
   "content_type": "application/pdf"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/koinelix-file-upload-0dc8931f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.koinelix.com](https://www.zero.xyz/host/api.koinelix.com/llms.txt)
