---
title: "이 연동에서 조회할 자산 선택 저장"
method: PUT
path: "/v1/credentials/{account_link_id}/selected-assets"
tags: ["CredentialLink"]
---

# 이 연동에서 조회할 자산 선택 저장

`PUT /v1/credentials/{account_link_id}/selected-assets`

## Request

- Base URL: `https://api.xdata.kr` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xdata.kr/v1/credentials/{account_link_id}/selected-assets`
- Auth: one of:
  - HTTP basic
  - OAuth 2 (authorization code, authorization URL `https://api.xdata.kr/oauth/authorize`, token URL `https://api.xdata.kr/oauth/token`)

`PUT /v1/credentials/{account_link_id}/selected-assets` - 고객이 고른 자산을 저장한다.

연동만으로는 조회가 시작되지 않는다. 기관 계정 하나에 GA4 속성 · 사이트가 여러 개 딸려
올 수 있고 **그중 고객이 고른 것만** 읽어야 하기 때문이다(의뢰서 AT-002). 고를 수 있는
목록은 그 상품의 상태 조회 액션이 준다 - 화면은 자기가 보여 준 키를 그대로 보낸다.

**통째로 바꾼다.** 부분 수정 경로를 두지 않는 이유는 서비스 docstring 에 적었다.

## Path parameters

- `account_link_id` string, required

## Query parameters

- `env_scope` 'production' | 'real_test' | 'sandbox', nullable: 환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

## Headers

- `X-Env-Scope` 'production' | 'real_test' | 'sandbox', nullable: 환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

## Request body

- CredentialSelectedAssetsRequest: `PUT /v1/credentials/{account_link_id}/selected-assets` 요청 본문. 고객이 이 연동에서 조회할 자산을 고른 결과를 **통째로** 보낸다. 키와 값의 모양은 기관(provider)마다 다르고 상품이 정본을 갖는다 - 그 액션의 `inputs[].key` 를 그대로 쓴다. ``null`` 을 보내면 선택을 비운다(고르기 전 상태로 되돌린다).
  - `selected_assets` object, nullable: 고른 자산 문서. 예) {"property_id": ["properties/123"], "site_url": ["sc-domain:example.com"]}. null 이면 선택을 비운다.

## Response `200`

Stored selection

- unknown

## Other responses

- `400`: Selected assets document is not storable
- `404`: No such active account link for this user
- `422`: Validation Error

---

[API](https://skmtc.dev/xdata/apis/xboss-api.md) · [All operations](https://skmtc.dev/xdata/apis/xboss-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xdata/apis/xboss-api/revisions/816de78950db?raw)