ApexDevelopers

Lists

Manage X list-based engagement targets.

GET
/list

List all engagement lists

Response

200Array of lists

Retrieve all engagement lists:

POST
/list

Create a new engagement list

Request Body

NameTypeRequiredDescription
name
string
Required
Display name for the list
url
string
Required
The X list URL
tone
string
Optional
Engagement tone: AUTHORITATIVE, APPROACHABLE, INSPIRING, NONE
memes
boolean
Optional
Whether to include meme replies
minLikes
number
Optional
Minimum likes threshold
maxAge
number
Optional
Maximum tweet age in minutes

Success Response

Returns the created list object.

Error Response

400Invalid URL

Create a new engagement list:

DELETE
/list/:id

Delete an engagement list

Path Parameters

NameTypeRequiredDescription
id
string
Required
The list ID

Error Response

404Not found

Delete an engagement list by ID: