Join BoxWorks 2024 to discover what's possible with content and AI!

Create jobs to terminate user group session

post

https://api.box.com/2.0

/groups/terminate_sessions

Validates the roles and permissions of the group, and creates asynchronous jobs to terminate the group's sessions. Returns the status for the POST request.

Request

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

Request Body

group_ids string arrayin bodyrequired

example["123456","456789"]

A list of group IDs

Response

202application/jsonSession termination message

Returns a message about the request status.

400application/jsonClient error

Returns an error if some of the parameters are not valid.

Groups can not be NULL or EMPTY when no value is provided
group id format is string when the provided group id format is incorrect
Supported payload format is JSON when the provided payload format is incorrect

403application/jsonClient error

Returns an error if there are insufficient permissions.

404application/jsonClient error

Returns an error if the resource could not be found.

429application/jsonClient error

Returns an error if the request limit is exceeded.

500application/jsonClient error

Returns an error if there is an internal server issue.

503application/jsonClient error

Returns an error if the request timed out.

defaultapplication/jsonClient error

An unexpected client error.

post

Create jobs to terminate user group session

You can now try out some of our APIs live, right here in the documentation.

Request Example

cURL

curl -i -X POST "https://api.box.com/2.0/groups/terminate_sessions" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -H "accept: application/json" \
     -d
    {
    "group_ids": ["6178859178", "4824866571"],
    }

TypeScript Gen

await client.sessionTermination.terminateGroupsSessions({
  groupIds: [group.id],
} satisfies TerminateGroupsSessionsRequestBody);

Python Gen

client.session_termination.terminate_groups_sessions([group.id])

.NET Gen

await client.SessionTermination.TerminateGroupsSessionsAsync(requestBody: new TerminateGroupsSessionsRequestBody(groupIds: Array.AsReadOnly(new [] {group.Id})));

Swift Gen (Beta)

try await client.sessionTermination.terminateGroupsSessions(requestBody: TerminateGroupsSessionsRequestBody(groupIds: [group.id]))

Node

var groupIDs = ['11111', '22222'];

client.groups.terminateSession(groupIDs)
	.then((result) => {
		/* result -> {
			message: 'Request is successful, please check the admin events for the status of the job'
		} */ 
	});

Response Example

{
  "message": "Request is successful, please check the admin\nevents for the status of the job"
}