Reviews

3 endpoints: send a post for review, approve a post, reject a post.

Send a post for review: POST /v1/posts/{post_id}/review
Approve a post: POST /v1/posts/{post_id}/review/approve
Reject a post: POST /v1/posts/{post_id}/review/reject

Send a post for review

POST /v1/posts/{post_id}/review

Asks the Project's reviewers to approve a draft. Optionally assign a person or a Team.

Permission: posts:write · Accepts Idempotency-Key · Answers 201

Path parameters

Name	Description
`post_id`	The post's id.

Body

Field	Type	Required	Description
`assigned_user_id`	string	No	(up to 128 characters)
`assigned_team_id`	string	No	(up to 128 characters)

Response

Field	Type	Required	Description
`object`	`"post_review"`	Yes
`post_id`	string	Yes	(up to 128 characters)
`review_status`	`in_review`, `approved`, `rejected`	Yes

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/review \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'

Approve a post

POST /v1/posts/{post_id}/review/approve

Approves the post's open review. Send expected_revision from the review to make sure you approve the version you checked.

Permission: reviews:write · Accepts Idempotency-Key

Path parameters

Name	Description
`post_id`	The post's id.

Body

Field	Type	Required	Description
`expected_revision`	integer	No	(0 to 9007199254740991)
`reason`	string	No	(up to 2000 characters)

Response

Field	Type	Required	Description
`object`	`"post_review"`	Yes
`post_id`	string	Yes	(up to 128 characters)
`review_status`	`in_review`, `approved`, `rejected`	Yes

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/review/approve \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'

Reject a post

POST /v1/posts/{post_id}/review/reject

Rejects the post's open review with an optional reason for its author.

Permission: reviews:write · Accepts Idempotency-Key

Path parameters

Name	Description
`post_id`	The post's id.

Body

Field	Type	Required	Description
`expected_revision`	integer	No	(0 to 9007199254740991)
`reason`	string	No	(up to 2000 characters)

Response

Field	Type	Required	Description
`object`	`"post_review"`	Yes
`post_id`	string	Yes	(up to 128 characters)
`review_status`	`in_review`, `approved`, `rejected`	Yes

curl -X POST https://api.nowscale.com/v1/posts/POST_ID/review/reject \
  -H "Authorization: Bearer $NOWSCALE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ ... }'