Review

List reviews for the authenticated user

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

typestring · enumOptional

Filter reviews (e.g., "written", "received", "all")

Possible values:

Responses

200

List of reviews retrieved

application/json

401

Unauthorized

get

/api/v1/reviews

HTTPcURLJavaScriptPython

GET /api/v1/reviews HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": "text",
  "message": "text",
  "data": [
    {
      "id": 1,
      "reviewer": {
        "id": 1,
        "userId": 1,
        "expertise": "text",
        "bio": "text",
        "tags": [
          "text"
        ],
        "createdAt": "2025-12-29T19:45:45.357Z",
        "updatedAt": "2025-12-29T19:45:45.357Z"
      },
      "reviewee": {
        "id": 1,
        "userId": 1,
        "displayName": "text",
        "preferences": [
          "text"
        ],
        "createdAt": "2025-12-29T19:45:45.357Z",
        "updatedAt": "2025-12-29T19:45:45.357Z"
      },
      "reviewRequestId": 1,
      "reviewContent": "text",
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    }
  ]
}

Submit a new review (by a Reviewer)

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

reviewRequestIdinteger · int64Required

reviewContentstringRequired

Responses

201

Review created successfully

application/json

400

Invalid request (e.g., review request not approved or already reviewed)

401

Unauthorized

403

Forbidden (not the designated reviewer for the request)

post

/api/v1/reviews

HTTPcURLJavaScriptPython

POST /api/v1/reviews HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "reviewRequestId": 1,
  "reviewContent": "text"
}

{
  "code": "text",
  "message": "text",
  "data": {
    "id": 1,
    "reviewer": {
      "id": 1,
      "userId": 1,
      "expertise": "text",
      "bio": "text",
      "tags": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewee": {
      "id": 1,
      "userId": 1,
      "displayName": "text",
      "preferences": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewRequestId": 1,
    "reviewContent": "text",
    "createdAt": "2025-12-29T19:45:45.357Z",
    "updatedAt": "2025-12-29T19:45:45.357Z"
  }
}

Get a specific review

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

reviewIdinteger · int64Required

ID of the Review

Responses

200

Review details retrieved

application/json

401

Unauthorized

403

Forbidden (not involved in this review)

404

Review not found

get

/api/v1/reviews/{reviewId}

HTTPcURLJavaScriptPython

GET /api/v1/reviews/{reviewId} HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": "text",
  "message": "text",
  "data": {
    "id": 1,
    "reviewer": {
      "id": 1,
      "userId": 1,
      "expertise": "text",
      "bio": "text",
      "tags": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewee": {
      "id": 1,
      "userId": 1,
      "displayName": "text",
      "preferences": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewRequestId": 1,
    "reviewContent": "text",
    "createdAt": "2025-12-29T19:45:45.357Z",
    "updatedAt": "2025-12-29T19:45:45.357Z"
  }
}

Update an existing review (by the original Reviewer)

put

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

reviewIdinteger · int64Required

ID of the Review to update

Body

application/json

reviewContentstringOptional

Responses

200

Review updated successfully

application/json

400

Invalid request

401

Unauthorized

403

Forbidden (not the original reviewer or update window passed)

404

Review not found

put

/api/v1/reviews/{reviewId}

HTTPcURLJavaScriptPython

PUT /api/v1/reviews/{reviewId} HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "reviewContent": "text"
}

{
  "code": "text",
  "message": "text",
  "data": {
    "id": 1,
    "reviewer": {
      "id": 1,
      "userId": 1,
      "expertise": "text",
      "bio": "text",
      "tags": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewee": {
      "id": 1,
      "userId": 1,
      "displayName": "text",
      "preferences": [
        "text"
      ],
      "createdAt": "2025-12-29T19:45:45.357Z",
      "updatedAt": "2025-12-29T19:45:45.357Z"
    },
    "reviewRequestId": 1,
    "reviewContent": "text",
    "createdAt": "2025-12-29T19:45:45.357Z",
    "updatedAt": "2025-12-29T19:45:45.357Z"
  }
}