Add-ons

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/qrcode/invoke \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "text": "https://example.com", "size": 256 } }'
# => 200 { "job": { "_id": "...", "status": "completed", "result": { "mode": "file", "url": "https://..." } } }
# or  => 202 { "job": { "_id": "...", "status": "queued" } } — poll the job below until it settles

const res = await fetch(
  `https://cloud.mudbase.dev/api/projects/${projectId}/addons/qrcode/invoke`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MUDBASE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ input: { text: "https://example.com", size: 256 } }),
  },
);
let { job } = await res.json();

// Every invocation returns a job — poll until it settles if it wasn't already "completed".
while (job.status !== "completed" && job.status !== "failed") {
  await new Promise((r) => setTimeout(r, 500));
  const poll = await fetch(
    `https://cloud.mudbase.dev/api/projects/${projectId}/addons/jobs/${job._id}`,
    { headers: { Authorization: `Bearer ${process.env.MUDBASE_API_KEY}` } },
  );
  job = (await poll.json()).job;
}

// File add-ons (qrcode, pdf, csv, ics, vcard) resolve to job.result.url (or .inline, base64,
// for small results). Data add-ons (geoip, currency-convert, crypto-price, and the pure-compute
// ones below) resolve to job.result.data.
if (job.status === "completed") console.log(job.result.url ?? job.result.data);

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/qrcode/invoke \
  -H "Authorization: Bearer ak_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "text": "https://example.com", "size": 256 } }'
# => 200 { "job": { "_id": "...", "status": "completed", "result": { "mode": "file", "url": "https://..." } } }
# or  => 202 { "job": { "_id": "...", "status": "queued" } } — poll the job below until it settles

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/pdf/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "title": "Invoice #1024", "content": [
        { "text": "Receipt", "heading": true }, "Thanks for your purchase." ] } }'

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/csv/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "headers": ["name","email"], "rows": [["Ada","ada@ex.com"]] } }'

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/ics/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "title": "Launch", "start": "2026-07-01T10:00:00Z", "end": "2026-07-01T11:00:00Z" } }'

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/vcard/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "name": "Ada Lovelace", "email": "ada@ex.com", "phone": "+15551234" } }'

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/geoip/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "ip": "8.8.8.8" } }'
# => job.result.data: { "ip": "8.8.8.8", "found": true, "country": "US", "city": "...", "ll": [37.4,-122.0] }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/currency-convert/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "from": "USD", "to": "EUR", "amount": 100 } }'
# => job.result.data: { "from": "USD", "to": "EUR", "amount": 100, "rate": 0.92, "result": 92 }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/crypto-price/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "ids": ["bitcoin","ethereum"], "vs": "usd" } }'
# => job.result.data: { "bitcoin": { "usd": 65000 }, "ethereum": { "usd": 3200 } }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/uuid/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "count": 5, "uppercase": false } }'
# => job.result.data: { "version": 4, "count": 5, "uuids": ["...", "...", ...] }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/hash/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "text": "hello", "algo": "sha256" } }'
# => job.result.data: { "algo": "sha256", "encoding": "hex", "hmac": false,
#      "digest": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824" }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/slugify/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "text": "Hello, World! This is MUDBASE." } }'
# => job.result.data: { "input": "Hello, World! This is MUDBASE.", "slug": "hello-world-this-is-mudbase" }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/password/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "length": 20, "symbols": true } }'
# => job.result.data: { "length": 20, "password": "...", "classes": 4 }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/markdown/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "text": "# Hello\n\nThis is **bold** and *italic* text with a [link](https://mudbase.dev)." } }'
# => job.result.data: { "html": "<h1>Hello</h1>\n<p>This is <strong>bold</strong> and <em>italic</em> text with a <a href=\"https://mudbase.dev\">link</a>.</p>" }

curl -X POST https://cloud.mudbase.dev/api/projects/<PROJECT_ID>/addons/qrcode-svg/invoke \
  -H "Authorization: Bearer ak_your_api_key" -H "Content-Type: application/json" \
  -d '{ "input": { "text": "https://mudbase.dev", "margin": 2, "ecc": "M" } }'
# => job.result.data: { "mimeType": "image/svg+xml", "svg": "<svg ...>...</svg>" }