Skip to main content
POST
Change who answers a conversation (handover)

Request contract

  • Method and path: POST /apis/v1/social/inbox/conversations/{conversationId}/thread-control
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/inbox/conversations/{conversationId}/thread-control
  • conversationId: path; required
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conversationId
string
required

The conversation ID

Body

application/json
accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
action
enum<string>
required

request is Facebook and Instagram only. take and request are refused with platform_not_supported on Instagram accounts connected with Instagram Login.

Available options:
release,
take,
pass,
request
metadata
string

Free-form note forwarded verbatim to the app receiving control (its messaging_handovers webhook).

Maximum string length: 2000
target
enum<string>

WhatsApp only. With action pass: send control to Meta Business Agent instead of the escalation partner.

Available options:
ai_agent
targetAppId
string

Facebook and Instagram only, required with action pass: the Meta app id receiving the thread.

Pattern: ^[0-9]+$

Response

Control transferred (or, for request, asked for)

control
object
success
boolean