Inntak og venteliste

Om registreringen er åpen, og ventelisten.5 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}/referral-codes

List the referral codes the household's members may hand out

Any member. Minted lazily up to the configured count, single-use, tied to the household. A household on a free plan gets an empty list — referral is a perk of paying.

Parametre

NavnHvorTypePåkrevdBeskrivelse
householdIdpathstring (uuid)Påkrevd—

Svar

200OK
application/jsonReferralCodeResponse[]
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 the server is down for maintenance, 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.
503The server is down for maintenance (#4693). Retry-After says when to try again; problem type maintenance. Every call under /api answers this while maintenance mode is on, the version floor included.
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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/referral-codes"

Eksempel på svar

200application/json
[
  {
    "code": "string",
    "maxUses": 0,
    "uses": 0,
    "expiresAt": "2026-09-07T16:30:00Z"
  }
]
GET/api/v1/intakeTrenger ingen sesjon

Read whether sign-up is open, invite-only or paused

Public — the sign-up screen asks before anyone has an account (ADR-025, #603). Cached for 60 seconds by the caller only (Cache-Control: private, max-age=60), because country is the ISO 3166-1 alpha-2 code Cloudflare places the request in, null when not known; the create form starts on it (#5124). storeLinks carries the App Store and Google Play listings the owner has set (Landing__StoreLinks__Ios/Android); each is null until set (#3486).

Parametre

Ingen parametre

Svar

200OK
application/jsonIntakeStatusResponse
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 the server is down for maintenance, 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.
503The server is down for maintenance (#4693). Retry-After says when to try again; problem type maintenance. Every call under /api answers this while maintenance mode is on, the version floor included.
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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 \
  "https://bryti.app/api/v1/intake"

Eksempel på svar

200application/json
{
  "mode": "string",
  "storeLinks": {
    "ios": "string",
    "android": "string"
  }
}
POST/api/v1/intake/waitlistTrenger ingen sesjon

Join the waitlist by e-mail, before having an account

Public (ADR-147). Always 202 whatever the list already knew about the address — a duplicate, a rejected address and a cooled-down resend all look the same, so the list never becomes a directory. A confirmation mail goes out for a new entry, and again for an unconfirmed one at most once a day; an unconfirmed entry past seven days is replaced. country is where the person lives (ISO 3166-1 alpha-2), else the region Accept-Language names; a country Bryti does not serve yet is named in the mail, and such entries wait out the owner's batch release until the country opens (#4993). source is the tag of the link the landing page was opened from (utm_source, utm_campaign or ref), kept on a new or unconfirmed entry and dropped when it is not a short tag (#4460). 400 only for the caller's own input (no «@», a note over 280 characters). Rate-limited per IP (intake-per-ip, 5 an hour by default): 429 with Retry-After.

Parametre

Ingen parametre

Forespørselskropp

application/jsonPåkrevdJoinWaitlistRequest

Svar

202Accepted
400Bad Request
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 Requests
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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.
503The server is down for maintenance (#4693). Retry-After says when to try again; problem type maintenance. Every call under /api answers this while maintenance mode is on, the version floor included.
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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 \
  -X POST \
  "https://bryti.app/api/v1/intake/waitlist" \
  -H "Content-Type: application/json" \
  -d '{"email":"string","note":"string"}'
POST/api/v1/intake/waitlist/me

Put the signed-in caller on the waitlist

Any signed-in user, no household needed — the «Opprett husholdning» screen while intake is paused (ADR-025). The account vouches for the address, so no confirmation mail. Safe to retry: one place per user, and an entry that joined by e-mail earlier becomes this user's. country (ISO 3166-1 alpha-2, optional) is where the user wants Bryti: the settings screen sends it after a move to a country Bryti does not serve was refused (#5103); a row that has one keeps the newest.

Parametre

NavnHvorTypePåkrevdBeskrivelse
countryquerystring——

Svar

200OK
application/jsonWaitlistEntryResponse
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
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 the server is down for maintenance, 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.
503The server is down for maintenance (#4693). Retry-After says when to try again; problem type maintenance. Every call under /api answers this while maintenance mode is on, the version floor included.
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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/intake/waitlist/me"

Eksempel på svar

200application/json
{
  "email": "string",
  "joinedAt": "2026-09-07T16:30:00Z",
  "invited": false
}
GET/api/v1/intake/waitlist/confirmTrenger ingen sesjon

Confirm a waitlist address from the link in the mail

Public — the link opens in a browser that has never seen Bryti. Safe to retry: a second click is still confirmed. 404 (code waitlist_token_unknown) when no entry carries the token; 410 (code waitlist_token_expired) when the entry outlived its seven days unconfirmed — join again for a new link.

Parametre

NavnHvorTypePåkrevdBeskrivelse
tokenquerystring——

Svar

200OK
application/jsonWaitlistConfirmationResponse
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
404Not Found
application/problem+jsonProblemDetails
410Gone
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 the server is down for maintenance, 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.
503The server is down for maintenance (#4693). Retry-After says when to try again; problem type maintenance. Every call under /api answers this while maintenance mode is on, the version floor included.
application/problem+jsonProblemDetails
Hoder
Retry-After
— Seconds to wait when a rate limit answered or the server is down for maintenance, 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.

Problemkoder

`code` i problemkroppen er den du forgreiner på. `detail` er engelsk, skrevet for loggen.

waitlist_token_expired
— Invitasjonslenken er utløpt. Be om en ny.
waitlist_token_unknown
— Den invitasjonslenken er ukjent. Be om en ny.

Eksempel

curl \
  "https://bryti.app/api/v1/intake/waitlist/confirm"

Eksempel på svar

200application/json
{
  "confirmed": false
}

Skjema

IntakeStatusResponse

FeltTypePåkrevd
modestringPåkrevd
storeLinksStoreLinksResponsePåkrevd
countrystring | null—

JoinWaitlistRequest

FeltTypePåkrevd
emailstringPåkrevd
notestring | nullPåkrevd
countrystring | null—
sourcestring | null—

ProblemDetails

FeltTypePåkrevd
typestring | null—
titlestring | null—
statusinteger (int32) | null—
detailstring | null—
instancestring | null—
codestring | null—

ReferralCodeResponse

FeltTypePåkrevd
codestringPåkrevd
maxUsesinteger (int32)Påkrevd
usesinteger (int32)Påkrevd
expiresAtstring (date-time) | nullPåkrevd

StoreLinksResponse

FeltTypePåkrevd
iosstring | nullPåkrevd
androidstring | nullPåkrevd

WaitlistConfirmationResponse

FeltTypePåkrevd
confirmedbooleanPåkrevd

WaitlistEntryResponse

FeltTypePåkrevd
emailstringPåkrevd
joinedAtstring (date-time)Påkrevd
invitedbooleanPåkrevd