Sessions

Used to interact with the sessions of a client.

Remove client's sessions

Removes all the sessions of the current client without removing the __client cookie

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Responses
200

Returns the response for DELETE session object.

401

Request was not successful

404

Request was not successful

delete/v1/client/sessions
Response samples
application/json
{
  • "response": {
    },
  • "client": { }
}

Get Session

Returns the session with the given id

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

the user session id.

Responses
200

Returns a Session object.

404

Request was not successful

get/v1/client/sessions/{session_id}
Response samples
application/json
{
  • "response": {
    },
  • "client": {
    }
}

Touch session

Specify the active session for the client.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

the user session id.

Request Body schema: application/x-www-form-urlencoded
active_organization_id
string or null

The ID or slug of the organization to activate.

Responses
200

Returns a Session object.

400

Request was not successful

401

Request was not successful

403

Request was not successful

404

Request was not successful

422

Request was not successful

post/v1/client/sessions/{session_id}/touch
Request samples
application/x-www-form-urlencoded
active_organization_id=string
Response samples
application/json
{
  • "response": {
    },
  • "client": {
    }
}

End Session

Marks the given session as ended.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

the user session id.

Responses
200

Returns a Session object.

400

Request was not successful

404

Request was not successful

post/v1/client/sessions/{session_id}/end
Response samples
application/json
{
  • "response": {
    },
  • "client": {
    }
}

Remove Session

Delete the the given session.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

the user session id.

Responses
200

Returns a Session object.

400

Request was not successful

404

Request was not successful

post/v1/client/sessions/{session_id}/remove
Response samples
application/json
{
  • "response": {
    },
  • "client": {
    }
}

Create Session Token

Create a session jwt for the authenticated requested user.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

The user session id.

Request Body schema: application/x-www-form-urlencoded
organization_id
string or null

The organization id to associate with the token. The user must be a member of the organization. If present but empty, the personal workspace will be set as active. If absent, the previous active organization for the session will be used.

Responses
200

OK

401

Request was not successful

404

Request was not successful

post/v1/client/sessions/{session_id}/tokens
Request samples
application/x-www-form-urlencoded
organization_id=string
Response samples
application/json
{
  • "jwt": "string"
}

Create Session Token With JWT Template

Create a session jwt for the authenticated requested user.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)
Request
path Parameters
session_id
required
string

the user session id.

template_name
required
string

the template name

Responses
200

OK

post/v1/client/sessions/{session_id}/tokens/{template_name}
Response samples
application/json
{
  • "jwt": "string"
}