Skip to main content
GET
List reviewed merge requests: find a PR's review, or what merged.
Scope: review:reviews:read. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

Query Parameters

state
enum<string>[]

Only these merge request states.

Available options:
open,
merged,
closed,
locked,
unknown
merged
string<date-time>

Only merge requests merged at or after this time.

status
enum<string>[]

Only these review statuses.

Available options:
queued,
in_review,
review_complete,
filtered,
failed,
stopped
verdict
enum<string>[]

Only these verdicts.

Available options:
in_review,
approved,
review_suggested,
changes_requested,
failed,
filtered,
stopped
provider
enum<string>

Code host.

Available options:
gitlab,
github,
bitbucket,
azure_devops,
aws_codecommit
project
string

Repository path, for example group/project.

number
integer

Merge request or pull request number. Use with provider and project.

author
string[]

Only these authors; me is the caller.

Text in the title, repository path or number.

Maximum string length: 200
limit
integer
default:20

Items per page.

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

next_cursor from the previous page.

Maximum string length: 512

Response

OK

Reviewed merge requests, newest first.

items
Review · object[]
required
next_cursor
string | null
required

Pass back as cursor for the next page. Null on the last page.