---
title: "Changes to Create REST API session"
method: POST
path: "/sessions"
---

# Changes to Create REST API session

`POST /sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 16 revisions.

- **2026-01-30** `32f48ec94aec`: 7 info
- **2023-02-28** `910d3ad08e09`: 2 info
- **2023-02-23** `9c09a2aad349`: 1 breaking, 4 warning, 3 info

## Changes

- **2026-01-30** `32f48ec94aec`: 7 info
  - added the new optional request property `attachNotificationHandler`
  - request body became optional
  - added the non-success response with the status `400`
  - added the optional property `description` to the response with the `401` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `session` to the response with the `200` status
  - added the optional property `sessionHandle` to the response with the `200` status
- **2023-02-28** `910d3ad08e09`: 2 info
  - api operation id `createSession` was added
  - added the non-success response with the status `401`
- **2023-02-23** `9c09a2aad349`: 1 breaking, 4 warning, 3 info
  - request body became required
  - the optional response header `Session-Id` removed for the status `200`
  - removed the request property `attachNotificationHandler`
  - removed the optional property `session` from the response with the `200` status
  - removed the optional property `sessionHandle` from the response with the `200` status
  - api operation id `createSession` removed and replaced with ``
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`

---

[Operation](https://skmtc.dev/netxms/apis/netxms-rest-api/docs/sessions/post.md) - [API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) - [Page](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/sessions/post)