Skip to main content

Actions API

List and execute actions from the action catalog.

List Actions​

GET /v1/actions

Scope required: actions

Response​

{
  "actions": [
    {
      "id": "action_jira",
      "name": "Create Jira Ticket",
      "description": "Creates a support ticket in Jira",
      "http_method": "POST",
      "is_active": true,
      "parameters": [
        { "name": "summary", "type": "string", "description": "Ticket title", "required": true },
        { "name": "description", "type": "string", "description": "Ticket body", "required": true },
        { "name": "priority", "type": "string", "description": "high/medium/low", "required": false }
      ]
    }
  ]
}

Execute Action​

POST /v1/actions/:id/execute

Execute an action directly, bypassing the AI agent's slot-filling flow.

Request​

{
  "params": {
    "summary": "Login page broken",
    "description": "Users cannot log in since the last deployment",
    "priority": "high"
  }
}

Response (Success)​

{
  "success": true,
  "status_code": 200,
  "action_id": "action_jira",
  "action_name": "Create Jira Ticket",
  "response": {
    "id": "PROJ-142",
    "key": "PROJ-142",
    "self": "https://your-jira.atlassian.net/rest/api/2/issue/PROJ-142"
  }
}

Response (Error)​

{
  "success": false,
  "status_code": 502,
  "action_id": "action_jira",
  "action_name": "Create Jira Ticket",
  "response": "Authentication failed: invalid token"
}