Manage Pinned Lists

리스트 고정 및 해제

이 가이드는 리스트를 고정하고 고정 해제하는 방법을 안내합니다.

사전 준비 사항

시작하기 전에 다음이 필요합니다.

• 승인이 완료된 App이 연결된 개발자 계정
• 사용자 액세스 토큰(OAuth 1.0a 또는 OAuth 2.0 PKCE)

---

​

리스트 고정하기

1. 사용자 ID와 리스트 ID 가져오기

   인증된 사용자 ID와 고정하려는 리스트의 ID가 필요합니다. 리스트 페이지의 URL에서 리스트 ID를 확인할 수 있습니다.

2. 리스트 고정하기

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/pinned_lists" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"list_id": "1454155907651158017"}'
   
3. 응답 확인하기

   {
     "data": {
       "pinned": true
     }
   }
   

---

​

리스트 고정 해제

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

응답:

{
  "data": {
    "pinned": false
  }
}

---

​

중요 사항

• 팔로우 중이거나 소유한 리스트만 고정할 수 있습니다.
• 고정된 리스트는 X 앱의 내 리스트 상단에 표시됩니다.
• 고정할 수 있는 리스트의 개수에는 제한이 있습니다.

---

​

다음 단계

고정 리스트 조회

내 고정 리스트 가져오기

리스트 조회

리스트 세부 정보 가져오기

API 참조 문서

엔드포인트 전체 문서 보기