Messaging and calls

curl 'https://api.vxcloud.io/api/v1/messaging/attachments/{attachment_id}/file' \
  -H "Authorization: Bearer $SS_TOKEN"

curl 'https://api.vxcloud.io/api/v1/messaging/bookmarks' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "bookmarks": [
    "<empty list>"
  ]
}

curl 'https://api.vxcloud.io/api/v1/messaging/calls/{call_id}/intelligence' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "call_id": "…",
  "duration_seconds": "…",
  "mode": "…",
  "recorded": "…",
  "recording": "…",
  "room_id": "…",
  "room_name": "…",
  "transcript": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/calls/{call_id}/recording/chunks' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "upload_id": "<string>", "chunk_index": 0, "chunk": "<string>" }'

{
  "bytes_received": "…",
  "chunk_index": "…",
  "duplicate": "…",
  "upload_id": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/calls/{call_id}/recording/finalize' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "upload_id": "<string>", "mime": "audio/webm", "duration_seconds": 0, "consent_acks": [ "<object>" ] }'

{
  "bytes": "…",
  "call_id": "…",
  "consent_shown_to": "…",
  "duration_seconds": "…",
  "mime": "…",
  "recording_id": "…",
  "room_id": "…",
  "transcript_status": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/calls/{call_id}/recordings/{recording_id}/file' \
  -H "Authorization: Bearer $SS_TOKEN"

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/calls/{call_id}/transcribe' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "call_id": "…",
  "recording_id": "…",
  "status": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/calls/active' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "calls": [
    "<empty list>"
  ],
  "count": "int"
}

curl 'https://api.vxcloud.io/api/v1/messaging/chat-invitations/{token}'

{
  "display_name": "…",
  "email": "…",
  "expired": "…",
  "expires_at": "…",
  "invited_by": "…",
  "message": "…",
  "organization_name": "…",
  "room_name": "…",
  "status": "…",
  "token": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/chat-invitations/{token}/accept' \
  -H 'Content-Type: application/json' \
  -d '{ "display_name": "<string>", "password": "<string>" }'

{
  "access": "…",
  "display_name": "…",
  "email": "…",
  "refresh": "…",
  "room_id": "…",
  "room_name": "…",
  "user_id": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/chat-invitations/{token}/decline'

{
  "status": "…"
}

curl -X DELETE 'https://api.vxcloud.io/api/v1/messaging/guest-invitations/{invitation_id}' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "id": "…",
  "status": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/health'

{
  "status": "str",
  "services": {
    "database": "str",
    "redis": "str",
    "celery": {
      "reachable": "bool",
      "workers": "int"
    },
    "kafka": {
      "enabled": "bool",
      "available": "bool",
      "topic": "null"
    },
    "outbox": {
      "processor_running": "bool",
      "pending": "int",
      "failed": "int"
    }
  },
  "active_connections": "int",
  "timestamp": "str"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/hooks/{token}' \
  -H 'Content-Type: application/json' \
  -d '{ "text": "<string>", "username": "<string>" }'

{
  "message_id": "…",
  "ok": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/invitations' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "invitations": [
    "<empty list>"
  ]
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/invitations/{invitation_id}/respond?accept=<boolean>' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "id": "…",
  "room_id": "…",
  "status": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/mentions' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "mentions": [
    {
      "id": "str",
      "is_read": "bool",
      "message_id": "str",
      "room_id": "str",
      "room_name": "str",
      "sender_id": "int",
      "content": "str",
      "created_at": "str"
    },
    "...x2"
  ]
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/mentions/read' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "message_ids": [ "<string>" ] }'

{
  "updated": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/messages/{message_id}/ack' \
  -H "Authorization: Bearer $SS_TOKEN"

curl 'https://api.vxcloud.io/api/v1/messaging/messages/{message_id}/acks' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "acks": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/messages/{message_id}/bookmark' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "note": "<string>", "tags": [ "<string>" ] }'

{
  "message_id": "…",
  "saved": "…"
}

curl -X DELETE 'https://api.vxcloud.io/api/v1/messaging/messages/{message_id}/bookmark' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "message_id": "…",
  "saved": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/polls/{poll_id}/vote' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "option_ids": [ "<string>" ] }'

curl 'https://api.vxcloud.io/api/v1/messaging/rooms' \
  -H "Authorization: Bearer $SS_TOKEN"

[
  {
    "id": "str",
    "name": "str",
    "description": "str",
    "room_type": "str",
    "is_active": "bool",
    "is_public": "bool",
    "is_global": "bool",
    "created_at": "str",
    "updated_at": "str",
    "last_activity": "str",
    "settings": "null",
    "max_participants": "int",
    "created_by_id": "int",
    "participant_count": "int",
    "participant_ids": [
      "str",
      "...x2"
    ],
    "other_user_id": "str",
    "my_settings": {
      "is_muted": "bool",
      "is_favorite": "bool",
      "added_to_list": "str"
    },
    "other_user": {
      "id": "str",
      "name": "str",
      "username": "str",
      "email": "str",
      "role": "str",
      "avatar": "null",
      "avatar_color": "str",
      "organization_id": "str",
      "status": "str",
      "last_seen": "str"
    }
  },
  "...x19"
]

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "name": "<string>", "type": "private", "description": "<string>", "participant_user_ids": [ "<string>" ], "is_global": false }'

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}' \
  -H "Authorization: Bearer $SS_TOKEN"

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/ai' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "<string>", "mode": "ask" }'

{
  "mode": "…",
  "queued": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/attachments' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "file": "<string>", "caption": "" }'

{
  "attachments": "…",
  "content": "…",
  "created_at": "…",
  "id": "…",
  "is_deleted": "…",
  "is_edited": "…",
  "is_pinned": "…",
  "message_type": "…",
  "room_id": "…",
  "sender_id": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/call' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "active": "…",
  "call": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/calls' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "calls": "…",
  "count": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/guest-invitations' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "invitations": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/guest-invitations' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "contact_id": "<string>", "email": "<string>", "name": "<string>", "message": "<string>", "sender_email": "<string>" }'

{
  "detail": "…",
  "display_name": "…",
  "email": "…",
  "email_error": "…",
  "email_sent": "…",
  "expires_at": "…",
  "guest_user_id": "…",
  "id": "…",
  "invite_endpoint": "…",
  "invite_url": "…",
  "mode": "…",
  "room_id": "…",
  "status": "…",
  "user_id": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/invitations' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "invited_user_id": 0, "role": "member", "message": "<string>" }'

{
  "id": "…",
  "invited_user_id": "…",
  "room_id": "…",
  "status": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/join' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "message": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/leave' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "message": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages' \
  -H "Authorization: Bearer $SS_TOKEN"

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "content": "<string>", "message_type": "text", "reply_to": "<string>", "thread_root": "<string>", "attachments": [ "<object>" ], "metadata": {} }'

{
  "attachments": "…",
  "content": "…",
  "created_at": "…",
  "id": "…",
  "is_deleted": "…",
  "is_edited": "…",
  "is_pinned": "…",
  "message_type": "…",
  "room_id": "…",
  "sender_id": "…"
}

curl -X PUT 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/{message_id}' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "content": "<string>" }'

{
  "content": "…",
  "edited_at": "…",
  "id": "…",
  "is_edited": "…"
}

curl -X DELETE 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/{message_id}' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "id": "…",
  "is_deleted": "…",
  "room_id": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/{message_id}/forward' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "target_room_ids": [ "<string>" ] }'

{
  "count": "…",
  "forwarded": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/{message_id}/pin' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "pinned": true }'

{
  "id": "…",
  "is_pinned": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/{root_id}/thread' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "messages": "…",
  "root_id": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/messages/search?q=<string>' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "query": "…",
  "results": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/pins' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "pins": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/polls' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "polls": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/polls' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "question": "<string>", "options": [ "<string>" ], "allows_multiple": false }'

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/read' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "marked": "…",
  "room_id": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/scheduled' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "content": "<string>", "scheduled_for": "<string>", "message_type": "text", "recurrence": {} }'

{
  "content": "…",
  "id": "…",
  "is_recurring": "…",
  "room_id": "…",
  "scheduled_for": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/settings' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "room_id": "…",
  "settings": "…"
}

curl -X PUT 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/settings' \
  -H "Authorization: Bearer $SS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "is_muted": false, "is_favorite": false, "is_blocked": false, "is_reported": false, "is_archived": false, "disappearing_messages": "<string>", "added_to_list": "<string>", "cleared_at": "<string>" }'

{
  "room_id": "…",
  "settings": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/users' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "count": "…",
  "users": "…"
}

curl -X POST 'https://api.vxcloud.io/api/v1/messaging/rooms/{room_id}/webhook' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "note": "…",
  "room_id": "…",
  "webhook_path": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rooms/discover' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "rooms": [
    {
      "id": "str",
      "name": "str",
      "description": "str",
      "room_type": "str",
      "is_active": "bool",
      "is_public": "bool",
      "is_global": "bool",
      "created_at": "str",
      "updated_at": "str",
      "last_activity": "str",
      "created_by_id": "int",
      "participant_count": "int"
    },
    "...x1"
  ],
  "count": "int"
}

curl 'https://api.vxcloud.io/api/v1/messaging/rtc/ice' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "ice_servers": [
    {
      "urls": [
        "...",
        "...x1"
      ]
    },
    "...x1"
  ],
  "max_mesh": {
    "audio": "int",
    "video": "int"
  },
  "turn_configured": "bool",
  "ring_timeout_seconds": "int",
  "ring_fanout_max": "int",
  "warning": "str"
}

curl 'https://api.vxcloud.io/api/v1/messaging/scheduled' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "scheduled": [
    "<empty list>"
  ]
}

curl -X DELETE 'https://api.vxcloud.io/api/v1/messaging/scheduled/{scheduled_id}' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "cancelled": "…"
}

curl 'https://api.vxcloud.io/api/v1/messaging/users' \
  -H "Authorization: Bearer $SS_TOKEN"

{
  "users": [
    {
      "id": "str",
      "name": "str",
      "username": "str",
      "email": "str",
      "role": "str",
      "avatar": "null",
      "avatar_color": "str",
      "organization_id": "str",
      "status": "str",
      "last_seen": "str"
    },
    "...x4"
  ],
  "count": "int"
}