INinstantly
AIInboxManager

Update an AI Inbox Manager reply

Changed on

Update a reply generated by an AI Inbox Manager: leave feedback on the reply or mark its pending action as handled.

Requires one of the following scopes: ai_sdr_replies:update, ai_agents:all, all:update, all:all

patch/api/v2/ai-agents/inbox-manager/{id}/replies/{reply_id}

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/inbox-manager/{id}/replies/{reply_id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-7b1c-7bec-adb7-652c6c87dfbb

AI Inbox Manager ID

reply_idstring uuid required
Example:01a19e6f-7b1c-7bec-adb7-652d18f039f7

Reply ID

Request body

feedback_positiveboolean

Whether the feedback on the reply is positive

feedback_textstring

Feedback text for this reply

action_pendingboolean

Whether this reply still requires action from the user

Example request

{
  "feedback_positive": true,
  "feedback_text": "Great response!"
}

Response

The updated reply

idstring uuid required

Unique identifier for the AI Sales Agent reply

organization_idstring uuid nullable

Organization ID

timestamp_createdstring nullable

Timestamp when the AI Sales Agent reply was created (ISO 8601)

timestamp_updatedstring nullable

Timestamp when the AI Sales Agent reply was last updated (ISO 8601)

agent_idstring uuid nullable

ID of the AI agent that generated this reply (nullable)

thread_idstring nullable

Conversation thread identifier (nullable)

leadstring nullable

Lead email address this reply is associated with

feedback_positiveboolean nullable

Whether the feedback on the reply was positive (nullable)

feedback_textstring nullable

Feedback text left by a user for this reply (nullable)

htmlstring nullable

HTML-formatted reply (nullable)

requires_hitlboolean nullable

If true, the reply requires human-in-the-loop review (nullable)

requires_hitl_reasonstring nullable

Reason why human-in-the-loop review is required (nullable)

generation_lag_secondsnumber nullable

Time taken (in seconds) for AI to generate the reply (nullable)

is_automatic_emailboolean nullable

Whether this reply was automatically sent as an email (nullable)

in_reply_tostring nullable

ID of the reply this message is in response to (nullable)

usage_metadataobject

JSON object with OpenAI usage, costs, and prompt data (nullable)

calendly_tool_usedboolean nullable

Whether the Calendly scheduling tool was used in this reply

confidence_scorenumber nullable

Confidence score for this AI-generated reply (nullable, 0-100)

information_requestedstring nullable

Text the AI used to request more information (nullable)

estimated_time_saved_secondsnumber nullable

Estimated time (in seconds) saved by the AI in generating this reply (nullable)

action_pendingboolean nullable

Whether this reply requires pending action from the user (nullable)

sending_status-1 | 1 | 2

Status of the email sending process

is_followupboolean nullable

Whether this reply is an automatic follow-up to a previous reply (nullable)

error_code'NO_SENDING_ACCOUNT' | 'ACCOUNT_INACTIVE' | 'ACCOUNT_FETCH_FAILED' | 'SEND_FAILED' | 'HITL_NOT_SUPPORTED' | 'RATE_LIMITED' | 'AGENT_NOT_FOUND' | 'LEAD_BLOCKED' | 'FREE_TRIAL_LIMIT_REACHED' | 'OUT_OF_CREDITS' | 'MONTHLY_BUDGET_EXCEEDED'

Error code for the email sending process (nullable)

Example response

{
  "id": "01a19e6f-3fac-7c01-831a-3460653c27bf",
  "organization_id": "01a19e6f-3fac-7c01-831a-346131831c99",
  "timestamp_created": "2026-11-02T22:44:13.356Z",
  "timestamp_updated": "2026-11-02T22:44:13.356Z",
  "agent_id": "01a19e6f-3fac-7c01-831a-3462479b6ab5",
  "thread_id": "3c-zuFiJhv7cqJE5IoKkg6Pzh9",
  "lead": "john@example.com",
  "feedback_positive": true,
  "feedback_text": "Great response!",
  "html": "<p>Hello, John!</p>",
  "requires_hitl": true,
  "requires_hitl_reason": "Low confidence score detected",
  "generation_lag_seconds": 2.5,
  "in_reply_to": "reply_12345",
  "confidence_score": 92,
  "information_requested": "Please confirm your availability.",
  "estimated_time_saved_seconds": 30,
  "action_pending": true,
  "sending_status": 1,
  "is_followup": true,
  "error_code": "SEND_FAILED"
}

Changes