reviews

Submit or update my review

Create or replace the authenticated user's single review. Always lands in pending and always clears any previous moderation decision: an approval covers specific words, so edited words need a fresh one. consentToPublish must be sent on every submit - it is never carried over.

post/reviews/me

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/reviews/me
  • Auth: HTTP bearer

Request body

bodystring

The review itself, in the reviewer's own words. Optional: an empty string records a stars-only rating.

consentToPublishboolean required

Explicit permission to publish these words, this name and this rating on the public site. Required on every submit - it is never inherited from a previous version of the review.

displayNamestring required

What the reviewer wants to be credited as. Their choice, never their account name.

ratinginteger required

Star rating, 1-5 inclusive.

Example request

{
  "body": "I stopped writing cover letters by hand and started getting replies within a fortnight.",
  "consentToPublish": true,
  "displayName": "Ava K.",
  "rating": 5
}

Response

The stored review, reset to pending.

successtrue required

Example response

{
  "data": {
    "review": {
      "consentRecordedAt": "2026-08-31T09:15:00.000Z",
      "rating": 5,
      "status": "pending"
    }
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.