Skip to content

feat: add internal flag to Endpoint create params (VT-9534) - #317

Closed
revanth-plivo wants to merge 2 commits into
masterfrom
VT-9534-add-internal-endpoint-flag
Closed

feat: add internal flag to Endpoint create params (VT-9534)#317
revanth-plivo wants to merge 2 commits into
masterfrom
VT-9534-add-internal-endpoint-flag

Conversation

@revanth-plivo

Copy link
Copy Markdown

Summary

Adds an optional internal argument to the Endpoint create method so callers can mark newly created SIP endpoints as internal at creation time.

Why

Plivo CX (Contacto) auto-creates a SIP endpoint per AOM during user invite for browser-SDK playback. These internal endpoints currently leak into the customer's Endpoints tab in the console (Pylon #2460), causing confusion, prod alerts, and a security concern. The trace service already supports an internal column on the endpoint model + defaults the List API to exclude internal endpoints. What's missing is the ability for the auto-create call (Hodor) to actually mark endpoints as internal=true at creation time. This SDK change unblocks that.

Change

  • plivo/resources/endpoints.py — added optional internal kwarg to Endpoints.create, forwarded to the request body when set (serialized as JSON key internal).
  • setup.py, plivo/version.py, CHANGELOG.md — patch version bump (4.61.0 -> 4.61.1).

Backwards-compatibility

When internal is unset (default None), to_param_dict drops it and the wire payload is unchanged. Only callers that explicitly set internal=True opt into the new path.

Test plan

  • python -m py_compile plivo/resources/endpoints.py clean
  • End-to-end sanity: hit api.plivo.com create endpoint with internal=true and verify subscriber.internal = true on the row (validated separately by the CX team's integration)

Related

Adds an optional internal kwarg to Endpoints.create so callers can
mark newly created SIP endpoints as internal at creation time. Enables
Plivo CX (Contacto) to flag auto-created browser-SDK endpoints so the
Endpoint listing API's existing internal filter can hide them from
customer consoles.

Backwards-compatible: internal defaults to None and is dropped by
to_param_dict, so existing callers see identical wire behavior. Only
callers that explicitly pass internal=True opt into the new path.
@revanth-plivo
revanth-plivo force-pushed the VT-9534-add-internal-endpoint-flag branch from 2637abe to 62a0d81 Compare July 27, 2026 12:32
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.

1 participant