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

# POST (/users/xuid({xuid})/devices/current/titles/current)

> POST (/users/xuid({xuid})/devices/current/titles/current)

# POST (/users/xuid({xuid})/devices/current/titles/current)

Actualiza un título con la presencia de un usuario.
El dominio de estos URI es `userpresence.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4EEB)
* [Autorización](#ID4EPB)
* [Encabezados de solicitud obligatorios](#ID4ENE)
* [Encabezados de solicitud opcionales](#ID4ERG)
* [Cuerpo de la solicitud](#ID4ERH)
* [Cuerpo de la respuesta](#ID4EKAAC)

## Comentarios

Todos los títulos de las plataformas que no son de consola pueden usar este URI para agregar y actualizar los datos de presencia, presencia enriquecida y presencia multimedia de un título.

**SandboxId** ahora se recupera de la notificación del XToken y se aplica. Si **SandboxId** no está presente, Entertainment Discovery Services (EDS) generará un error 400 Solicitud incorrecta.

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| xuid | Entero sin signo de 64 bits | Identificador de usuario de XBOX (XUID) del usuario de destino. |

## Autorización

\| Tipo| Obligatorio| Descripción| Respuesta si falta|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| Sí| Identificador de usuario de XBOX (XUID) del autor de la llamada| 403 Prohibido|
\| titleId| Sí| titleId del título| 403 Prohibido|
\| deviceId| Sí para todos excepto Windows y web| deviceId del autor de la llamada| 403 Prohibido|
\| deviceType| Sí para todos excepto web| deviceType del autor de la llamada| 403 Prohibido|
\| sandboxId| Sí para las llamadas procedentes de | sandbox del autor de la llamada| 403 Prohibido|

## Encabezados de solicitud obligatorios

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: "XBL3.0 x=\<userhash>;\<token>".|
\| x-xbl-contract-version| string| Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valores de ejemplo: 3, vnext.|
\| Content-Type| string| Tipo MIME del cuerpo de la solicitud. Valor de ejemplo: application/json.|
\| Content-Length| string| Longitud del cuerpo de la solicitud. Valor de ejemplo: 312.|
\| Host| string| Nombre de dominio del servidor. Valor de ejemplo: presencebeta.xboxlive.com.|

## Encabezados de solicitud opcionales

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | Nombre o número de compilación del servicio XBOX LIVE al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio después de comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.|

## Cuerpo de la solicitud

El objeto de solicitud es un [TitleRequest](https://docs.xbox.com/es/reference/live/rest/json/json-titlerequest.md). Solo se actualizan las propiedades que están realmente presentes en el cuerpo. Las propiedades que no forman parte del cuerpo pero existen en el servidor no se modificarán.

### Solicitud de ejemplo

```cpp theme={null}
{
  id:"12341234",
  placement:"snapped",
  state:"active"
}
      
```

## Cuerpo de la respuesta

En caso de éxito, se devuelve un código de estado HTTP 200 o 201 Creado, según corresponda.

En caso de error (HTTP 4xx o 5xx), se devuelve la información de error adecuada en el cuerpo de la respuesta.

## Consulte también

##### Elemento primario

[/users/xuid({xuid})/devices/current/titles/current](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrent.md)

##### Información adicional

[URI de Marketplace](https://docs.xbox.com/es/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)

[Referencia adicional](https://docs.xbox.com/es/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [/users/xuid({xuid})/devices/current/titles/current](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrent.md)
- [DELETE (/users/xuid({xuid})/devices/current/titles/current)](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersxuiddevicescurrenttitlescurrentdelete.md)
- [PresenceRecord (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-presencerecord.md)
- [TitleRecord (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-titlerecord.md)
- [TitleRequest (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-titlerequest.md)