Public integration

AIISAJOKE Workflow API

Public workflow discovery plus personal MCP connections for safe, paid creative automation.

Manifest

{
  "version": "2026-05-13",
  "basePath": "/api/public",
  "authentication": {
    "catalog": "none",
    "agentConnection": {
      "header": "Authorization: Bearer ",
      "prefix": "aij_agent_",
      "createAt": "https://aiisajoke.com/settings/connect"
    }
  },
  "workflowApi": {
    "list": "/api/public/workflows",
    "detail": "/api/public/workflows/{stableId}",
    "executionAvailability": "temporarily_unavailable"
  },
  "mcp": {
    "endpoint": "/api/mcp",
    "protocol": "Streamable HTTP / JSON-RPC 2.0",
    "capabilities": [
      "catalog",
      "credits",
      "generation",
      "status",
      "library"
    ],
    "skill": "https://aiisajoke.com/skills/aiisajoke/SKILL.md"
  },
  "sdkShape": {
    "recommendedFlow": [
      "List public workflows without a key.",
      "Sign in and create a personal connection in Settings → Connect.",
      "Use MCP to search templates, inspect costs, run, poll status, and optionally read the library."
    ],
    "exampleClient": {
      "listWorkflows": {
        "method": "GET",
        "path": "/api/public/workflows"
      }
    }
  }
}

Authentication

Catalog list and detail routes are public. To create content, sign in at Settings → Connect and copy a personal MCP token. Tokens support expiry, rate limits, scopes, rotation, and revocation.

List Workflows

curl "$API_BASE/api/public/workflows" \
  -H "Accept: application/json"

Agent execution

Use POST /api/mcp with the copied bearer token. MCP supports catalog search, inputs and estimates, paid template runs, pending video status, credit balance, and opt-in library reads. The legacy public workflow-run endpoint remains unavailable.

OpenAPI JSON is available at /api/openapi.json.