telnyx-porting-out-javascript_skill

Overview

This skill manages Telnyx port-out workflows in JavaScript. It lets you list and inspect port-out requests, view related comments and documents, update port-out status (authorize or reject), and handle port-out events and reports. Examples use the official Telnyx JavaScript SDK for quick integration.

How this skill works

The skill calls Telnyx port-out endpoints via the JavaScript SDK to fetch lists, retrieve single resources, and create or update related records. It supports paginated listing, creating comments and supporting documents, changing port-out status with a required reason, and generating or retrieving reports. Event endpoints let you list, retrieve, and republish port-out events for webhook replay or troubleshooting.

When to use it

• When customers request number portability away from your Telnyx account.
• When you need to audit or review pending and historical port-out requests.
• When you must authorize or reject a port-out with a specific reason.
• When collecting or attaching supporting documents and comments to a port-out.
• When generating reports or replaying port-out events for reconciliation.

Best practices

• Initialize the Telnyx client once and reuse it across requests to preserve connection and credentials.
• Always include a clear, auditable reason when calling update status (authorize/reject).
• Use SDK paginated iterators for listing to avoid manual pagination logic and reduce memory usage.
• Attach supporting documents and comments promptly to preserve context for audits and dispute resolution.
• Use event republishing and reports to diagnose missed webhooks or reconcile port-out states.

Example use cases

• Automate daily checks to list new port-out requests and notify operations or security teams.
• Attach customer-supplied ID documents to a port-out request before approving or rejecting.
• Programmatically reject port-outs with a predefined set of rejection codes and standardized reasons.
• Generate CSV exports of port-out activity for monthly compliance reports.
• Replay specific port-out events to test webhook handlers after a deployment.