okta-sdk-nodejs

okta.SessionApi

All URIs are relative to https://subdomain.okta.com

Method	HTTP request	Description
createSession	POST /api/v1/sessions	Create a Session with Session Token
endSession	DELETE /api/v1/sessions/{sessionId}	Delete a Session
getSession	GET /api/v1/sessions/{sessionId}	Retrieve a Session
refreshSession	POST /api/v1/sessions/{sessionId}/lifecycle/refresh	Refresh a Session

createSession

Session createSession(createSessionRequest)

Creates a new session for a user with a valid session token. Use this API if, for example, you want to set the session cookie yourself instead of allowing Okta to set it, or want to hold the session ID in order to delete a session via the API instead of visiting the logout URL.

Example

import { okta } from '@okta/okta-sdk-nodejs';
import * as fs from 'fs';

const configuration = okta.createConfiguration();
const apiInstance = new okta.SessionApi(configuration);

let body:okta.SessionApiCreateSessionRequest = {
  // CreateSessionRequest
  createSessionRequest: {
    sessionToken: "sessionToken_example",
  },
};

apiInstance.createSession(body).then((data:any) => {
  console.log('API called successfully. Returned data: ' + data);
}).catch((error:any) => console.error(error));

Parameters

Name	Type	Description	Notes
createSessionRequest	CreateSessionRequest

Return type

Session

Authorization

API_Token

HTTP request headers

• Content-Type: application/json
• Accept: application/json

HTTP response details

| Status code | Description | Response headers | |————-|————-|——————| 200 | Success | - | 400 | Bad Request | - | 403 | Forbidden | - | 429 | Too Many Requests | - |

[Back to top] [Back to API list] [Back to Model list] [Back to README]

endSession

void endSession()

End a session.

Example

import { okta } from '@okta/okta-sdk-nodejs';
import * as fs from 'fs';

const configuration = okta.createConfiguration();
const apiInstance = new okta.SessionApi(configuration);

let body:okta.SessionApiEndSessionRequest = {
  // string
  sessionId: "sessionId_example",
};

apiInstance.endSession(body).then((data:any) => {
  console.log('API called successfully. Returned data: ' + data);
}).catch((error:any) => console.error(error));

Parameters

Name	Type	Description	Notes
sessionId	[string]		defaults to undefined

Return type

void

Authorization

API_Token, OAuth_2.0

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

| Status code | Description | Response headers | |————-|————-|——————| 204 | No Content | - | 403 | Forbidden | - | 404 | Not Found | - | 429 | Too Many Requests | - |

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getSession

Session getSession()

Get details about a session.

Example

import { okta } from '@okta/okta-sdk-nodejs';
import * as fs from 'fs';

const configuration = okta.createConfiguration();
const apiInstance = new okta.SessionApi(configuration);

let body:okta.SessionApiGetSessionRequest = {
  // string
  sessionId: "sessionId_example",
};

apiInstance.getSession(body).then((data:any) => {
  console.log('API called successfully. Returned data: ' + data);
}).catch((error:any) => console.error(error));

Parameters

Name	Type	Description	Notes
sessionId	[string]		defaults to undefined

Return type

Session

Authorization

API_Token, OAuth_2.0

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

| Status code | Description | Response headers | |————-|————-|——————| 200 | Success | - | 400 | Bad Request | - | 403 | Forbidden | - | 404 | Not Found | - | 429 | Too Many Requests | - |

[Back to top] [Back to API list] [Back to Model list] [Back to README]

refreshSession

Session refreshSession()

Refresh a session.

Example

import { okta } from '@okta/okta-sdk-nodejs';
import * as fs from 'fs';

const configuration = okta.createConfiguration();
const apiInstance = new okta.SessionApi(configuration);

let body:okta.SessionApiRefreshSessionRequest = {
  // string
  sessionId: "sessionId_example",
};

apiInstance.refreshSession(body).then((data:any) => {
  console.log('API called successfully. Returned data: ' + data);
}).catch((error:any) => console.error(error));

Parameters

Name	Type	Description	Notes
sessionId	[string]		defaults to undefined

Return type

Session

Authorization

API_Token, OAuth_2.0

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

HTTP response details

| Status code | Description | Response headers | |————-|————-|——————| 200 | Success | - | 403 | Forbidden | - | 404 | Not Found | - | 429 | Too Many Requests | - |

[Back to top] [Back to API list] [Back to Model list] [Back to README]

This site is open source. Improve this page.