REST API

Programmatic access to blob for CI/CD pipelines, scripts, and external tools.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer <your_api_key>

Getting an API Key

1. Sign up at imblob.com and subscribe to any plan
2. Go to Settings → API Keys
3. Create a key and copy it — it starts with blob_live_

Key format: blob_live_<prefix>_<secret>

Error Responses

All errors return JSON with an error field:

{ "error": "App not found" }

Create App

Request Body

Example

curl -X POST "https://app.imblob.com/v1/apps" \
  -H "Authorization: Bearer $BLOB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "template": "static-site",
    "runtime": "worker"
  }'

Response

{
  "appId": "app_abc123",
  "name": "my-app",
  "url": "https://my-app.imblob.app",
  "backupUrl": "https://my-app.imblob.dev",
  "resources": {
    "database": "provisioned",
    "storage": "provisioned",
    "kv": "provisioned"
  },
  "status": "live"
}

Get App

Example

curl "https://app.imblob.com/v1/apps/my-app" \
  -H "Authorization: Bearer $BLOB_API_KEY"

Response

{
  "name": "my-app",
  "url": "https://my-app.imblob.app",
  "backupUrl": "https://my-app.imblob.dev",
  "runtime": "worker",
  "status": "live",
  "template": "static-site",
  "lastDeployed": "2026-04-07T09:00:00.000Z",
  "deployCount": 5,
  "createdAt": "2026-04-01T12:00:00.000Z",
  "customDomains": [],
  "resources": {
    "database": true,
    "kv": true,
    "storage": true,
    "externalDatabase": false
  },
  "tasks": { "open": 0, "done": 0 },
  "lastDeploy": {
    "version": 5,
    "description": "Fix layout bug",
    "deployedAt": "2026-04-07T09:00:00.000Z"
  }
}

Deploy Files

Request Body

Example

curl -X POST "https://app.imblob.com/v1/apps/my-app/deploys" \
  -H "Authorization: Bearer $BLOB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      { "path": "index.html", "content": "<html><body>Hello</body></html>" }
    ],
    "description": "Update homepage"
  }'

Response

{
  "success": true,
  "url": "https://my-app.imblob.app",
  "backupUrl": "https://my-app.imblob.dev",
  "status": "live",
  "version": 6,
  "filesUploaded": 1,
  "deployedAt": "2026-04-07T09:00:00.000Z",
  "healthCheck": "staging + production passed"
}

Update Environment Variables

Request Body

{
  "variables": [
    { "key": "API_KEY", "value": "secret123" },
    { "key": "DEBUG", "value": "false" }
  ]
}

To unset a variable, set its value to an empty string "".

Response

{
  "updated": ["API_KEY", "DEBUG"],
  "note": "App will use new values on next request (no redeploy needed)."
}

Get Logs

Query Parameters

Example

curl "https://app.imblob.com/v1/apps/my-app/logs?lines=20" \
  -H "Authorization: Bearer $BLOB_API_KEY"

Response

{
  "app": "my-app",
  "lines": 3,
  "logs": [
    { "timestamp": "2026-04-07T09:00:00.000Z", "level": "error", "message": "Unhandled error" }
  ]
}

List Rollback Versions

Example

curl "https://app.imblob.com/v1/apps/my-app/rollback" \
  -H "Authorization: Bearer $BLOB_API_KEY"

Response

{
  "app": "my-app",
  "currentVersion": 5,
  "versions": [
    { "version": 5, "deployedAt": "2026-04-07T09:00:00.000Z", "fileCount": 3, "size": "12.4KB" },
    { "version": 4, "deployedAt": "2026-04-06T14:00:00.000Z", "fileCount": 3, "size": "11.8KB" }
  ]
}

Rollback

Request Body

{ "version": 3 }

Response

{
  "app": "my-app",
  "url": "https://my-app.imblob.app",
  "status": "rolled_back",
  "rolledBackFrom": 5,
  "newVersion": 6,
  "deployedAt": "2026-04-07T09:00:00.000Z"
}

Rate Limits

On rate limit exceeded, the response includes a Retry-After header:

{
  "error": "Rate limit exceeded. Try again later.",
  "retryAfter": 45
}

API Key Scopes

When creating an API key, choose which operations it can perform:

MCP vs REST

Install MCP in Claude Code:

claude mcp add --transport http blob https://app.imblob.com/mcp

GitHub Actions Example

- name: Deploy to blob
  run: |
    curl -X POST "https://app.imblob.com/v1/apps/${ env.BLOB_APP }/deploys" \
      -H "Authorization: Bearer ${ secrets.BLOB_API_KEY }" \
      -H "Content-Type: application/json" \
      -d '{
        "files": [
          {"path": "dist/index.html", "content": "${ steps.build.outputs.html }"},
          {"path": "dist/bundle.js", "content": "${ steps.build.outputs.js }"}
        ],
        "description": "Deploy from GitHub Actions"
      }'

Set BLOB_APP and BLOB_API_KEY in your repository secrets.