API Reference version 2

Get session

GET/v2/oauth/token/{access_token}

Gets the OAuth session via its associated access_token

Path parameters

Type Parameter Description Required?
string access_token

The OAuth access_token

Required
200 application/json
Type Property Description Required?
array scopes

The scopes the session is authorized to use

Required
string name

A name used to identify this token.

May be null.

string access_token

The access token for the session

Required
integer expires_in

The number of seconds until the session expires

Required
object client

The OAuth client for this session

May be null.

object links

URLs to retrieve oauth client information

Required
string self

The URL to use to retrieve the full oauth client information

Required
object room

The room, if specified, that this client is restricted to.

May be null.

Required
string name

Name of the room.

Required
object links

URLs to retrieve room information

Required
string self

The URL to use to retrieve the full room information

Required
string webhooks

The URL to use to retrieve webhooks registered for this room

Required
string members

The URL to use to retrieve members for this room. Only available for private rooms. Note this link will be made available to public room from Dec 1, 2016

string participants

The URL to use to retrieve participants for this room

Required
string privacy

Privacy setting

Valid values: public, private.

Required
boolean is_archived

Whether or not this room is archived.

Required
string version

An etag-like random version string.

Required
integer id

ID of the room.

Required
string id

ID of the client.

Required
array allowed_scopes

List of possible scopes that are allowed for requested tokens

string name

The name of the client, if any

object owner

The user id that requested the session, if applicable.

May be null.

string mention_name

User's @mention name

Required
string version

An etag-like random version string.

Required
integer id

The user ID

Required
object links

URLs to retrieve user information

Required
string self

The link to use to retrieve the user information

Required
string name

The display user name

Required
string owner_type

The owner type of the session

Valid values: client, user.

integer id

The session ID

string refresh_token

The token to use to refresh this session.