Skip to main content
GET
List Worker suggestions

Authorizations

Authorization
string
header
required

A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.

Query Parameters

account_id
string

Account to act on, from GET /v1/accounts. Defaults to your main account. An id outside your accounts returns 404 account_not_found.

status
enum<string>
default:to_review

to_review (default) = waiting on a person; drafted, scheduled and dismissed = already acted on; all = every suggestion. A dismissed suggestion reads as dismissed even if it was saved first.

Available options:
to_review,
drafted,
scheduled,
dismissed,
all
worker_id
integer

Narrow to one Worker by its numeric id (from GET /v1/workers). An unknown or foreign id returns 404 worker_not_found.

limit
integer
default:20

Page size, 1 to 100.

Required range: 1 <= x <= 100
page
integer
default:1

1-based page number.

Required range: x >= 1

Response

A page of suggestions, generated_at descending.

data
object[]
pagination
object