Actions

List, refresh, update, and verify API Performance actions from the Sapient CLI.

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
sapient api-performance actions list	List API Performance actions.
sapient api-performance actions refresh	Regenerate actions from current results.
sapient api-performance actions retrieve --action-id <action_id>	Retrieve one action.
sapient api-performance actions update --action-id <action_id>	Update one action.
sapient api-performance actions verify --action-id <action_id>	Verify whether an action has been resolved.

List actions

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

Filter by action type or priority:

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

Example response:

{
  "data": [
    {
      "id": "action_123",
      "integration_id": "int_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

sapient api-performance actions refresh --force

Refresh actions for one source:

sapient api-performance actions refresh --integration-id int_123

Retrieve an action

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

Include the generated action prompt:

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

Update an action

Mark an action resolved:

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

Assign an owner or add an ignore reason:

sapient 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

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

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