IonWarp logoIonWarp
Get started
IonWarp Docs
Collections

Quick Actions

One-click next steps the scorecard suggests.

Base path /api/v1/quick-actions on https://ionwarp.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.

List quick actions

GET /api/v1/quick-actions

curl "https://ionwarp.com/api/v1/quick-actions?goal=open_pr" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
What are the highest-impact actions I can take right now?
data_query {
  "collection": "quick_actions",
  "where": {
    "goal": "open_pr"
  }
}

Returns a paginated list of quick-action objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "quick-action",
      "id": "obj_123",
      "label": "Add a CI workflow",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
goalstringfilterWhat pressing the action does — open a PR, review a PR, run a scorecard scan, produce a report, or start a plain task. One of open_pr, review_pr, scorecard_scan, manual_task, scorecard_task, pr_metrics, acceleration_report, pr_summary.
severitystringfilterSeverity inherited from the check that raised this action.
enabledbooleanfilterWhether the action is offered right now.
action_statusstringfilterWhether the action can actually run. available implies a working action_skill_id; running means it is already in flight. One of available, not_needed, not_available, running.
target_collectionstringfilterCollection of the object this action acts on, when it is scoped to one.
qstringsearchFree-text search across label, prompt.
sortstringsortOne of display_order, impact_points; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

Retrieve a quick-action

GET /api/v1/quick-actions/learning-tests-run-under-bun

curl "https://ionwarp.com/api/v1/quick-actions/learning-tests-run-under-bun" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"
Open the quick-action {id}
data_get {
  "collection": "quick_actions",
  "object_id": "learning-tests-run-under-bun"
}

Returns the quick-action object.

{
  "object": "quick-action",
  "id": "obj_123",
  "label": "Add a CI workflow",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe quick-action's id or slug.

What comes back (read-only)

Every quick-action carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.

FieldTypeDescription
objectstringAlways quick-action.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
labelstringButton text for the action.
promptstringThe instruction the action sends when it is pressed.
goalstringWhat pressing the action does — open a PR, review a PR, run a scorecard scan, produce a report, or start a plain task.
impact_labelstringHow the action states its upside, e.g. "+4% scorecard". Falls back to +\<impact_points>% scorecard when none was written.
impact_pointsnumberPercentage points the scorecard gains if this action is carried out.
severitystringSeverity inherited from the check that raised this action.
target_collectionstringCollection of the object this action acts on, when it is scoped to one.
target_object_idstringId of the object inside target_collection this action acts on.
display_ordernumberSort position on the home action strip.
enabledbooleanWhether the action is offered right now.
action_statusstringWhether the action can actually run. available implies a working action_skill_id; running means it is already in flight.
action_skill_idstringSkill the action runs (e.g. open-pr).

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

IonWarp logoIonWarp

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans