Middagsforslag

Middagene Bryti foreslår for en dag.4 operasjoner

Hoder på hvert svar

Hvert svar på denne siden har disse hodene.

X-Trace-Id: — The W3C trace id of this request — the same id in the log and in the traceId of a problem. Quote it when reporting.
Server-Timing: — Where the time went: total, db;dur=…;desc="N queries", and every step the handler named (ADR-163).
X-Diagnostics: — Only when the request asked with X-Diagnostics: 1 or ?diagnostics=1: the same breakdown as one JSON object, with the trace id (ADR-163).

Operasjoner

POST/api/v1/households/{householdId}/candidates/generate

Put a day's new dinner suggestions in the planning queue

Adults only; a Junior member gets 403. Answers 202 with the run's id (ADR-289): the model call is a background job, GET plans/runs/{jobId} says where it stands, and GET candidates for the day has the suggestions once it is done. Costs credits and replaces the day's current candidates, except one a plan entry still points at. A run that ends in candidate_pool_in_plan — somebody planned the week over these very candidates while they were being replaced (#533) — says so on its status; read the day again and ask once more.

Parametre

Navn	Hvor	Type	Påkrevd	Beskrivelse
`householdId`	path	`string (uuid)`	Påkrevd	—

Forespørselskropp

application/jsonPåkrevdGenerateCandidatesRequest

Svar

202Accepted

application/jsonPlanRunAccepted

400Bad Request

application/problem+jsonProblemDetails

401No session, or the session is no longer valid.

application/problem+jsonProblemDetails

404Not Found

application/problem+jsonProblemDetails

426The build named in X-App-Version is below its platform's version floor (ADR-070). Problem type app-version-unsupported; the only way forward is the store. Callers without the header are never turned away.

application/problem+jsonProblemDetails

429Too many calls in the window; Retry-After says how long.

application/problem+jsonProblemDetails

Hoder

Retry-After: — Seconds to wait when a rate limit answered, or an HTTP date when the household's AI is paused. Absent when the household's AI quota for the period is used up — that resets by itself.

Eksempel

curl -b "bryti_session=…" \
  -X POST \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/candidates/generate" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-09-07","category":"Fish"}'

Eksempel på svar

202application/json

{
  "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "weekStart": "2026-09-07"
}

GET/api/v1/households/{householdId}/candidates

List the candidates generated for one day

date is required. What is missing from the pantry is recomputed on every read — no model call, no write. price is each dish's estimated kroner per portion and class (#3226), from the household's receipts, the store catalogue or the table.

Parametre

Navn	Hvor	Type	Påkrevd	Beskrivelse
`householdId`	path	`string (uuid)`	Påkrevd	—
`date`	query	`string (date)`	Påkrevd	—

Svar

200OK

application/jsonMealCandidateResponse[]

400The request could not be read as the route needs it: a body that is not the documented shape (a required field left out, a null where none is allowed, a value too long for its field), a parameter that does not parse, or a NUL character anywhere (#3540, #3541, #3543). Code validation_failed or value_too_long.

application/problem+jsonProblemDetails

401No session, or the session is no longer valid.

application/problem+jsonProblemDetails

429Too many calls in the window; Retry-After says how long.

application/problem+jsonProblemDetails

Hoder

Retry-After: — Seconds to wait when a rate limit answered, or an HTTP date when the household's AI is paused. Absent when the household's AI quota for the period is used up — that resets by itself.

Eksempel

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/candidates?date=2026-09-07"

Eksempel på svar

200application/json

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "targetDate": "2026-09-07",
    "category": "Fish",
    "content": {
      "title": "string",
      "rationale": "string",
      "ingredients": [
        {}
      ],
      "steps": [
        "string"
      ],
      "activeMinutes": 0,
      "totalMinutes": 0,
      "portions": 0,
      "tags": [
        "string"
      ],
      "leftoverPotential": "string",
      "confidence": 0,
      "assumptions": [
        "string"
      ],
      "safetyWarnings": [
        "string"
      ]
    },
    "scores": {
      "key": 0
    },
    "createdAt": "2026-09-07T16:30:00Z"
  }
]

GET/api/v1/households/{householdId}/candidates/range

List the candidates for every day in a window of at most 92 days

One round-trip for a whole week (#1017); ordered by date, then by when each candidate was created. from and to are both required and the window may cover at most 92 days — a calendar read, not a page (#2977, ADR-292). A day's hand is a dozen dishes with their ingredients on each, so the window is what bounds the answer: three years of it was 2.4 MB.

Parametre

Navn	Hvor	Type	Påkrevd	Beskrivelse
`householdId`	path	`string (uuid)`	Påkrevd	—
`from`	query	`string (date)`	Påkrevd	—
`to`	query	`string (date)`	Påkrevd	—

Svar

200OK

application/jsonMealCandidateResponse[]

400Bad Request

application/problem+jsonProblemDetails

401No session, or the session is no longer valid.

application/problem+jsonProblemDetails

429Too many calls in the window; Retry-After says how long.

application/problem+jsonProblemDetails

Hoder

Retry-After: — Seconds to wait when a rate limit answered, or an HTTP date when the household's AI is paused. Absent when the household's AI quota for the period is used up — that resets by itself.

Eksempel

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/candidates/range?from=2026-09-07&to=2026-09-07"

Eksempel på svar

200application/json

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "targetDate": "2026-09-07",
    "category": "Fish",
    "content": {
      "title": "string",
      "rationale": "string",
      "ingredients": [
        {}
      ],
      "steps": [
        "string"
      ],
      "activeMinutes": 0,
      "totalMinutes": 0,
      "portions": 0,
      "tags": [
        "string"
      ],
      "leftoverPotential": "string",
      "confidence": 0,
      "assumptions": [
        "string"
      ],
      "safetyWarnings": [
        "string"
      ]
    },
    "scores": {
      "key": 0
    },
    "createdAt": "2026-09-07T16:30:00Z"
  }
]

GET/api/v1/households/{householdId}/candidates/use-up

Read the use-up section for one day: the swaps that would use what is running out, as the day's Swap panel shows them.

The bundle is the same as the week's (ADR-173): what remains after the planned use this week and next, and the fewest changes that would use it. This is the day's slice of it. Read-only; applying goes through the home use-up endpoints.

Parametre

Navn	Hvor	Type	Påkrevd	Beskrivelse
`householdId`	path	`string (uuid)`	Påkrevd	—
`date`	query	`string (date)`	Påkrevd	—

Svar

200OK

application/jsonHomeUseUpBundleQuestion

application/problem+jsonProblemDetails

401No session, or the session is no longer valid.

application/problem+jsonProblemDetails

404Not Found

application/problem+jsonProblemDetails

429Too many calls in the window; Retry-After says how long.

application/problem+jsonProblemDetails

Hoder

Retry-After: — Seconds to wait when a rate limit answered, or an HTTP date when the household's AI is paused. Absent when the household's AI quota for the period is used up — that resets by itself.

Eksempel

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/candidates/use-up?date=2026-09-07"

Eksempel på svar

200application/json

{
  "bundleId": "string",
  "changes": [
    {
      "id": "string",
      "day": "2026-09-07",
      "kind": {},
      "recipeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "string",
      "uses": [
        {}
      ],
      "handsBack": [
        {}
      ],
      "activeMinutes": 0,
      "shoppingDelta": 0
    }
  ],
  "coveredCount": 0,
  "urgentCount": 0,
  "notDinner": [
    {
      "foodKey": "string",
      "displayName": "string",
      "reason": {}
    }
  ]
}

Skjema

CandidateContent

Felt	Type	Påkrevd
`title`	`string`	Påkrevd
`rationale`	`string`	Påkrevd
`ingredients`	`CandidateIngredient[]`	Påkrevd
`steps`	`string[]`	Påkrevd
`activeMinutes`	`integer (int32)`	Påkrevd
`totalMinutes`	`integer (int32)`	Påkrevd
`portions`	`integer (int32)`	Påkrevd
`tags`	`string[]`	Påkrevd
`leftoverPotential`	`string`	Påkrevd
`confidence`	`number (double)`	Påkrevd
`assumptions`	`string[]`	Påkrevd
`safetyWarnings`	`string[]`	Påkrevd
`nutrition`	`CandidateNutrition \| null`	—
`timers`	`CandidateStepTimer[] \| null`	—
`sections`	`CandidateSection[] \| null`	—

CandidateIngredient

Felt	Type	Påkrevd
`foodKey`	`string`	Påkrevd
`displayName`	`string`	Påkrevd
`quantity`	`number (double)`	Påkrevd
`unit`	`string`	Påkrevd
`isOptional`	`boolean`	Påkrevd
`missing`	`boolean`	Påkrevd
`displayQuantity`	`number (double) \| null`	—
`displayUnit`	`string \| null`	—

CandidateNutrition

Felt	Type	Påkrevd
`kcalPerPortion`	`integer (int32)`	Påkrevd
`proteinGrams`	`number (double)`	Påkrevd
`fibreGrams`	`number (double)`	Påkrevd
`addedSugarGrams`	`number (double)`	Påkrevd
`saltGrams`	`number (double)`	Påkrevd
`fruitVegPortions`	`number (double)`	Påkrevd
`coverage`	`number (double)`	Påkrevd

CandidatePrice

Felt	Type	Påkrevd
`class`	`PriceClass`	Påkrevd
`perPortionNok`	`number (double) \| null`	Påkrevd
`source`	`PriceSource`	Påkrevd
`coverage`	`number (double)`	Påkrevd

CandidateSection

Felt	Type	Påkrevd
`name`	`string \| null`	Påkrevd
`kind`	`RecipeSectionKind`	Påkrevd
`ingredients`	`CandidateIngredient[]`	Påkrevd
`steps`	`string[]`	Påkrevd
`timers`	`CandidateStepTimer[] \| null`	Påkrevd
`sourceRecipeId`	`string (uuid) \| null`	Påkrevd
`sourceRecipeTitle`	`string \| null`	Påkrevd

CandidateStepTimer

Felt	Type	Påkrevd
`step`	`integer (int32)`	Påkrevd
`minutes`	`integer (int32)`	Påkrevd
`name`	`string`	Påkrevd

GenerateCandidatesRequest

Felt	Type	Påkrevd
`date`	`string (date)`	Påkrevd
`category`	`MealCategory \| null`	Påkrevd

HomeUseUpBundleQuestion

Felt	Type	Påkrevd
`bundleId`	`string`	Påkrevd
`changes`	`HomeUseUpChange[]`	Påkrevd
`coveredCount`	`integer (int32)`	Påkrevd
`urgentCount`	`integer (int32)`	Påkrevd
`notDinner`	`HomeUseUpFood[]`	Påkrevd
`nextWeek`	`HomeUseUpNextWeek \| null`	—

HomeUseUpChange

Felt	Type	Påkrevd
`id`	`string`	Påkrevd
`day`	`string (date)`	Påkrevd
`kind`	`HomeUseUpChangeKind`	Påkrevd
`recipeId`	`string (uuid) \| null`	Påkrevd
`title`	`string`	Påkrevd
`uses`	`HomeUseUpUse[]`	Påkrevd
`handsBack`	`HomeUseUpUse[]`	Påkrevd
`activeMinutes`	`integer (int32)`	Påkrevd
`shoppingDelta`	`integer (int32)`	Påkrevd

HomeUseUpChangeKind

Type

Verdier

SwapDishAdaptIngredientFillOpenDay

HomeUseUpFood

Felt	Type	Påkrevd
`foodKey`	`string`	Påkrevd
`displayName`	`string`	Påkrevd
`reason`	`HomeUseUpFoodReason`	—

HomeUseUpFoodReason

Type

Verdier

BreadFoodNoRecipeLeftoversNoChangeInTime

Standard "BreadFood"

HomeUseUpNextWeek

Felt	Type	Påkrevd
`changeCount`	`integer (int32)`	Påkrevd
`foodNames`	`string[]`	Påkrevd

HomeUseUpUse

Felt	Type	Påkrevd
`foodKey`	`string`	Påkrevd
`displayName`	`string`	Påkrevd
`quantity`	`number (double) \| null`	Påkrevd
`unit`	`string \| null`	Påkrevd
`usesMostOfIt`	`boolean`	—

MealCandidateResponse

Felt	Type	Påkrevd
`id`	`string (uuid)`	Påkrevd
`householdId`	`string (uuid)`	Påkrevd
`targetDate`	`string (date)`	Påkrevd
`category`	`MealCategory`	Påkrevd
`content`	`CandidateContent`	Påkrevd
`scores`	`map`	Påkrevd
`createdAt`	`string (date-time)`	Påkrevd
`recipeId`	`string (uuid) \| null`	—
`imageUrl`	`string \| null`	—
`price`	`CandidatePrice \| null`	—

MealCategory

Type

Verdier

FishMeatPoultryVegetarianVeganSoupPastaTacoLeftoversOther

PlanRunAccepted

Felt	Type	Påkrevd
`jobId`	`string (uuid)`	Påkrevd
`weekStart`	`string (date)`	Påkrevd

PriceClass

Type

Verdier

CheapMidExpensive

PriceSource

Type

Verdier

ObservedCatalogueTableUnknown

ProblemDetails

Felt	Type	Påkrevd
`type`	`string \| null`	—
`title`	`string \| null`	—
`status`	`integer (int32) \| null`	—
`detail`	`string \| null`	—
`instance`	`string \| null`	—
`code`	`string \| null`	—

RecipeSectionKind

Type

Verdier

OwnLinkedUnresolved