Errors & troubleshooting — help

# Add -i to see the status line and headers (such as Retry-After on a 429)
curl -i -X POST https://api.modulex.dev/workflows/run \
  -H "Authorization: Bearer mx_live_your_api_key" \
  -H "X-Organization-ID: org_your_org_id" \
  -H "Content-Type: application/json" \
  -d '{ "workflow_id": "wf_29ab83c1", "input": { "topic": "release notes" } }'

from modulex import Modulex
from modulex import RateLimitError, BillingError, AuthenticationError, ModulexError

client = Modulex(
    api_key="mx_live_your_api_key",
    organization_id="org_your_org_id",
)

try:
    run = await client.executions.run(
        workflow_id="wf_29ab83c1",
        input={"topic": "release notes"},
    )
except AuthenticationError:
    print("401 — check your API key and organization id")
except RateLimitError as err:
    print(f"429 — retry after {err.retry_after} seconds")
except BillingError as err:
    # 402 / 403 / 429 usage limit — err.code and err.layer say which one
    print(f"Usage limit hit: {err.code} ({err.layer})")
except ModulexError as err:
    print(f"Request failed with status {err.status_code}")

import { Modulex } from "modulex-js";
import { AuthenticationError, RateLimitError, ModulexError } from "modulex-js";

const client = new Modulex({
  apiKey: "mx_live_your_api_key",
  organizationId: "org_your_org_id",
});

try {
  const run = await client.executions.run({
    workflowId: "wf_29ab83c1",
    input: { topic: "release notes" },
  });
} catch (err) {
  if (err instanceof AuthenticationError) {
    console.log("401 — check your API key and organization id");
  } else if (err instanceof RateLimitError) {
    console.log(`429 — retry after ${err.retryAfter} seconds`);
  } else if (err instanceof ModulexError) {
    // 402 / 403 usage limits expose .code, .layer, and .reason on the error
    console.log(`Request failed (${err.status}): ${err.code ?? "error"}`);
  }
}