Query Params

the checkUserActivities or such, is no longer suppoted in the query params; the viewer's access token in the header would suffice

Uploaded File

General Response

All responses have common properties at the first level of the returned object;

Note that the data value depends on the enpoint invoked.

Pagination

Most of the get endpoints accpets some query params to paginate your request.

Say you're fetching users;
initially, your request URI looks this way;
https://baseApi/users?pageSize=4

then, its response could contain the pagination attribute (as typed above);

// https://baseApi/users?pageSize=4

{
    "success": true,
    "statusCode": 200,
    "data": [
        "...",
        {
        "id": "some-last-user-id",
        "email": "hiseous@gmail.com",
        "displayName": "Hiseous",
        "verified": true
        }
    ],
    "pagination": {
        "lastEvaluatedKey": {
            "id": "some-last-user-id",
            "dateCreated": "2024-10-24 07:46:30.725Z"
        }
    }
}

on the next call, you grab the lastEvaluatedKey value;
stringify it, then pass as a param on the next call, this way, your next request URI looks like this;
https://baseApi/users/?pageSize=4&lastEvaluatedKey={"id":"some-last-user-id","dateFollowed":"2024-10-24 07:46:30.725Z"}

then, if the next response contains the pagination attribute, you repeat the same process with the new pagination props from the newer response;

// https://baseApi/users/?pageSize=4&lastEvaluatedKey={"id":"some-last-user-id","dateFollowed":"2024-10-24 07:46:30.725Z"}

{
    "success": true,
    "statusCode": 200,
    "data": [
        "...",
        {
        "id": "some-another-last-user-id",
        "email": "hissy-baby@gmail.com",
        "displayName": "Hiseous",
        "verified": true
        }
    ],
    "pagination": {
        "lastEvaluatedKey": {
            "id": "some-another-last-user-id",
            "dateCreated": "2025-10-24 07:46:30.725Z"
        }
    }
}

You should not modify the lastEvaluatedKey, by the way.
If the response doesn't contain pagination, then it implies the last items were fetched.

Sending Tokens

When it's necessary to send an access or refresh token, use the headers. Although, cookies are sent from the server automatically if the client allows cookies.

V2 General Release Notes

Query Params

Uploaded File

General Response

Sending Tokens

Headers Example

V2 General Release Notes

Query Params#

Uploaded File#

General Response#

Pagination#

Sending Tokens#

Headers Example#

Query Params

Uploaded File

General Response

Pagination

Sending Tokens

Headers Example