API Documentation

npx wrify push hello.py
npx wrify push image.png --title "My art"
npx wrify push file.ts --key YOUR_API_KEY

curl -X POST https://wr.fi/api/p \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Hello from my AI tool",
    "contentType": "code",
    "artifacts": [{
      "data": "'$(echo "console.log('hello wrify')" | base64)'",
      "mimeType": "application/javascript",
      "filename": "hello.js"
    }]
  }'

{
  "id": "abc123...",
  "url": "https://wr.fi/bako",
  "shortId": "bako",
  "expiresAt": "2026-04-04T...",
  "artifacts": [{
    "id": "...",
    "contentHash": "sha256-...",
    "mimeType": "application/javascript",
    "filename": "hello.js",
    "sizeBytes": 28,
    "url": "https://wr.fi/api/artifacts/sha256-..."
  }]
}

curl -X POST https://wr.fi/api/creations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "title": "Wrify",
    "contentType": "code",
    "provenance": {
      "tool": "Claude Code",
      "aiContribution": {
        "percent": 85,
        "role": "Full implementation",
        "humanRole": "Architecture, review, direction"
      },
      "sessionCount": 12,
      "promptCount": 340
    },
    "generation": {"model": "claude-opus-4-6"},
    "artifacts": [{
      "url": "https://github.com/owner/repo",
      "mimeType": "application/vnd.wrify.repo-link+json"
    }]
  }'

curl -X POST https://wr.fi/api/creations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "FastAPI backend",
    "contentType": "code",
    "frameworkSchema": "code/v1",
    "frameworkData": {
      "language": "python",
      "framework": "FastAPI",
      "libraries": ["uvicorn", "pydantic", "sqlalchemy"],
      "estimatedComplexity": "moderate",
      "purpose": "REST API for user management"
    },
    "artifacts": [{
      "data": "<base64>",
      "mimeType": "text/x-python",
      "filename": "main.py"
    }]
  }'

{
  "generation": { "model": "stable-diffusion-xl", "steps": 30, "cfgScale": 7.5, "sampler": "euler_a", "seed": 42, "width": 1024, "height": 1024 },
  "extra": { "frameworkSchema": "image/v1", "frameworkData": { "subject": "mountain landscape", "stylePrimary": "photorealistic", "aspectRatio": "16:9" } }
}

{
  "generation": { "model": "claude-opus-4-6", "temperature": 0.7 },
  "extra": { "frameworkSchema": "code/v1", "frameworkData": { "language": "python", "framework": "FastAPI", "purpose": "api" } }
}

{
  "generation": { "model": "elevenlabs-v2", "voice": "rachel", "speed": 1.0 },
  "extra": { "frameworkSchema": "audio/v1", "frameworkData": { "type": "speech", "durationSeconds": 30, "sampleRate": 44100 } }
}

{
  "generation": { "model": "sora", "seed": 42 },
  "extra": { "frameworkSchema": "video/v1", "frameworkData": { "durationSeconds": 10, "resolution": "1920x1080", "fps": 24, "aspectRatio": "16:9", "style": "cinematic" } }
}

{
  "generation": { "model": "gpt-4o", "temperature": 0.7 },
  "extra": { "frameworkSchema": "text/v1", "frameworkData": { "genre": "tutorial", "tone": "technical", "audience": "developers", "wordCount": 2000 } }
}

curl -X POST https://wr.fi/api/creations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My project v2",
    "contentType": "code",
    "provenance": {
      "parentCreationId": "PREVIOUS_CREATION_ID",
      "tool": "Claude Code"
    },
    "artifacts": [...]
  }'

curl -X POST https://wr.fi/api/creations/CREATION_ID/fork \
  -H "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "wrify": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-fetch"],
      "env": {}
    }
  }
}

Use the fetch tool to POST to https://wr.fi/api/p with this JSON body:
{
  "title": "My AI creation",
  "contentType": "code",
  "generation": {"model": "claude-opus-4-6"},
  "provenance": {"tool": "Claude Desktop"},
  "artifacts": [{
    "data": "<base64-encoded content>",
    "mimeType": "text/x-python",
    "filename": "script.py"
  }]
}

{
  "name": "wrify_push",
  "description": "Push a creation to Wrify — the cross-model AI creation repository",
  "inputSchema": {
    "type": "object",
    "required": ["title", "contentType", "artifacts"],
    "properties": {
      "title": { "type": "string", "description": "Creation title" },
      "contentType": {
        "type": "string",
        "enum": ["code", "text", "image", "audio", "video"],
        "description": "Type of content"
      },
      "description": { "type": "string", "description": "Optional description" },
      "artifacts": {
        "type": "array",
        "items": {
          "type": "object",
          "required": ["data", "mimeType"],
          "properties": {
            "data": { "type": "string", "description": "Base64-encoded file content" },
            "mimeType": { "type": "string" },
            "filename": { "type": "string" }
          }
        }
      },
      "generation": {
        "type": "object",
        "properties": { "model": { "type": "string" } }
      },
      "provenance": {
        "type": "object",
        "properties": { "tool": { "type": "string" } }
      }
    }
  }
}

curl https://wr.fi/.well-known/wrify.json

npx wrify push <file> [options]

# Examples:
npx wrify push hello.py                        # anonymous, 30-day expiry
npx wrify push image.png --title "My art"       # with custom title
npx wrify push file.ts --key YOUR_API_KEY       # authenticated, permanent
npx wrify push script.sh --url http://localhost:3000  # custom server

// JSON to pre-fill:
const data = {
  title: "My creation",
  contentType: "code",
  description: "A Python script",
  textContent: "print('hello')",
  model: "claude-opus-4-6",
  tool: "Claude Code"
};

// Navigate to:
const url = "https://wr.fi/u#BASE64_JSON=" + btoa(JSON.stringify(data));

<iframe
  src="https://wr.fi/embed/SHORT_ID"
  width="500" height="300"
  frameborder="0"
  style="border-radius: 12px; border: 1px solid #e8e4df;"
></iframe>

<iframe
  src="https://wr.fi/embed/SHORT_ID?mode=live"
  width="100%" height="500"
  frameborder="0"
  sandbox="allow-scripts allow-same-origin"
></iframe>