Zum Inhalt
HALOWERK

Agentenwerk

file vault

Takes a base64 file up to 25 MB and stores it for as long as you say, at most seven days. You get a download URL carrying a 32-byte token; whoever holds the link can fetch the file once or up to a limit you set, with no payment and no account. Price is 0.004 USDC per started megabyte, quoted before payment from the size you declare. Actions: store, status, delete.

POST https://agent.halowerk.com/v1/file-vault

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
actionstringJaWhat to do.
content_base64stringNeinFile content, base64 encoded. Required for store.
filenamestringNeinName suggested to the downloader.
content_typestringNeinMIME type served on download.
ttl_secondsintegerNeinLifetime, at most seven days.
max_downloadsintegerNeinDelete after this many downloads. Unlimited within the lifetime if omitted.
size_bytesintegerNeinDeclared size, used to quote the price before payment. Must match the real size.
file_idstringNeinRequired for status and delete.
tokenstringNeinThe token returned by store. Required for status and delete.
notestringNeinFree label carried through.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "action"
  ],
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "store",
        "status",
        "delete"
      ],
      "description": "What to do."
    },
    "content_base64": {
      "type": "string",
      "description": "File content, base64 encoded. Required for store."
    },
    "filename": {
      "type": "string",
      "maxLength": 255,
      "description": "Name suggested to the downloader."
    },
    "content_type": {
      "type": "string",
      "maxLength": 128,
      "default": "application/octet-stream",
      "description": "MIME type served on download."
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 604800,
      "default": 3600,
      "description": "Lifetime, at most seven days."
    },
    "max_downloads": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "description": "Delete after this many downloads. Unlimited within the lifetime if omitted."
    },
    "size_bytes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 26214400,
      "description": "Declared size, used to quote the price before payment. Must match the real size."
    },
    "file_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "description": "Required for status and delete."
    },
    "token": {
      "type": "string",
      "minLength": 16,
      "maxLength": 128,
      "description": "The token returned by store. Required for status and delete."
    },
    "note": {
      "type": "string",
      "maxLength": 200,
      "description": "Free label carried through."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "action": "store",
  "content_base64": "SGVsbG8sIEhBTE9XRVJLIQo=",
  "filename": "hello.txt",
  "content_type": "text/plain",
  "ttl_seconds": 60,
  "size_bytes": 17
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://agent.halowerk.com/v1/file-vault/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →