---
title: "Review a deploy request"
method: POST
path: "/organizations/{organization}/databases/{database}/deploy-requests/{number}/reviews"
tags: ["Deploy requests"]
---

# Review a deploy request

`POST /organizations/{organization}/databases/{database}/deploy-requests/{number}/reviews`

Review a deploy request by either approving or commenting on the deploy request
### Authorization
A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

**Service Token Accesses**
 `approve_deploy_request`, `review_deploy_request`

**OAuth Scopes**

 | Resource | Scopes |
| :------- | :---------- |
| Organization | `approve_deploy_requests` |
| Database | `approve_deploy_requests` |

## Path parameters

- `organization` string, required
- `database` string, required
- `number` integer, required

## Request body

- object
  - `state` 'commented' | 'approved' — Whether the review is a comment or approval. Service tokens must have corresponding access (either `approve_deploy_request` or `review_deploy_request`)
  - `body` string — Deploy request review comments

## Response `201`

Returns the created deploy request review

- object
  - `id` string, required — The ID of the review
  - `body` string, required — The text body of the review
  - `html_body` string, required — The HTML body of the review
  - `state` 'commented' | 'approved', required — Whether the review is a comment or approval
  - `created_at` string, required — When the review was created
  - `updated_at` string, required — When the review was last updated
  - `actor` object, required
    - `id` string, required — The ID of the actor
    - `display_name` string, required — The name of the actor
    - `avatar_url` string, required — The URL of the actor's avatar

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2025-12-09** `d710019068fb` — 1 breaking
  - for the `path` request parameter `number`, the type/format was changed from `number`/`` to `integer`/``
- **2025-12-06** `477c6ebdabdf` — 1 breaking
  - for the `path` request parameter `number`, the type/format was changed from `string`/`` to `number`/``

[Change history](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/databases/:database/deploy-requests/:number/reviews/post.md)

---

[API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [All operations](https://skmtc.dev/planetscale/apis/planetscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/planetscale/planetscale-api/revisions/6d28c038c4fd/schema)