> ## 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 prompt actionables, cited pages, and opportunities from the Lightsage CLI.

Actions are prompt-level work items Lightsage derives from Visibility data. Use them to inspect cited pages and opportunities found from existing prompt results.

The response contains two sections:

* `opportunities`: content, competitor, sentiment, visibility, and citation opportunities.
* `cited_pages`: pages cited in AI answers, with citation counts and page metadata.

## Command

| Command                          | Description              |
| -------------------------------- | ------------------------ |
| `lightsage prompts actions list` | List prompt actionables. |

## List actionables

List both sections:

```bash theme={null}
lightsage prompts actions list --tag all --limit 25
```

Return only opportunities:

```bash theme={null}
lightsage prompts actions list \
  --tag opportunities \
  --category quick_wins \
  --opportunity-type citation_gaps
```

Return only cited pages:

```bash theme={null}
lightsage prompts actions list \
  --tag cited_pages \
  --prompt-ids prompt_123,prompt_456 \
  --cited-pages-limit 50
```

Filter by date window:

```bash theme={null}
lightsage prompts actions list \
  --start-date 2026-05-01 \
  --end-date 2026-05-23
```

Example response:

```json theme={null}
{
  "start_date": "2026-05-01",
  "end_date": "2026-05-23",
  "tag": "all",
  "opportunities": [
    {
      "id": "opp_123",
      "type": "citation_gaps",
      "category": "citations",
      "priority": "high",
      "title": "Improve citations for API authentication docs",
      "description": "Competitor docs are cited more often for authentication prompts.",
      "action": "Add clearer authentication examples and troubleshooting guidance.",
      "impact_score": 87.5,
      "created_at": "2026-05-23T00:00:00Z"
    }
  ],
  "opportunity_count": 1,
  "cited_pages": [
    {
      "url": "https://docs.example.com/authentication",
      "domain": "docs.example.com",
      "title": "Authentication",
      "is_company_link": true,
      "citation_count": 14
    }
  ],
  "cited_page_count": 1,
  "summary": {
    "by_category": {
      "citations": 1
    }
  }
}
```

Useful filters:

| Flag                    | Description                                                                      |
| ----------------------- | -------------------------------------------------------------------------------- |
| `--tag`                 | Return `cited_pages`, `opportunities`, or `all`. Defaults to `all`.              |
| `--since`               | Relative lookback window such as `7d` or `72h`.                                  |
| `--start-date`          | Inclusive start date.                                                            |
| `--end-date`            | Inclusive end date.                                                              |
| `--category`            | Opportunity category, such as `quick_wins`, `growth`, `refresh`, or `citations`. |
| `--opportunity-type`    | Opportunity type, such as `citation_gaps` or `competitor_gaps`.                  |
| `--topic-id`            | Restrict results to one topic.                                                   |
| `--prompt-ids`          | Comma-separated prompt IDs.                                                      |
| `--include-cited-pages` | Include cited page details when `--tag all` is used.                             |
| `--limit`               | Maximum opportunities to return.                                                 |
| `--cited-pages-limit`   | Maximum cited pages to return.                                                   |