Code Reviews

List code reviews

Returns all code reviews for one app, grouped into open, merged, and closed status buckets. Within each bucket, the most recently created reviews appear first.

GET /api/public/v1/code-reviews

List code reviews

curl --request GET \
  --url 'https://api.buildprint.ai/api/public/v1/code-reviews' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "open": [
    {
      "sequence": 1,
      "mergeId": "<string>",
      "status": "open",
      "title": "<string>",
      "description": "<string>",
      "fromVersion": "<string>",
      "toVersion": "<string>",
      "fromVersionLabel": "<string>",
      "toVersionLabel": "<string>",
      "requestedByName": "<string>",
      "requestedByEmail": "<string>",
      "requestedByImage": "<string>"
    }
  ],
  "merged": [
    {
      "sequence": 1,
      "mergeId": "<string>",
      "status": "open",
      "title": "<string>",
      "description": "<string>",
      "fromVersion": "<string>",
      "toVersion": "<string>",
      "fromVersionLabel": "<string>",
      "toVersionLabel": "<string>",
      "requestedByName": "<string>",
      "requestedByEmail": "<string>",
      "requestedByImage": "<string>"
    }
  ],
  "closed": [
    {
      "sequence": 1,
      "mergeId": "<string>",
      "status": "open",
      "title": "<string>",
      "description": "<string>",
      "fromVersion": "<string>",
      "toVersion": "<string>",
      "fromVersionLabel": "<string>",
      "toVersionLabel": "<string>",
      "requestedByName": "<string>",
      "requestedByEmail": "<string>",
      "requestedByImage": "<string>"
    }
  ]
}

Code reviews found

Authorizations

  • Authorization string required header

    Workspace REST API token prefixed with bp_

Query Parameters

  • appId string required

    Bubble app ID for the project whose code reviews should be listed.

  • limit integer

    Maximum number of reviews to return in each status bucket.

Response

application/json
  • open[] object array

    Open code reviews for the app.

    + Show Child Attributes
    • sequence number

      Human-readable sequence number for the review within the project.

    • mergeId string

      Stable merge identifier for the review.

    • status string enum enum

      Current review status. Allowed values: open, merged, closed.

    • title string | null

      Review title.

    • description string | null

      Optional review description provided at creation time.

    • fromVersion string

      Source branch or version being reviewed.

    • toVersion string

      Target branch or version being compared against.

    • fromVersionLabel string | null

      Display label for the source branch or version.

    • toVersionLabel string | null

      Display label for the target branch or version.

    • requestedByName string | null

      Display name of the user who requested the review.

    • requestedByEmail string | null

      Email of the user who requested the review.

    • requestedByImage string | null

      Avatar URL for the user who requested the review.

    • linearIssueId string | null

      Linked Linear issue ID when one is associated.

    • linearIssueIdentifier string | null

      Linked Linear issue identifier when one is associated.

    • provider string enum enum

      Provider backing the selected model. Allowed values: claude, openai, gemini, opencode.

    • model string enum enum

      Model identifier used for the review. 15 allowed enum values.

    • createdAt number

      Unix timestamp in milliseconds when the review was created.

    • updatedAt number

      Unix timestamp in milliseconds when the review was last updated.

    • completedAt number | null

      Unix timestamp in milliseconds when the review completed.

    • mergedAt number | null

      Unix timestamp in milliseconds when the review was marked merged.

    • closedAt number | null

      Unix timestamp in milliseconds when the review was closed without merging.

    • conversationStatus string enum | null

      Current lifecycle state of the linked agent conversation.

    • conversationErrorCode string | null

      Internal error code from the linked conversation when one exists.

    • id string

      Opaque identifier for the code review.

  • merged[] object array

    Merged code reviews for the app.

    + Show Child Attributes
    • sequence number

      Human-readable sequence number for the review within the project.

    • mergeId string

      Stable merge identifier for the review.

    • status string enum enum

      Current review status. Allowed values: open, merged, closed.

    • title string | null

      Review title.

    • description string | null

      Optional review description provided at creation time.

    • fromVersion string

      Source branch or version being reviewed.

    • toVersion string

      Target branch or version being compared against.

    • fromVersionLabel string | null

      Display label for the source branch or version.

    • toVersionLabel string | null

      Display label for the target branch or version.

    • requestedByName string | null

      Display name of the user who requested the review.

    • requestedByEmail string | null

      Email of the user who requested the review.

    • requestedByImage string | null

      Avatar URL for the user who requested the review.

    • linearIssueId string | null

      Linked Linear issue ID when one is associated.

    • linearIssueIdentifier string | null

      Linked Linear issue identifier when one is associated.

    • provider string enum enum

      Provider backing the selected model. Allowed values: claude, openai, gemini, opencode.

    • model string enum enum

      Model identifier used for the review. 15 allowed enum values.

    • createdAt number

      Unix timestamp in milliseconds when the review was created.

    • updatedAt number

      Unix timestamp in milliseconds when the review was last updated.

    • completedAt number | null

      Unix timestamp in milliseconds when the review completed.

    • mergedAt number | null

      Unix timestamp in milliseconds when the review was marked merged.

    • closedAt number | null

      Unix timestamp in milliseconds when the review was closed without merging.

    • conversationStatus string enum | null

      Current lifecycle state of the linked agent conversation.

    • conversationErrorCode string | null

      Internal error code from the linked conversation when one exists.

    • id string

      Opaque identifier for the code review.

  • closed[] object array

    Closed code reviews for the app that were not merged.

    + Show Child Attributes
    • sequence number

      Human-readable sequence number for the review within the project.

    • mergeId string

      Stable merge identifier for the review.

    • status string enum enum

      Current review status. Allowed values: open, merged, closed.

    • title string | null

      Review title.

    • description string | null

      Optional review description provided at creation time.

    • fromVersion string

      Source branch or version being reviewed.

    • toVersion string

      Target branch or version being compared against.

    • fromVersionLabel string | null

      Display label for the source branch or version.

    • toVersionLabel string | null

      Display label for the target branch or version.

    • requestedByName string | null

      Display name of the user who requested the review.

    • requestedByEmail string | null

      Email of the user who requested the review.

    • requestedByImage string | null

      Avatar URL for the user who requested the review.

    • linearIssueId string | null

      Linked Linear issue ID when one is associated.

    • linearIssueIdentifier string | null

      Linked Linear issue identifier when one is associated.

    • provider string enum enum

      Provider backing the selected model. Allowed values: claude, openai, gemini, opencode.

    • model string enum enum

      Model identifier used for the review. 15 allowed enum values.

    • createdAt number

      Unix timestamp in milliseconds when the review was created.

    • updatedAt number

      Unix timestamp in milliseconds when the review was last updated.

    • completedAt number | null

      Unix timestamp in milliseconds when the review completed.

    • mergedAt number | null

      Unix timestamp in milliseconds when the review was marked merged.

    • closedAt number | null

      Unix timestamp in milliseconds when the review was closed without merging.

    • conversationStatus string enum | null

      Current lifecycle state of the linked agent conversation.

    • conversationErrorCode string | null

      Internal error code from the linked conversation when one exists.

    • id string

      Opaque identifier for the code review.