> ## 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 (/users/xuid({xuid})/devices/current/titles/current)

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

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

사용자의 프레즌스로 타이틀을 업데이트합니다.
이러한 URI의 도메인은 `userpresence.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EEB)
* [권한 부여](#ID4EPB)
* [필수 요청 헤더](#ID4ENE)
* [선택적 요청 헤더](#ID4ERG)
* [요청 본문](#ID4ERH)
* [응답 본문](#ID4EKAAC)

## 설명

이 URI는 비콘솔 플랫폼의 모든 타이틀에서 타이틀에 대한 프레즌스, 리치 프레즌스 및 미디어 프레즌스 데이터를 추가하고 업데이트하는 데 사용할 수 있습니다.

**SandboxId**는 이제 XToken의 클레임에서 검색되어 적용됩니다. **SandboxId**가 존재하지 않는 경우 Entertainment Discovery Services(EDS)는 400 Bad request 오류를 발생시킵니다.

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| xuid | 64-bit unsigned integer | 대상 사용자의 XBOX User ID(XUID)입니다. |

## 권한 부여

\| 형식| 필수| 설명| 누락 시 응답|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| 예| 호출자의 XBOX User ID(XUID)| 403 Forbidden|
\| titleId| 예| 타이틀의 titleId| 403 Forbidden|
\| deviceId| Windows 및 Web을 제외한 모두에서 필수| 호출자의 deviceId| 403 Forbidden|
\| deviceType| Web을 제외한 모두에서 필수| 호출자의 deviceType| 403 Forbidden|
\| sandboxId| 다음에서 오는 호출에 필수 | 호출자의 sandbox| 403 Forbidden|

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예시 값: “XBL3.0 x=\<userhash>;\<token>”.|
\| x-xbl-contract-version| string| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 예시 값: 3, vnext.|
\| Content-Type| string| 요청 본문의 MIME 형식입니다. 예시 값: application/json.|
\| Content-Length| string| 요청 본문의 길이입니다. 예시 값: 312.|
\| Host| string| 서버의 도메인 이름입니다. 예시 값: presencebeta.xboxlive.com.|

## 선택적 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.|

## 요청 본문

요청 개체는 [TitleRequest](https://devdocs.xbox.com/ko/reference/live/rest/json/json-titlerequest)입니다. 본문에 실제로 존재하는 속성만 업데이트됩니다. 본문에 포함되지 않았지만 서버에 존재하는 속성은 수정되지 않습니다.

### 샘플 요청

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

## 응답 본문

성공하면 상황에 따라 HTTP 상태 코드 200 또는 201 Created가 반환됩니다.

오류(HTTP 4xx 또는 5xx)의 경우 적절한 오류 정보가 응답 본문에 반환됩니다.

## 참고 항목

##### 상위

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

##### 추가 정보

[Marketplace URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[Additional Reference](https://devdocs.xbox.com/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Troubleshooting Xbox Services traffic for PC games](https://devdocs.xbox.com/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Solucionar problemas de tráfego dos serviços Xbox para jogos para PC](https://devdocs.xbox.com/pt-BR/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Solución de problemas del tráfico de los servicios Xbox para juegos de PC](https://devdocs.xbox.com/es/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Résolution des problèmes de trafic des services Xbox pour les jeux PC](https://devdocs.xbox.com/fr/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
- [Dépannage du trafic des services Xbox pour les jeux PC](https://devdocs.xbox.com/fr-CA/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)
