Skip to main content
GET
List reviews
In the Heliyos MCP server: heliyos_reviews_list.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Query Parameters

limit
integer
default:20

Reviews per page, 1 to 100. Defaults to 20.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page. Takes precedence over offset and page. next_cursor from the previous page; only valid with the default sort.

Maximum string length: 200
page
integer

A page number, starting at 1, for offset paging. Skips (page - 1) * limit reviews. Ignored when offset is sent.

Required range: x >= 1
offset
integer

The number of reviews to skip, for offset paging.

Required range: x >= 0
status
enum<string>

Only reviews with this decision. Omit for all.

  • PENDING: waiting for a person.
  • APPROVED: approved by a person or by the workspace's autopilot settings.
  • REJECTED: rejected by a person.
Available options:
PENDING,
APPROVED,
REJECTED
type
string

Only reviews of this type, exact match, for example email_draft or deal_update (see type in the response for the values). decision also matches older questions and approval requests stored under other names. An unknown type returns an empty list.

Maximum string length: 64
Pattern: ^[a-z][a-z0-9_]*$
objectId
string

Only reviews about this record, task, email thread or file: a review matches when the id is one of its records (objectRefs), its task, the email thread of its draft or the file it saves. A record, task, inbox thread or attachment id.

Maximum string length: 100
objectType
string

Accepted with objectId for compatibility. It does not narrow the results further.

Maximum string length: 50
relationshipObjectId
string

An older name for objectId. Ignored when objectId is sent.

Maximum string length: 100
relationshipObjectType
string

An older name for objectType. Ignored when objectType is sent.

Maximum string length: 50

Response

A page of reviews.

meta
object
required
data
object[]
required