Actions

Actions are prioritized improvements generated from API Performance results. Use them to track docs gaps, integration failures, and other issues that affect coding-agent success.

Commands

Command	Description
`lightsage api-performance actions list`	List API Performance actions.
`lightsage api-performance actions refresh`	Regenerate actions from current results.
`lightsage api-performance actions retrieve --action-id <action_id>`	Retrieve one action.
`lightsage api-performance actions update --action-id <action_id>`	Update one action.
`lightsage api-performance actions verify --action-id <action_id>`	Verify whether an action has been resolved.

List actions

lightsage api-performance actions list --status open --limit 50

Filter by action type or priority:

lightsage api-performance actions list \
  --action-type docs_gap \
  --priority high

Example response:

{
  "data": [
    {
      "id": "action_123",
      "source_id": "source_123",
      "action_type": "docs_gap",
      "status": "open",
      "priority": "high",
      "confidence": 0.9,
      "effort": "low",
      "title": "Improve SDK install docs",
      "description": "Agents fail before making the first request.",
      "source": "api_performance",
      "fingerprint": "action-fingerprint"
    }
  ],
  "counts": {
    "open": 1
  },
  "summary": {}
}

Refresh actions

lightsage api-performance actions refresh --force

Refresh actions for one source:

lightsage api-performance actions refresh --source-id source_123

Retrieve an action

lightsage api-performance actions retrieve --action-id action_123

Include the generated action prompt:

lightsage api-performance actions retrieve --action-id action_123 --include-prompt

Update an action

Mark an action resolved:

lightsage api-performance actions update --action-id action_123 --status '"resolved"'

Assign an owner or add an ignore reason:

lightsage api-performance actions update --action-id action_123 \
  --owner-user-id '"user_123"' \
  --ignored-reason '"Covered by upcoming docs rewrite"'

Updateable fields:

Flag	Description
`--status`	Action status.
`--owner-user-id`	User responsible for the action.
`--ignored-reason`	Reason an action is ignored.
`--note`	Operator note.

Verify an action

lightsage api-performance actions verify --action-id action_123

Verification checks whether Lightsage can observe that the recommended fix is now present.

CLI Reference

Prompts

API Performance

Commands

List actions

Refresh actions

Retrieve an action

Update an action

Verify an action

​Commands

​List actions

​Refresh actions

​Retrieve an action

​Update an action

​Verify an action

Commands

List actions

Refresh actions

Retrieve an action

Update an action

Verify an action