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

# /handles/{handleId}/session

> /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.

<a id="ID4ES" />

## Domain

sessiondirectory.xboxlive.com

<a id="ID4EX" />

## URI parameters

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

<a id="ID4ESB" />

## Valid methods

[GET (/handles/{handleId}/session)](/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget)

  Gets a session object for the specified handle identifier.

[PUT (/handles/{handle-id}/session)](/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput)

  Creates or updates a session by dereferencing a handle.

<a id="ID4E6B" />

## See also

<a id="ID4EBC" />

##### Parent

[Session Directory URIs](/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory)


## Related topics

- [XblMultiplayerGetSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerSessionHandleId](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionhandleid.md)
- [XblMultiplayerSetTransferHandleResult](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersettransferhandleresult.md)
- [XblMultiplayerDeleteSearchHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)