Reply to an Inbox item
Sends an eligible public reply or legacy direct message. UniPost-managed X operations consume X Credits; workspace-owned X app operations use that app's X access and do not consume UniPost X Credits.
Authorization
AuthorizationBearer <token>In header
Workspace API key. Inbox requires the Basic plan or higher.
Idempotency-KeystringIn header
Required for x_reply and x_dm. Reuse the same key only for the exact same item and text.
Path Params
idstring
Inbound Inbox item ID.
Request Body
textstring
Non-empty public reply or private-message text.
Response Body
200
data.idstring
Persisted outbound Inbox item ID.
data.sourcestring
x_reply or x_dm for an X response.
data.is_ownboolean
true for the sent item.
data.x_credits_countedinteger
Weighted units charged. It is zero for workspace_x_app.
data.x_credit_operationstring
A URL-free X reply uses post.reply_summoned and costs 10 managed-X Credits. A reply containing a URL or domain-like candidate uses post.create_url and costs 200. A direct message uses dm.send and costs 15.
data.x_credit_billing_modestring
unipost_managed_app or workspace_x_app.
202
x_monthly_usage_limit_exceeded402
Managed-X allowance exhausted. Do not retry until capacity resets or changes.
x_reconnect_required409
Reconnect the account with the required X scopes.
idempotency_key_conflict409
The key was previously used with different text or a different item.
x_write_outcome_pending409
X may have accepted the write. Reuse the key to inspect state; UniPost does not resend it.
x_write_needs_reconciliation409
The outcome needs manual reconciliation; do not create another key to resend.
x_remote_accepted_reconciling202
X accepted the write and UniPost is finishing local persistence.
402
x_monthly_usage_limit_exceeded402
Managed-X allowance exhausted. Do not retry until capacity resets or changes.
x_reconnect_required409
Reconnect the account with the required X scopes.
idempotency_key_conflict409
The key was previously used with different text or a different item.
x_write_outcome_pending409
X may have accepted the write. Reuse the key to inspect state; UniPost does not resend it.
x_write_needs_reconciliation409
The outcome needs manual reconciliation; do not create another key to resend.
x_remote_accepted_reconciling202
X accepted the write and UniPost is finishing local persistence.
409
x_monthly_usage_limit_exceeded402
Managed-X allowance exhausted. Do not retry until capacity resets or changes.
x_reconnect_required409
Reconnect the account with the required X scopes.
idempotency_key_conflict409
The key was previously used with different text or a different item.
x_write_outcome_pending409
X may have accepted the write. Reuse the key to inspect state; UniPost does not resend it.
x_write_needs_reconciliation409
The outcome needs manual reconciliation; do not create another key to resend.
x_remote_accepted_reconciling202
X accepted the write and UniPost is finishing local persistence.