Skip to main content

​
Endpoints

MethodPathWhat it does
GET/workflowsList workflows
POST/workflowsCreate a workflow
GET/workflows/{workflow_id}Get a workflow
PUT/workflows/{workflow_id}Update a workflow
DELETE/workflows/{workflow_id}Delete a workflow

​
List workflows

GET /workflows Common filters:
  • status: draft | published | archived
  • workflow_type: crewai | langgraph | autogen | semantic_kernel | custom
  • page, page_size
curl -sS "https://api.omium.ai/api/v1/workflows?page=1&page_size=20" \
  -H "X-API-Key: $OMIUM_API_KEY"

​
Create a workflow

POST /workflows 
curl -sS "https://api.omium.ai/api/v1/workflows" \
  -H "X-API-Key: $OMIUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My workflow",
    "description": "Workflow description",
    "workflow_type": "langgraph",
    "definition": { "nodes": [], "edges": [] },
    "tags": ["prod"],
    "status": "draft"
  }'

​
Get a workflow

GET /workflows/{workflow_id} 
curl -sS "https://api.omium.ai/api/v1/workflows/workflow_xyz" \
  -H "X-API-Key: $OMIUM_API_KEY"

​
Update a workflow

PUT /workflows/{workflow_id} 
curl -sS "https://api.omium.ai/api/v1/workflows/workflow_xyz" \
  -H "X-API-Key: $OMIUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated workflow name",
    "description": "Updated description",
    "status": "published",
    "definition": { "nodes": [], "edges": [] }
  }'

​
Delete a workflow

DELETE /workflows/{workflow_id} 
curl -sS -X DELETE "https://api.omium.ai/api/v1/workflows/workflow_xyz" \
  -H "X-API-Key: $OMIUM_API_KEY"

​
Next steps

First project

Push a project so workflows show up in Automations.

Automations

See workflow health, runs, and cost in the dashboard.