Flambe docs
API referenceHouseholds

List my shareable resources

The caller's own resources of one type, each annotated with whether it is currently shared into this household — the data behind a share picker.

GET
/api/households/{id}/library/my-resources/{resourceType}

The caller's own resources of one type, each annotated with whether it is currently shared into this household — the data behind a share picker.

Authorization

bearerAuth
AuthorizationBearer <token>

A Clerk session JWT. Obtain one with a Clerk frontend SDK (session.getToken()) or, for server-to-server use, with a Clerk machine token. The token's sub claim is the Flambe user id that scopes every request.

In: header

Path Parameters

id*string
Formatuuid
resourceType*string

Value in

  • "recipe"
  • "collection"
  • "mealplan"
  • "grocerylist"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/households/497f6eca-6276-4993-bfeb-53cbbbba6f08/library/my-resources/recipe"
{  "items": [    {      "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",      "title": "string",      "shared": true,      "role": "viewer"    }  ]}