---
title: "Get the default AI Deliverability Agent state"
method: GET
path: "/api/v2/ai-agents/deliverability/state"
tags: ["AIDeliverabilityAgent"]
---

# Get the default AI Deliverability Agent state

`GET /api/v2/ai-agents/deliverability/state`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/ai-agents/deliverability/state`
- Auth: HTTP bearer

Get the live state of the workspace default AI Deliverability Agent, including current activity, schedule, latest run summary, and activity feed. If no agent has been deployed, this endpoint returns an empty state with `agent` set to `null`.


Requires one of the following scopes: `ai_agents:read`, `ai_agents:all`, `all:read`, `all:all`

## Query parameters

- `limit` integer
- `starting_after` string
- `feed_filter` 'all' | 'todo' | 'done'

## Response `200`

Default Response

- object
  - `agent` AIAgent, required: An AI agent
    - `id` string, uuid, required: Unique identifier for the AI agent
    - `organization_id` string, uuid, required: Organization ID
    - `name` string, required: Name of the AI Agent
    - `payload` union, required: Payload of the AI Agent. Either reply agent (Inbox Manager) or sales agent (SDR), depending on type.
      - object: Lead Finder Agent payload
        - `campaign_id` string, uuid, required: Campaign this agent keeps topped up
        - `campaign_name` string: Denormalized campaign name
        - `search_filters` object: Primary audience search filters
        - `min_active_leads` number: Threshold below which the agent tops up the campaign
        - `on_exhaustion` 'pause' | 'fallback' | 'broaden': What the agent does when the search runs out of new leads
        - `fallback_search_filters` object, nullable: Optional fallback audience used when the primary search is exhausted
        - `ai_enrichment` object, nullable: AI enrichment columns the agent fills on every top-up, keyed by output column name. Returned in the stored executor shape; the write shape is documented on the create and update endpoints.
        - `ai_enrichment_workflow` string, nullable: Workflow template the enrichment chain was loaded from — a built-in key or `custom:<id>`.
      - object: Voice Agent payload
        - `provider` 'elevenlabs', required: Voice provider adapter key
        - `voice_id` string: Selected provider voice id
        - `language` string: Agent language
        - `system_prompt` string: Agent system prompt
        - `first_message` string: Opening line
        - `phone_number_id` string, uuid, nullable: Assigned phone number id
      - object: Sales agent (SDR) payload
        - `ai_sdr_config` object, required: AI Sales Agent agent config
          - `memory` object: Business context and memory for the AI Sales Agent
            - `company` string
            - `business_description` string
            - `active_icps_indexes` number[]
            - `icps` object[]
              - …
            - `research_objectives` union
              - …
            - `research_questions` union
              - …
            - `custom_research_objectives` union
              - …
            - `custom_fields` string[]
            - `messaging_angles` object[]
              - …
            - `claim_evidence` object[]
              - …
            - `business_offers` string[]
            - `active_business_offers_indexes` number[]
          - `enrichment_settings` object: Settings for lead enrichment
            - `enrichment_limit_per_run` number: Maximum number of leads to enrich per run
            - `signal_targeting_enabled` boolean: Whether the agent puts leads with recent buying signals first. AI Sales Agents only; other agent types ignore it. Defaults to true when omitted. Signals rank rather than filter: when fewer signal-carrying leads are available than the agent's daily target, the remainder is filled with other leads matching the ICP, so this never reduces the number of leads sourced. Set to false to stop prioritizing signals; the stored categories are kept for when it is turned back on.
            - `signal_targeting_categories` string[]: Signal categories the agent prioritizes while signal targeting is on (AI Sales Agents only), each with a 90-day freshness window. Omit to use the default high-intent set (recent funding or acquisition, executive leadership change, pricing change, product launch, company expansion, buying intent on Reddit). An empty array prioritizes nothing; a non-empty array targets exactly those categories.
          - `outreach_settings` object: Settings for email outreach
            - `campaign_schedule` object
              - …
            - `email_list` string[]
            - `email_tag_list` string[]
            - `daily_limit` number
            - `stop_on_reply` boolean
            - `open_tracking` boolean
            - `first_email_text_only` boolean
            - `prioritize_new_leads` boolean
            - `match_lead_esp` boolean
          - `autonomy_settings` object: Settings for AI Sales Agent autonomy
            - `autopilot_mode` boolean: Whether autopilot mode is enabled
            - `auto_reply_to_responses` boolean: Whether to auto-reply to responses
        - `type` 'website' | 'pitch_deck': SDR source type
        - `input` string: SDR input (e.g. website URL or pitch deck reference)
        - `master_lead_list_id` string, uuid: Master lead list ID for the SDR
        - `initial_scrape_ready` boolean: Whether initial scrape is ready
        - `timestamp_last_action` string, date-time: Timestamp of last SDR action
        - `timestamp_last_decision` string, date-time: Timestamp of last SDR decision
        - `next_decision_time` string, date-time: Scheduled time for next decision
      - object: Reply agent (Inbox Manager) payload
        - `configuration_type` 1 | 2: Type of the AI agent configuration
        - `tags` union[]: List of tags to use for AI Agent
          - union
            - 'default'
            - string, uuid
        - `handle_followup` boolean: Whether to handle follow-up emails
        - `respond_to_automatic_emails` boolean: Whether to respond to automatic emails
        - `handle_objections` boolean: Whether to handle objections, declines, or negative replies
        - `integrations` object: Configurations for app integrations
        - `no_show` object: No-show recovery feature configuration
          - `enabled` boolean: Enable no-show recovery mode
          - `max_followups` number: Maximum number of no-show follow-up emails (1-10)
          - `fallback_sending_accounts` object
            - `accounts` string[]
            - `tag_ids` string[]
        - `trigger_on_labels_enabled` boolean: Whether to activate the agent only for specific interest labels
        - `trigger_on_labels` number[]: Array of interest_status values to trigger the agent on
        - `trigger_on_labels_mode` 'include' | 'exclude': Whether to include or exclude the selected labels. Defaults to include.
        - `monthly_credit_budget` number, nullable: Monthly AI credit budget for this agent (null = unlimited)
        - `followup_business_days_only` boolean: Whether to send follow-up emails only on business days (Mon-Fri)
        - `followup_delay` integer, nullable: How long to wait before each follow-up email, in `followup_delay_unit`. Measured from the agent's last email to the lead. Use 1 to 90 days or 1 to 2160 hours. If the lead asks for a specific time, the agent uses that time instead. `null` (the default) lets the agent pick the timing (about 3 days).
        - `followup_delay_unit` 'hours' | 'days': Unit of `followup_delay`. Defaults to `days`.
      - object: Deliverability Agent payload
        - `integrations` object: Configurations for Deliverability Agent app integrations
          - `slack` object, nullable
            - `connection_id` string: Slack app connection ID
            - `enabled` boolean: Whether Slack notifications are enabled for this Deliverability Agent.
            - `connection_name` string: Deprecated. Kept only so previously stored values round-trip.
            - `channel_id` string: Deprecated. Kept only so previously stored values round-trip.
            - `channel_name` string: Deprecated. Kept only so previously stored values round-trip.
    - `type` 1 | 2 | 3 | 4 | 6 | 7 | 8 | 9 | 10 | 11, nullable: Type of the AI Agent
    - `timestamp_created` string, required: Timestamp when the AI agent was created
    - `timestamp_updated` string, required: Timestamp when the AI agent was updated
    - `status` -1 | 0 | 1, required: Status of the AI Agent
    - `is_auto_created` boolean, nullable: Whether the AI agent was auto-created
    - `created_by` string, uuid, nullable: User ID who created the AI agent
    - `description` string, nullable: Description of the AI agent
  - `current_activity` object, required
    - `active` object, nullable, required
      - `id` string, uuid, required
      - `organization_id` string, uuid, required
      - `agent_id` string, uuid, required
      - `cycle_id` string, nullable
      - `activity_code` string, required
      - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled', required
      - `priority` number, required
      - `subject_type` string, nullable
      - `subject_id` string, nullable
      - `subject_name` string, nullable
      - `payload` object, required
      - `result_payload` object, nullable
      - `error_code` string, nullable
      - `error_message` string, nullable
      - `idempotency_key` string, required
      - `timestamp_created` string, date-time, required
      - `timestamp_updated` string, date-time, required
      - `queued_at` string, date-time, nullable
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
      - `sub_messages` object[], required
        - `id` string, uuid, required
        - `organization_id` string, uuid, required
        - `agent_id` string, uuid, required
        - `activity_id` string, uuid, required
        - `message_code` string, required
        - `status` 'queued' | 'in_progress' | 'completed' | 'failed', required
        - `sort_order` number, required
        - `subject_type` string, nullable
        - `subject_id` string, nullable
        - `subject_name` string, nullable
        - `payload` object, required
        - `result_payload` object, nullable
        - `error_code` string, nullable
        - `error_message` string, nullable
        - `idempotency_key` string, required
        - `timestamp_created` string, date-time, required
        - `timestamp_updated` string, date-time, required
        - `completed_at` string, date-time, nullable
    - `queued` object[], required
      - `id` string, uuid, required
      - `organization_id` string, uuid, required
      - `agent_id` string, uuid, required
      - `cycle_id` string, nullable
      - `activity_code` string, required
      - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled', required
      - `priority` number, required
      - `subject_type` string, nullable
      - `subject_id` string, nullable
      - `subject_name` string, nullable
      - `payload` object, required
      - `result_payload` object, nullable
      - `error_code` string, nullable
      - `error_message` string, nullable
      - `idempotency_key` string, required
      - `timestamp_created` string, date-time, required
      - `timestamp_updated` string, date-time, required
      - `queued_at` string, date-time, nullable
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
    - `completed_summary` object, required
      - `count` number, required
      - `retention_days` number, required
      - `last_completed_at` string, date-time, nullable, required
  - `schedule` object, required
    - `next_run_at` string, date-time, nullable, required
  - `run_summary` object, required
    - `latest` object, required
      - `cycle_id` string, nullable, required
      - `status` 'running' | 'completed' | 'scheduled' | 'empty', required
      - `started_at` string, date-time, nullable, required
      - `completed_at` string, date-time, nullable, required
      - `total_checks` number, required
      - `completed_checks` number, required
      - `healthy_count` number, required
      - `needs_attention_count` number, required
      - `info_count` number, required
      - `failed_count` number, required
      - `checks` object[], required
        - `activity_id` string, uuid, required
        - `activity_code` string, required
        - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled', required
        - `outcome` 'healthy' | 'needs_attention' | 'info' | 'running' | 'queued' | 'failed' | 'skipped' | 'cancelled' | 'unknown', required
        - `completed_at` string, date-time, nullable, required
      - `feed_items` object[], required
        - `id` string, uuid, required
        - `organization_id` string, uuid, required
        - `agent_id` string, uuid, required
        - `source_activity_id` string, nullable
        - `feed_code` string, required
        - `kind` 'insight' | 'recommendation' | 'action', required
        - `status` 'todo' | 'done' | 'dismissed' | 'failed', required
        - `severity` 'info' | 'success' | 'warning' | 'critical', required
        - `priority` number, required
        - `subject_type` string, nullable
        - `subject_id` string, nullable
        - `subject_name` string, nullable
        - `payload` object, required
        - `result_payload` object, nullable
        - `action_code` string, nullable
        - `action_status` string, nullable
        - `action_payload` object, nullable
        - `dedupe_key` string, required
        - `timestamp_created` string, date-time, required
        - `timestamp_updated` string, date-time, required
        - `completed_at` string, date-time, nullable
        - `dismissed_at` string, date-time, nullable
        - `expires_at` string, date-time, nullable
    - `trend` object[], required
      - `cycle_id` string, required
      - `completed_at` string, date-time, required
      - `score` number, nullable, required
      - `total_checks` number, required
      - `healthy_count` number, required
      - `needs_attention_count` number, required
      - `info_count` number, required
      - `failed_count` number, required
  - `activity_feed` object, required
    - `items` object[], required
      - `id` string, uuid, required
      - `organization_id` string, uuid, required
      - `agent_id` string, uuid, required
      - `source_activity_id` string, nullable
      - `feed_code` string, required
      - `kind` 'insight' | 'recommendation' | 'action', required
      - `status` 'todo' | 'done' | 'dismissed' | 'failed', required
      - `severity` 'info' | 'success' | 'warning' | 'critical', required
      - `priority` number, required
      - `subject_type` string, nullable
      - `subject_id` string, nullable
      - `subject_name` string, nullable
      - `payload` object, required
      - `result_payload` object, nullable
      - `action_code` string, nullable
      - `action_status` string, nullable
      - `action_payload` object, nullable
      - `dedupe_key` string, required
      - `timestamp_created` string, date-time, required
      - `timestamp_updated` string, date-time, required
      - `completed_at` string, date-time, nullable
      - `dismissed_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
    - `next_starting_after` string, nullable

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `bea714781ea4`: 4 info
  - added `subschema #1, subschema #2` to the `current_activity/active/anyOf[subschema #1]/` response property `allOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `current_activity/active/anyOf[subschema #1]/` response property `allOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `agent/anyOf[subschema #1: AI Agent]/payload` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `agent/anyOf[subschema #1: AI Agent]/payload` response property `anyOf` list for the response status `200`
- **2026-11-03** `3daaa5f6b0be`: 4 info
  - added `subschema #1, subschema #2` to the `current_activity/active/anyOf[subschema #1]/` response property `allOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `current_activity/active/anyOf[subschema #1]/` response property `allOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `agent/anyOf[subschema #1: AI Agent]/payload` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `agent/anyOf[subschema #1: AI Agent]/payload` response property `anyOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/ai-agents/deliverability/state/get.md)

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/bea714781ea4?raw)