> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # Advance a sequential ring group to the next endpoint > Internal jambonz `dial` action-hook for a sequential ring group. When the endpoint currently being rung does not answer, this hook advances to the next endpoint in the configured sequence and returns the verbs to dial it; when the sequence is exhausted it returns the route's fallback verbs (voicemail or a polite hangup). If the leg was answered it clears the sequential state and returns an empty array. Signed with the jambonz webhook HMAC and not intended for direct client use. Fails OPEN with safe-default verbs on a Redis flap so a live caller is never dropped. ## OpenAPI ````yaml /openapi.yaml post /api/v1/jambonz/lookup-next openapi: 3.1.0 info: title: Devotel CPaaS API description: Orbit by Devotel — Communications Platform as a Service API version: 1.0.0 contact: name: Devotel url: https://devotel.io email: support@devotel.io license: name: Proprietary servers: - url: https://api.orbit.devotel.io description: Production security: - Bearer: [] - ApiKey: [] tags: - name: Messages description: >- Send and manage messages across all channels (SMS, WhatsApp, RCS, Email, Viber, etc.) - name: Fax description: >- List and track fax (MMS/T.38) transmissions on Telnyx-backed fax numbers (sending flows through the Messaging API) - name: Agents description: AI agent creation, configuration, and execution - name: Voice description: Voice calls, IVR, conferencing, and SIP trunking - name: OnCall description: On-call rotations and escalation policy planning for incident alerting - name: Webhooks description: Webhook endpoint management and delivery logs - name: Numbers description: Phone number search, provisioning, and configuration - name: Brand Identity description: >- Unified cross-channel brand trust posture (10DLC, toll-free, WhatsApp, RCS, branded calling, number KYC) - name: Contacts description: Contact management, segmentation, and lifecycle tracking - name: Campaigns description: Marketing campaign orchestration and analytics - name: Flows description: Automation flow builder and execution engine - name: Templates description: Message template management and approval workflows - name: Settings description: Organization, channel, and user preference settings - name: Verify description: OTP generation and verification across channels - name: Push description: Push notification delivery via FCM and APNs - name: Integrations description: Third-party service connections and OAuth management - name: CDP description: >- Customer Data Platform — activation surface (CRM object sync, streaming destinations, ad-audience activation) - name: Files description: >- Server-to-server media upload, listing, retrieval, and deletion (signed-URL backed) - name: Commerce description: >- Omnichannel conversational-commerce — persistent cart + checkout state machine, channel-agnostic hosted pay-by-link, native WhatsApp checkout, and AP2-style agent payment mandates. - name: Sync description: >- Real-time shared-state primitive (Twilio Sync parity) — Documents, Maps, Lists, and ephemeral Streams, with change events relayed over the /api/v1/ws/sync WebSocket gateway - name: Risk description: >- Unified cross-channel Trust & Fraud risk scoring — fuses SMS-pumping, URL-reputation, Verify Fraud Guard, and Voice Biometrics signals into one composite verdict queryable before a send or a call. - name: Orby description: >- In-dashboard Orby operator assistant: streamed assistant turns, conversation threads, product knowledge-base search, and the tool-action approval gate. Available to signed-in operators only (dashboard session auth — API-key requests are rejected). paths: /api/v1/jambonz/lookup-next: post: summary: Advance a sequential ring group to the next endpoint description: >- Internal jambonz `dial` action-hook for a sequential ring group. When the endpoint currently being rung does not answer, this hook advances to the next endpoint in the configured sequence and returns the verbs to dial it; when the sequence is exhausted it returns the route's fallback verbs (voicemail or a polite hangup). If the leg was answered it clears the sequential state and returns an empty array. Signed with the jambonz webhook HMAC and not intended for direct client use. Fails OPEN with safe-default verbs on a Redis flap so a live caller is never dropped. parameters: - in: query name: callSid description: jambonz call SID (also accepted in the body as `call_sid`). schema: type: string - in: query name: routeId description: Inbound route id whose sequential ring group is being walked. schema: type: string - in: query name: idx description: Zero-based index of the endpoint that was just attempted. schema: type: string requestBody: content: application/json: schema: type: object properties: call_sid: type: string description: jambonz call SID of the parent leg. dial_call_status: type: string description: >- Outcome of the endpoint just rung (`completed`, `no-answer`, `busy`, `failed`). dial_sip_status: type: integer description: Final SIP response code of the attempted endpoint. example: call_sid: 5f9c3b1a-2d4e-4f6a-8b0c-1e2d3f4a5b6c dial_call_status: no-answer dial_sip_status: 480 responses: '200': description: >- The jambonz verbs to dial the next endpoint in the sequence, the route's fallback verbs when the sequence is exhausted, or an empty array when the call was already answered. content: application/json: schema: type: array description: jambonz verb array. items: type: object properties: verb: type: string example: - verb: dial target: - type: user name: bob-desk components: securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: Dashboard JWT token from Clerk ApiKey: type: apiKey name: X-API-Key in: header description: Server-to-server API key (dv_live_sk_*) ````