빠른 시작

리스트를 생성, 수정, 삭제합니다

이 가이드는 리스트를 생성, 수정 및 삭제하는 방법을 단계별로 설명합니다.

사전 준비 사항

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

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

---

​

리스트 생성

1. 요청 준비

   리스트 이름(필수)과 선택 사항인 설명, 공개 범위 설정을 지정합니다:

   {
     "name": "Tech News",
     "description": "Top tech journalists and publications",
     "private": false
   }
   
2. 요청 전송

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/lists" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Tech News",
       "description": "Top tech journalists and publications",
       "private": false
     }'
   
3. 응답 확인

   {
     "data": {
       "id": "1441162269824405510",
       "name": "Tech News"
     }
   }
   

   나중에 리스트를 업데이트하거나 삭제할 수 있도록 id를 저장해 두세요.

---

​

리스트 업데이트

리스트의 이름, 설명 또는 공개 범위를 변경합니다:

cURL

shellscript

curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'

응답:

{
  "data": {
    "updated": true
  }
}

---

​

리스트 삭제하기

1. 리스트 ID 가져오기

   삭제하려는 리스트의 ID가 필요합니다.

2. 삭제 요청 보내기

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. 삭제 확인

   {
     "data": {
       "deleted": true
     }
   }
   

본인이 소유한 리스트만 삭제할 수 있습니다.

---

​

다음 단계

리스트 멤버

리스트 멤버 추가 및 삭제

리스트 조회

리스트 상세 정보 조회

통합 가이드

핵심 개념과 모범 사례

API 참조 문서

전체 엔드포인트 문서