API reference
Timeline
The authorizing user's own reading surfaces. Paths, scopes, request and response shapes.
Read the authorizing user's timeline
GET /public/v1/timeline
Scope posts.read — OAuth 2.1 token or personal access token.
scope=discovery (the default) returns the public discovery surface; scope=following returns posts from accounts the user follows. Newest first, cursor-paginated, every row visibility-checked for the authorizing user. Community posts and reposts are not part of this surface in v1.
Query parameters
| Name | Type | Required | Notes |
|---|---|---|---|
limit | integer | no | 1–50, defaults to 20 |
cursor | string | no | at most 512 characters |
scope | discovery | following | no | defaults to discovery |
Example
curl -X GET "https://api.mouve.it/public/v1/timeline" \
-H "Authorization: Bearer $MOUVE_TOKEN"Response 200
| Field | Type | Required | Notes |
|---|---|---|---|
data | array of PublicPostDto | yes | — |
meta | object | yes | next_cursor is null on the last page. |
meta.next_cursor | string | null | yes | — |
Errors
Beyond the shared responses:
| Status | Code |
|---|---|
400 | INVALID_CURSOR |