Skip to content

Conversation

@AAnkudovich
Copy link
Contributor

Add Calls API endpoints and schemas

  • Introduces Calls endpoints:
    • GET /calls (pagination via page and per_page, default 25, max 25)
    • GET /calls/{id}
    • GET /calls/{id}/recording (302 redirect to signed URL; 404 if not available)
    • GET /calls/{id}/transcript (returns [{}] when no transcript; 404 if call does not exist)
  • Adds call and call_list schemas
    • Fields aligned with Api::V3::Calls::Presenters::CallResponse (e.g., id, type=call, conversation_id, admin_id, contact_id, state, timestamps, recording_url, call_type, direction, ended_reason, phone, fin_recording_url, fin_transcription_url)
  • Tags endpoints under Calls
  • Example responses aligned with controller behavior in Api::V3::CallsController (pagination defaults and limits, 302 redirect for recording, [{}] no-transcript behavior)

Generated with Cursor

@davymalone
Copy link
Contributor

This looks good to me, just one thing @AAnkudovich I think we should document the calls/search action as well.

@AAnkudovich AAnkudovich force-pushed the aankudovich/calls-api-documentation branch from a558dfa to cf662bb Compare August 11, 2025 15:53
Copy link
Contributor

@davymalone davymalone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚢

@marcmlc marcmlc merged commit a688e52 into main Aug 13, 2025
6 checks passed
@marcmlc marcmlc deleted the aankudovich/calls-api-documentation branch August 13, 2025 10:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants