---
title: "Connect Session"
method: GET
path: "/api/connections/connect/session"
tags: ["Connections"]
---

# Connect Session

`GET /api/connections/connect/session`

Returns trusted metadata for the authenticated Polytomic Connect session.

Returns the trusted metadata stored for a Polytomic Connect session. Authenticate with the opaque Connect token in the `token` query parameter.

The response includes the server-enforced connection name, fixed type or whitelist, bound connection ID, completion redirect, branding, and absolute expiration time.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- ConnectSessionResponseEnvelope
  - `data` ConnectSessionResponse
    - `connection_id` string, uuid, nullable — Existing or newly-created connection bound to this session.
    - `dark` boolean — Whether the Connect modal uses the dark theme.
    - `expires_at` string, date-time — Absolute time when the Connect session expires.
    - `logo` string — Trusted logo URL displayed by the Connect modal.
    - `name` string — Trusted connection name for this session.
    - `organization_name` string — Trusted organization or partner name displayed by the Connect modal.
    - `redirect_url` string — URL to redirect to after the Connect flow finishes.
    - `type` string — Fixed connection type for this session, if any.
    - `whitelist` string[], nullable — Connection types allowed for this session when type is empty.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/revisions/31d9a913d396/schema)