---
title: "Save inbox classifications"
method: PATCH
path: "/v1/inbox/saveClassifications"
tags: ["inbox"]
---

# Save inbox classifications

`PATCH /v1/inbox/saveClassifications`

## Request

- Base URL: `https://api.zevari.ai`
- URL: `https://api.zevari.ai/v1/inbox/saveClassifications`
- Auth: HTTP bearer

Transport: call this endpoint with HTTP PATCH and a JSON request body. Persist intent classifications for inbox messages and trigger Slack/email alerts for high-intent replies.

## Request body

- object
  - `classifications` object[], required: Array of classification results
    - `chat_id` string, required: inbox_messages.chat_id
    - `message_id` string, required: inbox_messages.message_id
    - `direction` 'sender_evaluating_recipient_offer' | 'sender_selling_to_recipient' | 'sender_giving_resource' | 'sender_requesting_resource' | 'generic_conversation' | 'complaint_or_negative' | 'unknown'
    - `classification` 'lead_magnet_request' | 'business_inquiry' | 'warm_engagement' | 'conversation' | 'giving_resource' | 'none', required
    - `intent_score` number, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `is_giving` boolean, required
    - `has_business_intent` boolean, required
    - `icp_score` number, nullable
    - `icp_fit` 'strong' | 'moderate' | 'weak' | 'not_fit' | 'unknown', nullable
    - `icp_confidence` 'high' | 'medium' | 'low', nullable
    - `icp_reasoning` string, nullable
    - `classifier_model` string, nullable
    - `classifier_version` string, nullable
    - `alert_recommendation` 'alert' | 'review' | 'no_alert', nullable
    - `reasoning` string, required
    - `signals` string[]

## Response `200`

Successful Zevari API response.

- ZevariResponseEnvelope
  - `ok` boolean, required: False when the underlying tool reports an error or a partial failure.
  - `method` string, required: Public API method name.
  - `data` unknown, required
  - `request_id` string, required: Request correlation ID. Also returned in X-Zevari-Request-Id.

## Other responses

- `400`: Invalid arguments or method execution error.
- `401`: Missing, invalid, expired, revoked, or unauthorized API key.
- `404`: Unknown or non-public Zevari API method.
- `429`: API key rate limit exceeded.
- `500`: Unhandled server error.

---

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