2026.01.16-dev2026.01.16 DevSession Service

Get Session

GetSession retrieves details of a specific session.

Use this method to fetch the current state of a session identified by its resource name.

Request: GetSessionRequest Response: Session

HTTP: GET /v1/conversation/sessions/{name}

Path parameters

sessionstringRequired
The session id.

Response

OK
profilestring
The profile associated with the session.
displayNamestring

display_name is the title of the session.

sessionTypeinteger

session_type defines the type of the session, such as Public, Private, or Temporary.

ownerslist of strings
owners contains the list of owners of the session.
defaultChannelslist of integers

default_channels specifies the default channels for the session.

namestring

name is the resource identifier for the Session. It follows the format “sessions/{session}” and uniquely identifies a Session resource.

descriptionstring
description provides a brief overview of the session.
sessionIdstringRead-only
The unique identifier for the session, often sourced from a NATS subject or a dedicated ID.
allowedUserslist of strings

allowed_users contains the list of users allowed in the session.

optionsobject
options contains various options for the session.
secretKeystring

secret_key is the secret key for the session.

createTimedatetimeRead-only
Output only. The time at which the session was created.
updateTimedatetimeRead-only
Output only. The time at which the session was last updated.

Errors

400
Bad Request Error