Brand review portal

Approve or reject the reviewer's posts

Authenticated (brand reviewer session only). Records this reviewer's approve/reject decision on one or more posts in their pending set — one id or many, same contract — and returns a per-post result. An unknown {publicId}, or one that belongs to another reviewer, returns 404 (the two are indistinguishable, on purpose, so the status can't be used to probe which portals exist); an internal Metricool user session is rejected with 403. Applied best-effort: a post that is not in the reviewer's set or is no longer actionable is reported as a failed result, not a 4xx. At most 100 posts are acted on per call; extra ids (after de-duplication) are ignored.

put/v2/scheduler/review-portals/{publicId}/posts/approvals

Request

  • Base URL: https://app.metricool.com/api
  • URL: https://app.metricool.com/api/v2/scheduler/review-portals/{publicId}/posts/approvals
  • Auth: none declared

Path parameters

publicIdstring required

Request body

postIdsinteger[] required

Ids of the posts to decide on. One id for a single action, several for bulk. At most 100 distinct ids are processed per call; any beyond the first 100 are ignored.

status'approved' | 'rejected' required

The decision, applied to every listed post.

notestring

Optional note; used only when rejecting. Attached as a post note and included in the rejection email to each post's creator.

Example request

{
  "status": "approved"
}

Response

OK

metadataobject

Example response

{
  "data": {
    "results": [
      {
        "postId": 1024,
        "reviewerStatus": "approved",
        "postApprovalStatus": "approved",
        "error": "NOT_FOUND"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 4 revisions of this API.