> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /handles/{handleId}/session

> /handles/{handleId}/session

Supports PUT and GET operations for a session, using handle dereferencing.

> **Note:**\
> This URI is used by 2015 Multiplayer and applies only to that multiplayer version and later. It is intended for use with template contract 104/105 or later.

> **Note:**\
> This URI is currently only externally accessible by XBOX One consoles and servers using a service identifier.

## Domain

sessiondirectory.xboxlive.com

## URI parameters

\| Parameter| Type| Description|
\| --- | --- | --- | --- | --- |
\| handleId| GUID| The unique ID of the handle for the session.|

## Valid methods

[GET (/handles/{handleId}/session)](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget.md)

  Gets a session object for the specified handle identifier.

[PUT (/handles/{handle-id}/session)](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput.md)

  Creates or updates a session by dereferencing a handle.

## See also

##### Parent

[Session Directory URIs](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory.md)


## Related topics

- [GET (/handles/{handleId}/session)](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget.md)
- [XblMultiplayerGetSessionByHandleAsync](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [/handles/{handleId}](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleid.md)
- [DELETE (/handles/{handleId})](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleiddelete.md)
- [PUT (/handles/{handle-id}/session)](https://docs.xbox.com/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput.md)