Skip to content

getCircle

GET
/circles/{circleId}
curl --request GET \
  --url http://localhost:8080/api/v1/circles/per_01j9x3k8m2q4r5s6t7v8w9y0z1 \
  --cookie hs_session=<hs_session>

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
circleId
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

Responses

Section titled “Responses”

200

Section titled “200”

Circle with people.

Media typeapplication/json
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
name
required
string
icon
required
string
color
required
string
Allowed values: terracotta honey sage dusk plum clay
visibility
required
string
Allowed values: household private
preset
string | null
Allowed values: family friends creators
personCount
required
integer
people

Present on getCircle only.

Array<object>
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
displayName
required
string
relationLabel
string | null
kind
required
string
Allowed values: family friend creator other
closeness
required

1 = closest. Weights the feed and hearth picks.

integer
>= 1 <= 3
avatar
One of:
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
url
required

Signed URL, valid 24 h.

string
thumbUrl
string
cardUrl
string
posterUrl
string
mime
required
string
width
integer
height
integer
durationMs
integer
blurhash
string
alt
string
inMyFeed
required
boolean
canEdit
required
boolean
sortOrder
required
integer
capturableAccounts

Accounts on platforms the extension can capture.

integer
capturableAccountLimit
integer
Allowed value: 30
lastUpdate
One of:
null

Examples

Exampleseed

Derived from fixtures/seed.json.

{
  "canEdit": true,
  "capturableAccountLimit": 30,
  "capturableAccounts": 4,
  "color": "terracotta",
  "icon": "home",
  "id": "cir_01j9kaptqa5dcqne4nmnrbp86d",
  "inMyFeed": true,
  "lastUpdate": {
    "by": {
      "avatar": null,
      "displayName": "Mali",
      "id": "mem_01j9kt0d8rwgmhnmxkmv0frnr0"
    },
    "finishedAt": "2026-10-17T08:45:00.000Z",
    "newMoments": 4,
    "runId": "run_01j9a1b2c3d4e5f6g7h8j9k01k"
  },
  "name": "Family",
  "people": [
    {
      "avatar": null,
      "closeness": 1,
      "displayName": "Mom",
      "id": "per_01j9wst6a8vjc69r66y6fj70t5",
      "kind": "family",
      "relationLabel": "แม่"
    },
    {
      "avatar": null,
      "closeness": 2,
      "displayName": "Lin",
      "id": "per_01j9f8r1agkh6g3jp30xcwnytc",
      "kind": "family",
      "relationLabel": "Cousin"
    },
    {
      "avatar": null,
      "closeness": 1,
      "displayName": "Grandma Noi",
      "id": "per_01j9w5jqj9nm7gdsybfz53mcjr",
      "kind": "family",
      "relationLabel": "ยาย"
    },
    {
      "avatar": null,
      "closeness": 2,
      "displayName": "Uncle Wei",
      "id": "per_01j9yjkch7a0ayzz8784jtf08t",
      "kind": "family",
      "relationLabel": "舅舅"
    }
  ],
  "personCount": 4,
  "preset": "family",
  "sortOrder": 0,
  "visibility": "household"
}

404

Section titled “404”

Not found.

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
code
required
string
i18nKey
string
detail
string
fields
Array<object>
object
path
required
string
code
required
string
i18nKey
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}