# MiniUp File Create or Replace

> MiniUp File Create or Replace is a paid API for AI agents from www.miniup.io, paid per call via x402, $0.003000/call, status unknown (last checked 2026-09-15).

Creates or replaces a file in a MiniUp app owned by the paying wallet, enabling app asset management via x402 micropayment.

## Facts

- Endpoint: GET https://www.miniup.io/api/x402/apps/:siteId/files
- Price: $0.003000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-miniup-io-121e33cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uxqTA7WBjcgu94P_gkfCN

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 www-miniup-io-121e33cf
```

Example prompt: Add a new file called 'config.json' to my MiniUp app with site ID abc123, replacing any existing version, with the content '{"theme": "dark"}'.

## When to prefer this

Use this endpoint when you need to programmatically create or overwrite a specific file within an existing MiniUp app, particularly when the app is already set up and you need to update individual file assets. Prefer this over presigned upload URLs when dealing with smaller files that can be sent inline rather than requiring a separate multipart upload flow.

## Known failure modes

- Invalid or non-existent siteId returns 404 not found
- Wallet not authorized as app owner returns 403 forbidden
- Malformed file content or missing required fields returns 400 bad request
- Insufficient USDC balance for the $0.003 micropayment returns payment failure
- File path conflicts with reserved system paths may return 409 conflict

## How this service works

Create or replace a file in an app owned by the paying wallet.

## Output

Returns confirmation that the file was created or replaced in the specified MiniUp app, including metadata about the stored file such as its path and status within the app.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "siteId"
     ],
     "properties": {
      "paths": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "maxItems": 100
      },
      "siteId": {
       "type": "string",
       "maxLength": 128,
       "minLength": 1
      }
     },
     "additionalProperties": false
    }
   },
   "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/www-miniup-io-121e33cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.miniup.io](https://www.zero.xyz/host/www.miniup.io/llms.txt)