> ## Documentation Index
> Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions

> List, refresh, update, and verify API Performance actions from the Lightsage 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                                 |
| -------------------------------------------------------------------- | ------------------------------------------- |
| `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

```bash theme={null}
lightsage api-performance actions list --status open --limit 50
```

Filter by action type or priority:

```bash theme={null}
lightsage api-performance actions list \
  --action-type docs_gap \
  --priority high
```

Example response:

```json theme={null}
{
  "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

```bash theme={null}
lightsage api-performance actions refresh --force
```

Refresh actions for one source:

```bash theme={null}
lightsage api-performance actions refresh --source-id source_123
```

## Retrieve an action

```bash theme={null}
lightsage api-performance actions retrieve --action-id action_123
```

Include the generated action prompt:

```bash theme={null}
lightsage api-performance actions retrieve --action-id action_123 --include-prompt
```

## Update an action

Mark an action resolved:

```bash theme={null}
lightsage api-performance actions update --action-id action_123 --status '"resolved"'
```

Assign an owner or add an ignore reason:

```bash theme={null}
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

```bash theme={null}
lightsage api-performance actions verify --action-id action_123
```

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