Egen assistent

Koble til en assistent du bruker selv, og se hvilke som har tilgang.14 operasjoner

Operasjoner

GET/.well-known/oauth-authorization-serverTrenger ingen sesjon

Describe Bryti's OAuth authorization server (RFC 8414)

Public. The issuer, the authorize, token, registration and revocation endpoints, an empty jwks_uri, PKCE S256, public clients and private_key_jwt (RS256, ES256) at the token endpoint, client ID metadata documents, and the four scopes.

Parametre

Ingen parametre

Svar

200OK
application/jsonAuthorizationServerMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/.well-known/oauth-authorization-server"

Eksempel på svar

200application/json
{
  "issuer": "string",
  "authorization_endpoint": "string",
  "token_endpoint": "string",
  "registration_endpoint": "string",
  "revocation_endpoint": "string",
  "jwks_uri": "string",
  "response_types_supported": [
    "string"
  ],
  "grant_types_supported": [
    "string"
  ],
  "code_challenge_methods_supported": [
    "string"
  ],
  "token_endpoint_auth_methods_supported": [
    "string"
  ],
  "token_endpoint_auth_signing_alg_values_supported": [
    "string"
  ],
  "revocation_endpoint_auth_methods_supported": [
    "string"
  ],
  "client_id_metadata_document_supported": false,
  "scopes_supported": [
    "string"
  ],
  "authorization_response_iss_parameter_supported": false,
  "service_documentation": "string"
}
GET/.well-known/oauth-protected-resource/mcpTrenger ingen sesjon

Describe the MCP endpoint as a protected resource (RFC 9728)

Public. The MCP endpoint's canonical URL, the authorization server that issues its tokens, and that a token travels in the Authorization header.

Parametre

Ingen parametre

Svar

200OK
application/jsonProtectedResourceMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/.well-known/oauth-protected-resource/mcp"

Eksempel på svar

200application/json
{
  "resource": "string",
  "authorization_servers": [
    "string"
  ],
  "scopes_supported": [
    "string"
  ],
  "bearer_methods_supported": [
    "string"
  ],
  "resource_name": "string",
  "resource_documentation": "string"
}
GET/.well-known/oauth-protected-resourceTrenger ingen sesjon

Describe the MCP endpoint as a protected resource (RFC 9728)

Public. The MCP endpoint's canonical URL, the authorization server that issues its tokens, and that a token travels in the Authorization header.

Parametre

Ingen parametre

Svar

200OK
application/jsonProtectedResourceMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/.well-known/oauth-protected-resource"

Eksempel på svar

200application/json
{
  "resource": "string",
  "authorization_servers": [
    "string"
  ],
  "scopes_supported": [
    "string"
  ],
  "bearer_methods_supported": [
    "string"
  ],
  "resource_name": "string",
  "resource_documentation": "string"
}
POST/oauth/registerTrenger ingen sesjon

Register an assistant as a public OAuth client (RFC 7591)

Public, 120 an hour per address. Redirect URIs must be https or loopback http, and token_endpoint_auth_method must be none. 400 invalid_client_metadata otherwise. Registering grants nothing: a member still has to say yes.

Parametre

Ingen parametre

Forespørselskropp

application/jsonPåkrevdClientRegistrationRequest

Svar

201Created
application/jsonClientRegistrationResponse
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/oauth/register" \
  -H "Content-Type: application/json" \
  -d '{"client_name":"string","redirect_uris":["string"],"grant_types":["string"],"response_types":["string"],"token_endpoint_auth_method":"string","software_id":"string","software_version":"string"}'

Eksempel på svar

201application/json
{
  "client_id": "string",
  "client_name": "string",
  "redirect_uris": [
    "string"
  ],
  "grant_types": [
    "string"
  ],
  "response_types": [
    "string"
  ],
  "token_endpoint_auth_method": "string",
  "client_id_issued_at": 0
}
GET/oauth/authorizeTrenger ingen sesjon

Start an assistant's authorization: send the member to the consent page

Public. PKCE S256 is required. An unknown client or a redirect_uri the client did not register is a 400 in plain text, never a redirect. Other errors go back to the redirect_uri with error, state and iss. Otherwise 302 to the web's consent page with the stored request's id.

Parametre

NavnHvorTypePåkrevdBeskrivelse
response_typequerystring——
client_idquerystring——
redirect_uriquerystring——
statequerystring——
code_challengequerystring——
code_challenge_methodquerystring——
scopequerystring——
resourcequerystring——

Svar

302Found
400Bad Request
text/plainstring
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/oauth/authorize"
POST/oauth/tokenTrenger ingen sesjon

Trade an authorization code or a refresh token for tokens, as a public client or with private_key_jwt

Public, form-encoded. authorization_code needs the PKCE verifier and the same client_id and redirect_uri; refresh_token rotates, and a rotated token used again revokes the whole grant. A client whose metadata document publishes a jwks_uri may also send client_assertion_type (jwt-bearer) and a client_assertion signed RS256 or ES256 (private_key_jwt, RFC 7523): iss and sub the client_id, aud the token endpoint, exp required, jti once; one that offers only private_key_jwt must. 400 with an RFC 6749 error (invalid_client, invalid_grant, invalid_request, invalid_target, unsupported_grant_type); a JSON body is invalid_request. 300 a minute per address, and 30 failed exchanges a minute per registered client_id — a valid code or refresh token is never held by them (a metadata-URL client_id is shared by every member, so it has no bucket of its own); past that 429 temporarily_unavailable with Retry-After. Cache-Control: no-store.

Parametre

Ingen parametre

Forespørselskropp

application/x-www-form-urlencodedPåkrevdOAuthTokenForm

Svar

200OK
application/jsonOAuthTokenResponse
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d '{"grant_type":"string","code":"string","code_verifier":"string","redirect_uri":"string","client_id":"string","resource":"string","refresh_token":"string","client_assertion_type":"string","client_assertion":"string"}'

Eksempel på svar

200application/json
{
  "access_token": "string",
  "token_type": "string",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string"
}
POST/oauth/revokeTrenger ingen sesjon

Let an assistant hand a token back (RFC 7009)

Public, form-encoded: token, client_id, and token_type_hint if the client likes. A refresh token ends the whole connection and every token under it; an access token ends only itself. Always 200 with an empty body, whether or not the token existed or belonged to this client_id, so nobody learns which tokens exist. 400 unsupported_token_type for a hint other than access_token or refresh_token, invalid_request without token or client_id. Cache-Control: no-store.

Parametre

Ingen parametre

Forespørselskropp

application/x-www-form-urlencodedPåkrevdOAuthRevocationForm

Svar

200OK
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/oauth/revoke" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d '{"token":"string","token_type_hint":"string","client_id":"string"}'
GET/.well-known/jwks.jsonTrenger ingen sesjon

Publish the authorization server's signing keys: none, so an empty set

Public. Always an empty keys array: tokens are opaque and nothing is signed. The document exists because discovery checkers expect jwks_uri. Cached an hour.

Parametre

Ingen parametre

Svar

200OK
application/jsonJsonWebKeySet
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/.well-known/jwks.json"

Eksempel på svar

200application/json
{
  "keys": [
    {
      "kty": "string",
      "kid": "string"
    }
  ]
}
GET/.well-known/openai-apps-challengeTrenger ingen sesjon

Answer OpenAI's domain check with the token its portal handed out

Public. The token from AgentAccess:OpenAiAppsChallenge as plain text, so OpenAI's plugin review can see that Bryti owns the domain the MCP server runs on. 404 when the token is not set.

Parametre

Ingen parametre

Svar

200OK
text/plainstring
404Not Found
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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/.well-known/openai-apps-challenge"
GET/api/v1/agent-access/requests/{requestId}

Show what an assistant asks to read, for the consent page

The signed-in member. The assistant's name, the host it sends the member back to, the scopes and the households the member may connect (junior households left out). 404 when unknown, expired or answered; 403 not_a_member when the member belongs to no household, junior_forbidden when the member is junior everywhere.

Parametre

NavnHvorTypePåkrevdBeskrivelse
requestIdpathstring (uuid)Påkrevd—

Svar

200OK
application/jsonAgentAccessRequestResponse
Hoder
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).
401No session, or the session is no longer valid.
application/problem+jsonProblemDetails
Hoder
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).
403Forbidden
application/problem+jsonProblemDetails
Hoder
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).
404Not Found
application/problem+jsonProblemDetails
Hoder
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).
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
Hoder
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).
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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
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).
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/agent-access/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6"

Eksempel på svar

200application/json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "clientName": "string",
  "clientId": "string",
  "redirectHost": "string",
  "scopes": [
    "string"
  ],
  "healthDataRequested": false,
  "households": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "role": {},
      "planCode": "free",
      "assistant": "none"
    }
  ],
  "expiresAt": "2026-09-07T16:30:00Z",
  "writeRequested": false
}
POST/api/v1/agent-access/requests/{requestId}/decision

Say yes or no to an assistant, and get the address to send the browser to

Owner or adult in the chosen household. A yes makes the grant and returns the assistant's redirect URI with a code, state and iss; health:read only when ShareHealthData. A no returns it with error=access_denied. 400 when several households and none picked; 403 junior_forbidden, or not_a_member (also when the member belongs to no household); 404 when unknown, expired or answered already.

Parametre

NavnHvorTypePåkrevdBeskrivelse
requestIdpathstring (uuid)Påkrevd—

Forespørselskropp

application/jsonPåkrevdAgentAccessDecisionRequest

Svar

200OK
application/jsonAgentAccessDecisionResponse
Hoder
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).
400Bad Request
application/problem+jsonProblemDetails
Hoder
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).
401No session, or the session is no longer valid.
application/problem+jsonProblemDetails
Hoder
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).
403Forbidden
application/problem+jsonProblemDetails
Hoder
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).
404Not Found
application/problem+jsonProblemDetails
Hoder
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).
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
Hoder
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).
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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
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).
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/agent-access/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6/decision" \
  -H "Content-Type: application/json" \
  -d '{"approve":false,"householdId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","shareHealthData":false}'

Eksempel på svar

200application/json
{
  "redirectUrl": "string"
}
GET/api/v1/households/{householdId}/agent-access

List the assistants the member has connected to the household

Any member: her own connections. The owner: the whole household's, each other member's with grantedByName. Name, host, scopes, read or write access, when it was connected and when it last read anything, and the last three changes it made with a count for the last 90 days.

Parametre

NavnHvorTypePåkrevdBeskrivelse
householdIdpathstring (uuid)Påkrevd—

Svar

200OK
application/jsonAgentGrantResponse[]
Hoder
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).
401No session, or the session is no longer valid.
application/problem+jsonProblemDetails
Hoder
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).
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
Hoder
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).
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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
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).
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/agent-access"

Eksempel på svar

200application/json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "clientName": "string",
    "clientHost": "string",
    "scopes": [
      "string"
    ],
    "createdAt": "2026-09-07T16:30:00Z",
    "lastUsedAt": "2026-09-07T16:30:00Z",
    "grantedByName": "string",
    "access": "read",
    "activityCount": 0
  }
]
GET/api/v1/households/{householdId}/agent-access/{grantId}/activity

List what a connected assistant changed in the household

The last 100 changes, newest first: when, which tool, Bryti's own sentence about it and where in the app it is. Any member for her own connections; the owner for anyone's. 404 for an unknown grant or one the caller may not see.

Parametre

NavnHvorTypePåkrevdBeskrivelse
householdIdpathstring (uuid)Påkrevd—
grantIdpathstring (uuid)Påkrevd—

Svar

200OK
application/jsonAgentActivityResponse[]
Hoder
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).
401No session, or the session is no longer valid.
application/problem+jsonProblemDetails
Hoder
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).
404Not Found
application/problem+jsonProblemDetails
Hoder
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).
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
Hoder
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).
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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
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).
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/agent-access/3fa85f64-5717-4562-b3fc-2c963f66afa6/activity"

Eksempel på svar

200application/json
[
  {
    "at": "2026-09-07T16:30:00Z",
    "tool": "string",
    "summary": "string",
    "link": "string"
  }
]
DELETE/api/v1/households/{householdId}/agent-access/{grantId}

Disconnect an assistant: its tokens stop working at once

Any member for her own connections; the owner for anyone's in the household. 404 for an unknown grant or one the caller may not remove.

Parametre

NavnHvorTypePåkrevdBeskrivelse
householdIdpathstring (uuid)Påkrevd—
grantIdpathstring (uuid)Påkrevd—

Svar

204No Content
Hoder
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).
401No session, or the session is no longer valid.
application/problem+jsonProblemDetails
Hoder
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).
404Not Found
application/problem+jsonProblemDetails
Hoder
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).
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
Hoder
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).
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Hoder
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).
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
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).
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 DELETE \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/agent-access/3fa85f64-5717-4562-b3fc-2c963f66afa6"

Skjema

AgentAccessDecisionRequest

FeltTypePåkrevd
approvebooleanPåkrevd
householdIdstring (uuid) | nullPåkrevd
shareHealthDatabooleanPåkrevd

AgentAccessDecisionResponse

FeltTypePåkrevd
redirectUrlstringPåkrevd

AgentAccessHouseholdOption

FeltTypePåkrevd
idstring (uuid)Påkrevd
namestringPåkrevd
roleHouseholdRolePåkrevd
planCodestring—
assistantstring—

AgentAccessRequestResponse

FeltTypePåkrevd
idstring (uuid)Påkrevd
clientNamestringPåkrevd
clientIdstringPåkrevd
redirectHoststringPåkrevd
scopesstring[]Påkrevd
healthDataRequestedbooleanPåkrevd
householdsAgentAccessHouseholdOption[]Påkrevd
expiresAtstring (date-time)Påkrevd
writeRequestedboolean—

AgentActivityResponse

FeltTypePåkrevd
atstring (date-time)Påkrevd
toolstringPåkrevd
summarystringPåkrevd
linkstring | nullPåkrevd

AgentGrantResponse

FeltTypePåkrevd
idstring (uuid)Påkrevd
clientNamestringPåkrevd
clientHoststringPåkrevd
scopesstring[]Påkrevd
createdAtstring (date-time)Påkrevd
lastUsedAtstring (date-time) | nullPåkrevd
grantedByNamestring | nullPåkrevd
accessstring—
activityAgentActivityResponse[] | null—
activityCountinteger (int32)—

AuthorizationServerMetadata

FeltTypePåkrevd
issuerstringPåkrevd
authorization_endpointstringPåkrevd
token_endpointstringPåkrevd
registration_endpointstringPåkrevd
revocation_endpointstringPåkrevd
jwks_uristringPåkrevd
response_types_supportedstring[]Påkrevd
grant_types_supportedstring[]Påkrevd
code_challenge_methods_supportedstring[]Påkrevd
token_endpoint_auth_methods_supportedstring[]Påkrevd
token_endpoint_auth_signing_alg_values_supportedstring[]Påkrevd
revocation_endpoint_auth_methods_supportedstring[]Påkrevd
client_id_metadata_document_supportedbooleanPåkrevd
scopes_supportedstring[]Påkrevd
authorization_response_iss_parameter_supportedbooleanPåkrevd
service_documentationstringPåkrevd

ClientRegistrationRequest

FeltTypePåkrevd
client_namestring | nullPåkrevd
redirect_urisstring[] | nullPåkrevd
grant_typesstring[] | nullPåkrevd
response_typesstring[] | nullPåkrevd
token_endpoint_auth_methodstring | nullPåkrevd
software_idstring | nullPåkrevd
software_versionstring | nullPåkrevd

ClientRegistrationResponse

FeltTypePåkrevd
client_idstringPåkrevd
client_namestringPåkrevd
redirect_urisstring[]Påkrevd
grant_typesstring[]Påkrevd
response_typesstring[]Påkrevd
token_endpoint_auth_methodstringPåkrevd
client_id_issued_atinteger (int64)Påkrevd

HouseholdRole

Type

Verdier

OwnerAdultJunior

JsonWebKey

FeltTypePåkrevd
ktystringPåkrevd
kidstringPåkrevd

JsonWebKeySet

FeltTypePåkrevd
keysJsonWebKey[]Påkrevd

OAuthErrorResponse

FeltTypePåkrevd
errorstringPåkrevd
error_descriptionstring | nullPåkrevd

OAuthRevocationForm

FeltTypePåkrevd
tokenstringPåkrevd
token_type_hintstring | nullPåkrevd
client_idstringPåkrevd

OAuthTokenForm

FeltTypePåkrevd
grant_typestringPåkrevd
codestring | nullPåkrevd
code_verifierstring | nullPåkrevd
redirect_uristring | nullPåkrevd
client_idstring | nullPåkrevd
resourcestring | nullPåkrevd
refresh_tokenstring | nullPåkrevd
client_assertion_typestring | nullPåkrevd
client_assertionstring | nullPåkrevd

OAuthTokenResponse

FeltTypePåkrevd
access_tokenstringPåkrevd
token_typestringPåkrevd
expires_ininteger (int32)Påkrevd
refresh_tokenstringPåkrevd
scopestringPåkrevd

ProblemDetails

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

ProtectedResourceMetadata

FeltTypePåkrevd
resourcestringPåkrevd
authorization_serversstring[]Påkrevd
scopes_supportedstring[]Påkrevd
bearer_methods_supportedstring[]Påkrevd
resource_namestringPåkrevd
resource_documentationstringPåkrevd