Regler

Husholdningens regler for måltidene, som ukeplanen tar hensyn til.6 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

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

List the household's meal rules

Parametre

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

Svar

200OK

application/jsonMealRuleResponse[]

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

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=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/rules"

Eksempel på svar

200application/json

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "kind": "CategoryFrequency",
    "strength": "Hard",
    "scope": "Permanent",
    "startDate": "2026-09-07",
    "endDate": "2026-09-07",
    "source": "UserDeclared",
    "payload": {},
    "createdAt": "2026-09-07T16:30:00Z",
    "updatedAt": "2026-09-07T16:30:00Z"
  }
]

POST/api/v1/households/{householdId}/rules

Add a meal rule

Adults only; a Junior member gets 403. payload is a union on kind: CategoryFrequency, CategoryExcludedDays, CategoryOnDay, MaximumActiveCookingTime, DinnerTimeOnWeekday, PriceClassOnDays or RepeatAfterDays.

Parametre

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

Forespørselskropp

application/jsonPåkrevdCreateMealRuleRequest

Svar

201Created

application/jsonMealRuleResponse

400Bad Request

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=…" \
  -X POST \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/rules" \
  -H "Content-Type: application/json" \
  -d '{"payload":{},"strength":"Hard","scope":"Permanent","startDate":"2026-09-07","endDate":"2026-09-07"}'

Eksempel på svar

201application/json

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "kind": "CategoryFrequency",
  "strength": "Hard",
  "scope": "Permanent",
  "startDate": "2026-09-07",
  "endDate": "2026-09-07",
  "source": "UserDeclared",
  "payload": {},
  "createdAt": "2026-09-07T16:30:00Z",
  "updatedAt": "2026-09-07T16:30:00Z"
}

GET/api/v1/households/{householdId}/rules/defaults

Get the national-guideline default rules and whether they apply right now

Defaults for the household's country (source Helsedirektoratet), with synthetic ids and never stored. Active while the household has no frequency rules of its own.

Parametre

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

Svar

200OK

application/jsonDefaultRulesResponse

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/rules/defaults"

Eksempel på svar

200application/json

{
  "active": false,
  "source": "string",
  "rules": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "kind": {},
      "strength": {},
      "scope": {},
      "startDate": "2026-09-07",
      "endDate": "2026-09-07",
      "source": {},
      "payload": {},
      "createdAt": "2026-09-07T16:30:00Z",
      "updatedAt": "2026-09-07T16:30:00Z"
    }
  ]
}

POST/api/v1/households/{householdId}/rules/parse

Turn a sentence into rule suggestions without saving anything

Adults only; a Junior member gets 403. «Fisk to ganger i uken, men ikke fredag» comes back as proposals, each with the CreateMealRuleRequest that files it — nothing is stored until the household POSTs it (#418). An empty sentence, or one with no rule in it, answers an empty list. Costs one chat turn of credits; 429 with code quota_exceeded when the household's AI allowance is used up.

Parametre

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

Forespørselskropp

application/jsonPåkrevdParseRulesRequest

Svar

200OK

application/jsonParseRulesResponse

400Bad Request

application/problem+jsonProblemDetails

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

application/problem+jsonProblemDetails

404Not Found

application/problem+jsonProblemDetails

429Too Many Requests

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/rules/parse" \
  -H "Content-Type: application/json" \
  -d '{"text":"string"}'

Eksempel på svar

200application/json

{
  "proposals": [
    {
      "summary": "string",
      "request": {}
    }
  ],
  "leftoverDinners": {
    "summary": "string",
    "enabled": false,
    "askedEveryDays": 0
  },
  "unheard": [
    "string"
  ]
}

PATCH/api/v1/households/{householdId}/rules/{ruleId}

Replace a meal rule's payload, strength, scope and dates

Adults only; a Junior member gets 403. A full replacement despite the PATCH verb: every field is written.

Parametre

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

Forespørselskropp

application/jsonPåkrevdUpdateMealRuleRequest

Svar

200OK

application/jsonMealRuleResponse

400Bad Request

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=…" \
  -X PATCH \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/rules/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Content-Type: application/json" \
  -d '{"payload":{},"strength":"Hard","scope":"Permanent","startDate":"2026-09-07","endDate":"2026-09-07"}'

Eksempel på svar

200application/json

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "householdId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "kind": "CategoryFrequency",
  "strength": "Hard",
  "scope": "Permanent",
  "startDate": "2026-09-07",
  "endDate": "2026-09-07",
  "source": "UserDeclared",
  "payload": {},
  "createdAt": "2026-09-07T16:30:00Z",
  "updatedAt": "2026-09-07T16:30:00Z"
}

DELETE/api/v1/households/{householdId}/rules/{ruleId}

Remove a meal rule

Adults only; a Junior member gets 403.

Parametre

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

Svar

204No Content

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=…" \
  -X DELETE \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/rules/3fa85f64-5717-4562-b3fc-2c963f66afa6"

Skjema

CreateMealRuleRequest

Felt	Type	Påkrevd
`payload`	`MealRulePayloadDto`	Påkrevd
`strength`	`RuleStrength`	Påkrevd
`scope`	`RuleScope`	Påkrevd
`startDate`	`string (date) \| null`	Påkrevd
`endDate`	`string (date) \| null`	Påkrevd

DefaultRulesResponse

Felt	Type	Påkrevd
`active`	`boolean`	Påkrevd
`source`	`string`	Påkrevd
`rules`	`MealRuleResponse[]`	Påkrevd

MealCategory

Type

Verdier

FishMeatPoultryVegetarianVeganSoupPastaTacoLeftoversOther

MealRuleKind

Type

Verdier

CategoryFrequencyCategoryExcludedDaysCategoryOnDayMaximumActiveCookingTimeDinnerTimeOnWeekdayPriceClassOnDaysRepeatAfterDays

MealRulePayloadDto

Type

Én av

MealRulePayloadDtoCategoryFrequencyRulePayload
MealRulePayloadDtoCategoryExcludedDaysRulePayload
MealRulePayloadDtoCategoryOnDayRulePayload
MealRulePayloadDtoMaximumActiveCookingTimeRulePayload
MealRulePayloadDtoDinnerTimeOnWeekdayRulePayload
MealRulePayloadDtoPriceClassOnDaysRulePayload
MealRulePayloadDtoRepeatAfterDaysRulePayload

Skilles på kind

"CategoryFrequency" → MealRulePayloadDtoCategoryFrequencyRulePayload
"CategoryExcludedDays" → MealRulePayloadDtoCategoryExcludedDaysRulePayload
"CategoryOnDay" → MealRulePayloadDtoCategoryOnDayRulePayload
"MaximumActiveCookingTime" → MealRulePayloadDtoMaximumActiveCookingTimeRulePayload
"DinnerTimeOnWeekday" → MealRulePayloadDtoDinnerTimeOnWeekdayRulePayload
"PriceClassOnDays" → MealRulePayloadDtoPriceClassOnDaysRulePayload
"RepeatAfterDays" → MealRulePayloadDtoRepeatAfterDaysRulePayload

MealRulePayloadDtoCategoryExcludedDaysRulePayload

Felt	Type	Påkrevd
`kind`	`"CategoryExcludedDays"`	—
`category`	`MealCategory`	Påkrevd
`excludedWeekdays`	`Weekday[]`	Påkrevd

MealRulePayloadDtoCategoryFrequencyRulePayload

Felt	Type	Påkrevd
`kind`	`"CategoryFrequency"`	—
`category`	`MealCategory`	Påkrevd
`minimumPerWeek`	`integer (int32)`	Påkrevd
`maximumPerWeek`	`integer (int32)`	Påkrevd

MealRulePayloadDtoCategoryOnDayRulePayload

Felt	Type	Påkrevd
`kind`	`"CategoryOnDay"`	—
`category`	`MealCategory`	Påkrevd
`weekday`	`Weekday \| null`	Påkrevd
`specificDate`	`string (date) \| null`	Påkrevd

MealRulePayloadDtoDinnerTimeOnWeekdayRulePayload

Felt	Type	Påkrevd
`kind`	`"DinnerTimeOnWeekday"`	—
`time`	`string`	Påkrevd
`weekdays`	`Weekday[]`	Påkrevd

MealRulePayloadDtoMaximumActiveCookingTimeRulePayload

Felt	Type	Påkrevd
`kind`	`"MaximumActiveCookingTime"`	—
`minutes`	`integer (int32)`	Påkrevd
`weekdays`	`Weekday[]`	Påkrevd
`specificDate`	`string (date) \| null`	Påkrevd

MealRulePayloadDtoPriceClassOnDaysRulePayload

Felt	Type	Påkrevd
`kind`	`"PriceClassOnDays"`	—
`ceiling`	`PriceCeiling`	Påkrevd
`weekdays`	`Weekday[]`	Påkrevd

MealRulePayloadDtoRepeatAfterDaysRulePayload

Felt	Type	Påkrevd
`kind`	`"RepeatAfterDays"`	—
`days`	`integer (int32)`	Påkrevd

MealRuleResponse

Felt	Type	Påkrevd
`id`	`string (uuid)`	Påkrevd
`householdId`	`string (uuid)`	Påkrevd
`kind`	`MealRuleKind`	Påkrevd
`strength`	`RuleStrength`	Påkrevd
`scope`	`RuleScope`	Påkrevd
`startDate`	`string (date) \| null`	Påkrevd
`endDate`	`string (date) \| null`	Påkrevd
`source`	`RuleSource`	Påkrevd
`payload`	`MealRulePayloadDto`	Påkrevd
`createdAt`	`string (date-time)`	Påkrevd
`updatedAt`	`string (date-time)`	Påkrevd

ParsedLeftoverDinners

Felt	Type	Påkrevd
`summary`	`string`	Påkrevd
`enabled`	`boolean`	Påkrevd
`askedEveryDays`	`integer (int32) \| null`	Påkrevd

ParsedRuleProposal

Felt	Type	Påkrevd
`summary`	`string`	Påkrevd
`request`	`CreateMealRuleRequest`	Påkrevd

ParseRulesRequest

Felt	Type	Påkrevd
`text`	`string`	Påkrevd

ParseRulesResponse

Felt	Type	Påkrevd
`proposals`	`ParsedRuleProposal[]`	Påkrevd
`leftoverDinners`	`ParsedLeftoverDinners \| null`	Påkrevd
`unheard`	`string[]`	Påkrevd

PriceCeiling

Type

Verdier

CheapCheapOrMid

ProblemDetails

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

RuleScope

Type

Verdier

PermanentDateRangeSpecificDate

RuleSource

Type

Verdier

UserDeclaredSystemDefaultLearned

RuleStrength

Type

Verdier

HardSoft

UpdateMealRuleRequest

Felt	Type	Påkrevd
`payload`	`MealRulePayloadDto`	Påkrevd
`strength`	`RuleStrength`	Påkrevd
`scope`	`RuleScope`	Påkrevd
`startDate`	`string (date) \| null`	Påkrevd
`endDate`	`string (date) \| null`	Påkrevd

Weekday

Type

Verdier

SundayMondayTuesdayWednesdayThursdayFridaySaturday