What problem does it solve?
Managing Twitter/X lists through the web UI or multiple API calls is time-consuming and error-prone; this Skill centralizes list management operations so users can quickly view, create, update, and maintain membership at scale.
Core Features & Use Cases
- List Discovery & Overview: Retrieve all lists owned by the API key user and present concise summaries including ID, description, member count, and privacy.
- Create & Edit Lists: Create new lists or update existing ones (name, description, privacy) and receive the new or updated list ID.
- Member Management: Add or remove members using user IDs, with guidance for resolving usernames to IDs and enforcement of membership limits per plan.
- Operational Safety: Validates X-API-KEY presence, checks response.success rather than relying solely on HTTP status, and surfaces common xgo error codes (rate limits, quota limits, ownership errors).
- Use Case: A social media manager organizes KOLs into thematic lists, bulk-adds members, and audits list sizes against PLUS/PRO limits.
Quick Start
Add @elonmusk (user id 44196397) to my "AI Researchers" list by calling the XGo list/addMember endpoint with XGO_API_KEY set in the environment.