Attention: List Proactive Actions

List Attention next-best actions for your users, filterable by owner and status.

Tool ID: attention_list_proactive_actions

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_list_proactive_actions',
  {
    "owner_uuid": "owner_123",
    "status": [
      "pending"
    ],
    "cursor": "cursor_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute attention_list_proactive_actions --input '{
  "owner_uuid": "owner_123",
  "status": [
    "pending"
  ],
  "cursor": "cursor_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "uuid": "uuid_123",
        "entity_type": "example",
        "entity_id": "entity_123",
        "owner_user_uuid": "owner_user_123",
        "action_type": "example",
        "title": "VP of Engineering",
        "signal_type": "example",
        "severity": "example",
        "display_group": "example",
        "subject": "Introduction",
        "draft_body": "example",
        "proposed_recipients": [
          "example"
        ],
        "proposed_slots": [
          "example"
        ],
        "status": "example",
        "external_url": "https://example.com",
        "why": {
          "rationale": "example",
          "key_quote": {}
        },
        "generated_at": "2026-01-15T12:00:00Z",
        "updated_at": "2026-01-15T12:00:00Z",
        "expires_at": "2026-01-15T12:00:00Z"
      }
    ],
    "next_cursor": "cursor_123"
  }
}

Use deepline describe attention_list_proactive_actions --json for the latest machine-readable contract.

Input reference

Lists Proactive actions (Next Best Actions), mirroring the action feed users see in the UI. ### Scope * An organization-level API key returns actions for every user in the organization. * A user-scoped API key returns only that user’s actions. The owner_uuid filter is ignored for user-scoped keys. ### Filtering * status defaults to pending. Pass one or more of pending, drafted, sent, dismissed, expired to widen the set. Suppressed actions are never returned. * owner_uuid narrows the result to a single owner (organization-level keys only). ### Pagination * Cursor-based. Omit cursor for the first page. pass the response’s next_cursor unchanged for the next. When next_cursor is absent, iteration is complete. * size is clamped to a server-side maximum of 200 (default 50).

Name	Type	Required	Default	Details
`payload.owner_uuid`	`string`	No	—	Filter to a single owner user UUID. Only honored for organization-level API keys. ignored for user-scoped keys.
`payload.status`	`array`	No	—	Lifecycle statuses to include. Defaults to pending only. Suppressed actions are never returned.
`payload.cursor`	`string`	No	—	Opaque pagination cursor from a previous response’s next_cursor. Omit for the first page.
`payload.size`	`integer`	No	—	Maximum number of actions to return per page (default 50, max 200) Minimum: 1. Maximum: 200.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`array`	No	—	—
`result.data.data[].uuid`	`string`	Yes	—	Unique identifier of the action
`result.data.data[].entity_type`	`string`	Yes	—	Type of the entity the action targets (e.g. crm_record)
`result.data.data[].entity_id`	`string`	Yes	—	Identifier of the entity the action targets
`result.data.data[].owner_user_uuid`	`string`	Yes	—	UUID of the user who owns the action
`result.data.data[].action_type`	`string`	Yes	—	Kind of action (e.g. send_email)
`result.data.data[].title`	`string`	Yes	—	Short title / next move
`result.data.data[].signal_type`	`string`	Yes	—	The parent signal’s type (e.g. no_reply, close_date_risk). Empty when the action has no parent signal.
`result.data.data[].severity`	`string`	Yes	—	The parent signal’s severity: high, medium, or low. Empty when absent.
`result.data.data[].display_group`	`string`	Yes	—	The deterministic feed section this action belongs to, derived from signal_type: At risk, You committed, Buying signals, Re-engage, Coordinate internally, CRM cleanup, Connect your tools, or Other.
`result.data.data[].subject`	`string`	Yes	—	Draft subject line, when the action is an email.
`result.data.data[].draft_body`	`string`	Yes	—	Drafted message body, when available.
`result.data.data[].proposed_recipients`	`array`	Yes	—	Proposed recipients of the drafted message.
`result.data.data[].proposed_slots`	`array`	Yes	—	Proposed meeting time slots, rendered in the rep’s timezone.
`result.data.data[].status`	`string`	Yes	—	Lifecycle status: pending, drafted, sent, dismissed, or expired.
`result.data.data[].external_url`	`string`	Yes	—	URL of the drafted artifact in the external system, when available
`result.data.data[].why`	`object`	Yes	—	The reasoning behind a Proactive action — the “why this suggestion” contract.
`result.data.data[].why.rationale`	`string`	No	—	Plain-language explanation of why this action is suggested.
`result.data.data[].why.key_quote`	`object`	No	—	—
`result.data.data[].why.key_quote.text`	`string`	No	—	—
`result.data.data[].why.key_quote.speaker`	`string`	No	—	—
`result.data.data[].why.key_quote.source_label`	`string`	No	—	—
`result.data.data[].why.key_quote.source_url`	`string`	No	—	—
`result.data.data[].why.evidence`	`array`	No	—	—
`result.data.data[].why.evidence[].label`	`string`	No	—	—
`result.data.data[].why.evidence[].description`	`string`	No	—	—
`result.data.data[].why.evidence[].impact`	`string`	No	—	—
`result.data.data[].why.evidence[].source_label`	`string`	No	—	—
`result.data.data[].why.evidence[].source_url`	`string`	No	—	—
`result.data.data[].generated_at`	`string`	Yes	—	When the action was generated Format: `date-time`.
`result.data.data[].updated_at`	`string`	Yes	—	When the action was last updated Format: `date-time`.
`result.data.data[].expires_at`	`string`	Yes	—	When the action stops being valid and is no longer shown. Format: `date-time`.
`result.data.next_cursor`	`string`	No	—	Opaque cursor for the next page. Absent when there are no more results.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation