Get public connector (legacy path)

GET 
/v2/agent_aliases/:alias_key/connectors/:connector_id

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Deprecated: read the public view from GET /v2/agent_aliases/{alias_key}/connectors/{connector_id}/public. This path serves the same view while embeds already deployed move to that path; it is then repurposed as the authenticated operator read of the full connector.

The public view of a connector, served unauthenticated to the embed snippet. The snippet carries the alias key and the connector's globally unique id, which expose no agent or customer identifier. Returns the customer_id visitor minting is addressed to, the presentation to render, whether anonymous visitors are admitted (public_access), and the sign-in configuration when the widget offers one.

A read with no side effects: minting an anonymous visitor id is a separate call, POST /v2/visitors, so a returning visitor who already holds an id only reads this view. The view tells the client how to authenticate: public_access true — mint or present a visitor id; end_user_sign_in present — sign the user in through the referenced issuer. A widget may offer both, and the two follow-up calls do not depend on each other.

This operation serves only the public projection; operators read the full connector, configuration included, from the connector list.

Serves connectors that front an end-user surface — today, widget connectors. Returns 404 if the connector does not exist on the addressed alias, is a channel connector with no end-user surface (Slack, Google Chat, or Zoom), is disabled, or belongs to a disabled customer.

Request

Responses

200

The connector's public view.

403

The request Origin is not in the connector's allowed_origins.

404

The connector does not exist on the addressed alias, does not front an end-user surface, is disabled, or belongs to a disabled customer.