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

# POST (/handles)

> POST (/handles)

# POST (/handles)

Define a sessão multijogador da atividade atual do usuário e convida membros da sessão, se necessário.

> **Importante:**\
> Este método é usado pelo Multiplayer 2015 e se aplica somente a essa versão multijogador e posteriores. Ele se destina ao uso com o contrato de modelo 104/105 ou posterior e requer um elemento de cabeçalho X-Xbl-Contract-Version: 104/105 ou posterior em todas as solicitações.

* [Comentários](#ID4ET)
* [Parâmetros de URI](#ID4EHB)
* [Códigos de status HTTP](#ID4EPB)
* [Corpo da solicitação](#ID4EVB)
* [Corpo da resposta](#ID4EJC)

<a id="ID4ET" />

## Comentários

Este método HTTP/REST pode ser usado para definir a sessão da atividade atual. Nesse caso, o método pode ser encapsulado por **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync**. O corpo da solicitação deve definir a referência da sessão, usando o objeto **sessionRef** no arquivo JSON, com o campo type definido como "activity". Nenhum corpo de resposta é recuperado. Para obter as definições dos itens especificados em uma referência de sessão, consulte **Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference**.

Este método POST também pode ser usado para convidar para uma sessão os usuários especificados pelos identificadores. Nesse caso, o método pode ser encapsulado por **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync**. Esse uso do método POST exige que o corpo da solicitação defina a referência da sessão, mas com o campo type definido como "invite". O corpo da resposta é um identificador de convite.

<a id="ID4EHB" />

## Parâmetros de URI

Nenhum

<a id="ID4EPB" />

## Códigos de status HTTP

O serviço retorna um código de status HTTP conforme aplicável ao MPSD.

<a id="ID4EVB" />

## Corpo da solicitação

<a id="ID4E1B" />

### Corpo da solicitação para definir a atividade

```cpp theme={null}
{
  "version": 1,
  "type": "activity",
  "sessionRef": {
    "scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
    "templateName": "deathmatch",
    // The session name is optional in a POST; if not specified, MPSD fills in a GUID.//
    "name": "session-49"
  },
}

```

<a id="ID4EBC" />

### Corpo da solicitação para enviar convites

```cpp theme={null}
{
  // Common handle fields
  "id: "47ca0049-a5ba-4bc1-aa22-fcf834ce4c13",
  "version": 1,
  "type": "invite",
  "sessionRef": {
    "scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
    "templateName": "deathmatch",
    "name": "session-49"
   },
   "inviteAttributes": {
     "titleId" : {titleId}, // The title being invited to, in decimal uint32. This value is used to find the title name and/or image.
     "context" : {context}, // The title defined context token. Must be 256 characters or less when URI-encoded.
     "contextString" : {contextstring}, // The string name of a custom invite string to display in the invite notification.
     "senderString" : {sender} // The string name of the sender when the sender is a service.
   },
   "invitedXuid": "3210",
}

```

<a id="ID4EJC" />

## Corpo da resposta

<a id="ID4EOC" />

### Corpo da resposta para definir a atividade

Nenhum.

<a id="ID4ESC" />

### Corpo da resposta para enviar convites

Um identificador de convite.

<a id="ID4EXC" />

## Confira também

<a id="ID4EZC" />

##### Pai

[/handles](/pt-BR/reference/live/rest/uri/sessiondirectory/uri-handles)


## Related topics

- [PFLobbyPostUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbypostupdate.md)
- [PFLobbyServerPostUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyServerPostUpdateAsServer](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdateasserver.md)