Amba
API ReferenceClient API

Feeds

Friends feed, current-user feed, and group feeds.

Each feed endpoint joins to app_users for the actor's display info. Group feed enforces membership — non-members get 403 NOT_A_MEMBER.

Source: apps/api/src/routes/client/feeds.ts.

Endpoints

MethodPathDescription
GET/client/feedsUser's feed (self + accepted friends).
GET/client/feeds/meOnly the user's own activity.
GET/client/feeds/group/:groupIdActivity from all members of a group.

GET /client/feeds

Query

ParamDefault
limit20
offset0

Response 200

{
  "data": [
    {
      "id": "…",
      "actor_id": "…",
      "action": "shared_workout",
      "target_id": "…",
      "created_at": "…",
      "actor": { "id": "…", "display_name": "…", "avatar_url": "…" }
    }
  ],
  "total": 100,
  "offset": 0,
  "limit": 20
}

Try it:

GET/client/feeds
client auth
curl -X GET 'https://api.amba.dev/client/feeds'
Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/feeds' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

GET /client/feeds/me

Same shape, filtered to actor_id = current user.

Try it:

GET/client/feeds/me
client auth
curl -X GET 'https://api.amba.dev/client/feeds/me'
Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/feeds/me' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

GET /client/feeds/group/:groupId

Errors

  • 403 NOT_A_MEMBER — user is not in the group.
  • 500 FETCH_FAILED.

Try it:

GET/client/feeds/group/%7B%7BgroupId%7D%7D
client auth
curl -X GET 'https://api.amba.dev/client/feeds/group/%7B%7BgroupId%7D%7D'
Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/feeds/group/{groupId}' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

Previous

Referrals

Next

Friends

On this page