Response Actions

get

List all response actions

Authorizations
Query parameters
is_archivedbooleanOptional

Filter by archived status (default: false)

Responses
200

List of response actions

application/json
get
/app/api/v1/response-actions
GET /app/api/v1/response-actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "id": 1,
    "trigger_def": {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-11-02T16:06:36.954Z",
      "updated_at": "2025-11-02T16:06:36.954Z",
      "trigger_tree_labels": [
        "text"
      ],
      "trigger_display_name": "text",
      "trigger_fn_name": "text",
      "trigger_arg_names": [
        "text"
      ],
      "script_var_names": [
        "text"
      ],
      "is_scriptable": true,
      "is_runnable": true,
      "display_index": 1,
      "is_archived": true,
      "parent": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created_at": "2025-11-02T16:06:36.954Z",
    "updated_at": "2025-11-02T16:06:36.954Z",
    "display_name": "text",
    "is_enabled": true,
    "is_archived": true
  }
]
post

Create a new response action

Authorizations
Body
display_namestringRequired
trigger_def_uuidstring · uuidRequired
codestringOptional
Responses
201

Response action created successfully

application/json
post
/app/api/v1/response-actions
POST /app/api/v1/response-actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "display_name": "text",
  "trigger_def_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "code": "text"
}
{
  "id": 1,
  "trigger_def": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2025-11-02T16:06:36.954Z",
    "updated_at": "2025-11-02T16:06:36.954Z",
    "trigger_tree_labels": [
      "text"
    ],
    "trigger_display_name": "text",
    "trigger_fn_name": "text",
    "trigger_arg_names": [
      "text"
    ],
    "script_var_names": [
      "text"
    ],
    "is_scriptable": true,
    "is_runnable": true,
    "display_index": 1,
    "is_archived": true,
    "parent": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created_at": "2025-11-02T16:06:36.954Z",
  "updated_at": "2025-11-02T16:06:36.954Z",
  "display_name": "text",
  "is_enabled": true,
  "is_archived": true
}
get

Get response action details with version and run counts

Authorizations
Path parameters
script_idintegerRequired
Responses
200

Response action details with counts and latest version/run

application/json
get
/app/api/v1/response-actions/{script_id}
GET /app/api/v1/response-actions/{script_id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "counts": {
    "version": 1,
    "run": 1
  },
  "latest": {
    "version": {},
    "run": {}
  }
}
delete

Archive (soft delete) a response action. Deletes unreferenced versions.

Authorizations
Path parameters
script_idintegerRequired
Responses
204

Response action archived successfully

No content

delete
/app/api/v1/response-actions/{script_id}
DELETE /app/api/v1/response-actions/{script_id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

No content

patch

Update response action properties

Authorizations
Path parameters
script_idintegerRequired
Body
display_namestringOptional
trigger_def_uuidstring · uuidOptional
is_enabledbooleanOptional
Responses
200

Response action updated successfully

No content

patch
/app/api/v1/response-actions/{script_id}
PATCH /app/api/v1/response-actions/{script_id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "display_name": "text",
  "trigger_def_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "is_enabled": true
}

No content

get

List all runs for a response action

Authorizations
Path parameters
script_idintegerRequired
Responses
200

List of response action runs

application/json
get
/app/api/v1/response-actions/{script_id}/runs
GET /app/api/v1/response-actions/{script_id}/runs HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "id": 1,
    "trigger_run": {
      "id": 1,
      "trigger_def": {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "created_at": "2025-11-02T16:06:36.954Z",
        "updated_at": "2025-11-02T16:06:36.954Z",
        "trigger_tree_labels": [
          "text"
        ],
        "trigger_display_name": "text",
        "trigger_fn_name": "text",
        "trigger_arg_names": [
          "text"
        ],
        "script_var_names": [
          "text"
        ],
        "is_scriptable": true,
        "is_runnable": true,
        "display_index": 1,
        "is_archived": true,
        "parent": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created_at": "2025-11-02T16:06:36.954Z",
      "updated_at": "2025-11-02T16:06:36.954Z",
      "trigger_args": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "batch": 1
    },
    "script": {
      "id": 1,
      "created_at": "2025-11-02T16:06:36.954Z",
      "updated_at": "2025-11-02T16:06:36.954Z",
      "display_name": "text",
      "is_enabled": true,
      "is_archived": true,
      "trigger_def": "123e4567-e89b-12d3-a456-426614174000"
    },
    "script_version": {
      "id": 1,
      "author": {
        "id": 1,
        "first_name": "text",
        "last_name": "text",
        "email": "[email protected]",
        "role": "admin",
        "oidc_user_id": "text"
      },
      "created_at": "2025-11-02T16:06:36.954Z",
      "updated_at": "2025-11-02T16:06:36.954Z",
      "v_num": 1,
      "code": "text",
      "script": 1
    },
    "created_at": "2025-11-02T16:06:36.954Z",
    "updated_at": "2025-11-02T16:06:36.954Z",
    "status": "running",
    "stdout": "text",
    "stderr": "text",
    "syserr": "text"
  }
]
post

Execute a test run of a response action script without saving to database. Useful for testing and debugging scripts before deployment.

Authorizations
Body
script_codestringRequired

The Python code to execute

trigger_argsobjectRequired

Arguments to pass to the script (depends on trigger type)

Responses
200

Test run completed successfully

application/json
post
/app/api/v1/response-actions/test
POST /app/api/v1/response-actions/test HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "script_code": "text",
  "trigger_args": {}
}
{
  "status": "text",
  "stdout": "text",
  "stderr": "text"
}
get

List available response triggers for action creation

Authorizations
Responses
200

List of available triggers

application/json
get
/app/api/v1/response-actions/triggers
GET /app/api/v1/response-actions/triggers HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
[
  {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2025-11-02T16:06:36.954Z",
    "updated_at": "2025-11-02T16:06:36.954Z",
    "trigger_tree_labels": [
      "text"
    ],
    "trigger_display_name": "text",
    "trigger_fn_name": "text",
    "trigger_arg_names": [
      "text"
    ],
    "script_var_names": [
      "text"
    ],
    "is_scriptable": true,
    "is_runnable": true,
    "display_index": 1,
    "is_archived": true,
    "parent": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Last updated

Was this helpful?