Move Call to Another Group

Moves a call from one organizational unit (group) to another within the same account. This is useful for correcting misrouted calls or reorganizing call data.

Behavior:

Both source and target organizational units must be within the same account (validated via billing_id)

If the target group has a provisioned route (call flow) with the same tracking number, the call will be associated with it

If no matching route exists in the target group, a "dummy route" is created automatically:

Copies the source route configuration (name, type, channel)

Creates or reuses a campaign with the same name in the target group

Sets route and call flow status to "deleted" (preserves call history without making it active)

Updates campaign component count when creating a new campaign

Component counts are updated automatically:

Call count (component_id=5) incremented in target group, decremented in source group

Minute count (based on usage_component_id) transferred from source to target

Only applies to calls with call_detail records where cdr_source ≠ "API"

The call retains its original timestamp, recordings, tags, and notes

The updated_at timestamp is set to the current time

Transaction Handling:

The entire move operation is atomic — all updates succeed or all are rolled back

Ensures data consistency across call, route, campaign, and component count tables

Authorization:
User must have access to both the source and target organizational units.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://platform-api.convirza.com/v3/conversations/calls/move' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "call_id": 123456, "org_unit_id": 2001 }'

{ "code": 200, "message": "Success", "data": { "message": "Call moved successfully", "call_id": 123456, "source_org_unit_id": 1001, "target_org_unit_id": 2001 }, "request_id": "550e8400-e29b-41d4-a716-446655440000", "timestamp": "2026-01-20T12:34:56.789Z" }

Move Call to Another Group

Request

Responses