Developer API¶

The GloriaMundo Developer API lets you trigger workflows from your own applications via HTTP. Build internal tools, connect to third-party platforms, or automate workflows programmatically.

What You Can Do¶

• Execute workflows — Trigger any workflow with custom input data
• Poll for results — Check execution progress and retrieve outputs
• Manage API keys — Create, list, and revoke access keys
• Control spending — Set daily, weekly, or monthly spend limits

Base URL¶

All API endpoints are served from:

https://app.gloriamundo.com/api/v1/

Quick Example¶

# 1. Execute a workflow
curl -X POST https://app.gloriamundo.com/api/v1/workflows/{workflow_id}/execute \
  -H "Authorization: Bearer gm_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input": {"customer_name": "Acme Corp"}}'

# Response: {"run_id": "abc-123", "status": "queued", "poll_url": "/api/v1/runs/abc-123/status"}

# 2. Poll for results
curl https://app.gloriamundo.com/api/v1/runs/abc-123/status \
  -H "Authorization: Bearer gm_live_..."

# Response: {"run_id": "abc-123", "status": "completed", "result": {...}, "cost_cents": 15}

Endpoints¶

Authentication¶

All API requests require an API key. Include it as a Bearer token or via the X-API-Key header.

Learn more about authentication

Rate Limiting¶

Rate limits are applied per-user, per-endpoint. The following table shows the default limits:

When a limit is exceeded the API returns 429 Too Many Requests with a retry_after field indicating the window length in seconds.

Next Steps¶

• Set up authentication
• Execute your first workflow
• Configure spend controls