---
title: "Get Next Actions"
method: GET
path: "/api/intelligence/next-actions"
tags: ["intelligence"]
---

# Get Next Actions

`GET /api/intelligence/next-actions`

## Request

- Base URL: `https://api.vruum.ai`
- URL: `https://api.vruum.ai/api/intelligence/next-actions`
- Auth: `HTTPBearer` (a scheme the document does not define)

Prioritized next-action list for the user.

Returns actions sorted by priority: reply responses (P1), message
approvals (P2), overdue follow-ups, deals, and due/overdue tasks (P3),
unenrolled high-match prospects (P4).

## Query parameters

- `limit` integer: Max actions to return

## Response `200`

Successful Response

- NextActionsResponse
  - `actions` NextAction[]
    - `action_type` string, required
    - `priority` integer, required
    - `title` string, required
    - `description` string, required
    - `person_id` string, nullable
    - `person_name` string, nullable
    - `message_id` string, nullable
    - `deal_id` string, nullable
    - `task_id` string, nullable
    - `channel` string, nullable
    - `content_preview` string, nullable
    - `objective_name` string, nullable
  - `total` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vruum/apis/vruum-public-api.md) · [All operations](https://skmtc.dev/vruum/apis/vruum-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vruum/apis/vruum-public-api/revisions/b8ada111c30a?raw)