Reviews

Get reviews

1GET https://api.markprompt.com/reviews

Retrieves reviews in the given time range.

Request body

KeyTypeDescriptionDefault
fromstring

The start of the range, as an ISO 8601 string.

tostring

The end of the range, as an ISO 8601 string.

status"open" | "closed"

The status of the review. Omit to include all.

limitnumber

The maximum number of results to return.

20
pagenumber

The page index.

0
projectKeystring

Instead of the API token, use a project key, for instance for client-facing requests.

Example request

1curl "https://api.markprompt.com/reviews?from=2024-10-16T00%3A00%3A00&to=2024-10-17T00%3A00%3A00&limit=3&page=1" \
2  -X GET \
3  -H "Authorization: Bearer <TOKEN>" \
4  -H "Content-type: application/json" \
5  -H "Accept: application/json" \
6  -H "X-Markprompt-API-Version: 2024-05-21"

Response

The response is of the form:

1{
2  "object": "list",
3  "data": [
4    {
5      "id": "review-id-1",
6      "createdAt": "2024-10-16T22:11:44.000000+00:00",
7      "createdBy": "jane@acme.com",
8      "threadId": "thread-id-1",
9      "status": "open",
10      "pass": true,
11      "quality": 4,
12      "votes": {
13        "factuality": 1,
14        "tone": 1,
15        "references": -1
16      },
17      "assignees": ["jane@acme.com", "john@acme.com"],
18      "comments": [
19        {
20          "createdAt": "2024-10-16T22:11:48.000000+00:00",
21          "createdBy": "john@acme.com",
22          "comment": "It referenced an article about…"
23        }
24      ]
25    }
26    // ...
27  ]
28}