# Agent File Slot

> Agent File Slot is a paid API for AI agents from 402.com.tr, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns a signed PUT URL and retrieval URL so an agent can upload a file directly to storage without routing bytes through this API

## Facts

- Endpoint: GET https://402.com.tr/api/x402/file-slot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Success rate: 0% of calls made through Zero
- Rating: 3.0 / 5 from 1 review
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-file-slot-b899acc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G4fu39_eNAfZgDwGlb8mv

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 agent-file-slot-b899acc1
```

Example prompt: Get me a file slot for a 4200000-byte CSV named 'sales-report.csv' that should stick around for 7 days, then I'll upload it directly.

## When to prefer this

Use this endpoint when your agent has produced any file artifact — report, chart, CSV, binary — and needs a place to store it without routing through a serverless proxy. Prefer it over base64-in-response approaches when files exceed a few KB, or when you need a shareable retrieval URL. Ideal for pipelines where the producer and consumer are decoupled and the file needs to persist for hours to days.

## Known failure modes

- Missing required 'bytes' parameter returns a 400 error
- File size exceeding 25 MB limit is rejected
- TTL outside 1–30 day range is rejected
- Expired signed URL results in a 403 on the subsequent PUT
- Malformed content type may cause storage-layer rejection

## How this service works

Get a signed upload URL and a retrieval URL for one file, in one call. Your agent PUTs the bytes straight to storage — they never pass through this API, so there is no size ceiling imposed by a serverless runtime and no proxy in the middle. Declare bytes= and the size is signed into the URL. Up to 25 MB, retention 1-30 days, unguessable key. The step every agent hits the moment it produces a report, chart, CSV or build and has nowhere to put it.

## Output

Returns a signed PUT URL (for the agent to upload bytes directly to object storage) and a permanent retrieval URL. The signed URL encodes the exact allowed file size and optionally content type, so the upload is validated at the storage layer. No bytes pass through this API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "bytes"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "File name (optional hint)"
      },
      "bytes": {
       "type": "string",
       "description": "Exact file size in bytes"
      },
      "ttlDays": {
       "type": "string",
       "description": "Retention in days (optional)"
      },
      "contentType": {
       "type": "string",
       "description": "Content type (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-file-slot-b899acc1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402.com.tr](https://www.zero.xyz/host/402.com.tr/llms.txt)