Agent access

Connect your own assistant to Bryti, and see which ones can read.14 operations

Operations

GET/.well-known/oauth-authorization-serverNo session needed

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.

Parameters

No parameters

Responses

200OK
application/jsonAuthorizationServerMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

curl \
  "https://bryti.app/.well-known/oauth-authorization-server"

Example response

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/mcpNo session needed

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.

Parameters

No parameters

Responses

200OK
application/jsonProtectedResourceMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

curl \
  "https://bryti.app/.well-known/oauth-protected-resource/mcp"

Example response

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-resourceNo session needed

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.

Parameters

No parameters

Responses

200OK
application/jsonProtectedResourceMetadata
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

curl \
  "https://bryti.app/.well-known/oauth-protected-resource"

Example response

200application/json
{
  "resource": "string",
  "authorization_servers": [
    "string"
  ],
  "scopes_supported": [
    "string"
  ],
  "bearer_methods_supported": [
    "string"
  ],
  "resource_name": "string",
  "resource_documentation": "string"
}
POST/oauth/registerNo session needed

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.

Parameters

No parameters

Request body

application/jsonRequiredClientRegistrationRequest

Responses

201Created
application/jsonClientRegistrationResponse
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

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"}'

Example response

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/authorizeNo session needed

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.

Parameters

NameInTypeRequiredDescription
response_typequerystring——
client_idquerystring——
redirect_uriquerystring——
statequerystring——
code_challengequerystring——
code_challenge_methodquerystring——
scopequerystring——
resourcequerystring——

Responses

302Found
400Bad Request
text/plainstring
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

curl \
  "https://bryti.app/oauth/authorize"
POST/oauth/tokenNo session needed

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.

Parameters

No parameters

Request body

application/x-www-form-urlencodedRequiredOAuthTokenForm

Responses

200OK
application/jsonOAuthTokenResponse
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

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"}'

Example response

200application/json
{
  "access_token": "string",
  "token_type": "string",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string"
}
POST/oauth/revokeNo session needed

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.

Parameters

No parameters

Request body

application/x-www-form-urlencodedRequiredOAuthRevocationForm

Responses

200OK
400Bad Request
application/jsonOAuthErrorResponse
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

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.jsonNo session needed

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.

Parameters

No parameters

Responses

200OK
application/jsonJsonWebKeySet
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

curl \
  "https://bryti.app/.well-known/jwks.json"

Example response

200application/json
{
  "keys": [
    {
      "kty": "string",
      "kid": "string"
    }
  ]
}
GET/.well-known/openai-apps-challengeNo session needed

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.

Parameters

No parameters

Responses

200OK
text/plainstring
404Not Found
429Too many calls in the window; Retry-After says how long.
application/problem+jsonProblemDetails
Headers
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.

Example

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.

Parameters

NameInTypeRequiredDescription
requestIdpathstring (uuid)Required—

Responses

200OK
application/jsonAgentAccessRequestResponse
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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.

Example

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/agent-access/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6"

Example response

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.

Parameters

NameInTypeRequiredDescription
requestIdpathstring (uuid)Required—

Request body

application/jsonRequiredAgentAccessDecisionRequest

Responses

200OK
application/jsonAgentAccessDecisionResponse
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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.

Example

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}'

Example response

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.

Parameters

NameInTypeRequiredDescription
householdIdpathstring (uuid)Required—

Responses

200OK
application/jsonAgentGrantResponse[]
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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.

Example

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/agent-access"

Example response

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.

Parameters

NameInTypeRequiredDescription
householdIdpathstring (uuid)Required—
grantIdpathstring (uuid)Required—

Responses

200OK
application/jsonAgentActivityResponse[]
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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.

Example

curl -b "bryti_session=…" \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/agent-access/3fa85f64-5717-4562-b3fc-2c963f66afa6/activity"

Example response

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.

Parameters

NameInTypeRequiredDescription
householdIdpathstring (uuid)Required—
grantIdpathstring (uuid)Required—

Responses

204No Content
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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
Headers
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.

Example

curl -b "bryti_session=…" \
  -X DELETE \
  "https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/agent-access/3fa85f64-5717-4562-b3fc-2c963f66afa6"

Schemas

AgentAccessDecisionRequest

PropertyTypeRequired
approvebooleanRequired
householdIdstring (uuid) | nullRequired
shareHealthDatabooleanRequired

AgentAccessDecisionResponse

PropertyTypeRequired
redirectUrlstringRequired

AgentAccessHouseholdOption

PropertyTypeRequired
idstring (uuid)Required
namestringRequired
roleHouseholdRoleRequired
planCodestring—
assistantstring—

AgentAccessRequestResponse

PropertyTypeRequired
idstring (uuid)Required
clientNamestringRequired
clientIdstringRequired
redirectHoststringRequired
scopesstring[]Required
healthDataRequestedbooleanRequired
householdsAgentAccessHouseholdOption[]Required
expiresAtstring (date-time)Required
writeRequestedboolean—

AgentActivityResponse

PropertyTypeRequired
atstring (date-time)Required
toolstringRequired
summarystringRequired
linkstring | nullRequired

AgentGrantResponse

PropertyTypeRequired
idstring (uuid)Required
clientNamestringRequired
clientHoststringRequired
scopesstring[]Required
createdAtstring (date-time)Required
lastUsedAtstring (date-time) | nullRequired
grantedByNamestring | nullRequired
accessstring—
activityAgentActivityResponse[] | null—
activityCountinteger (int32)—

AuthorizationServerMetadata

PropertyTypeRequired
issuerstringRequired
authorization_endpointstringRequired
token_endpointstringRequired
registration_endpointstringRequired
revocation_endpointstringRequired
jwks_uristringRequired
response_types_supportedstring[]Required
grant_types_supportedstring[]Required
code_challenge_methods_supportedstring[]Required
token_endpoint_auth_methods_supportedstring[]Required
token_endpoint_auth_signing_alg_values_supportedstring[]Required
revocation_endpoint_auth_methods_supportedstring[]Required
client_id_metadata_document_supportedbooleanRequired
scopes_supportedstring[]Required
authorization_response_iss_parameter_supportedbooleanRequired
service_documentationstringRequired

ClientRegistrationRequest

PropertyTypeRequired
client_namestring | nullRequired
redirect_urisstring[] | nullRequired
grant_typesstring[] | nullRequired
response_typesstring[] | nullRequired
token_endpoint_auth_methodstring | nullRequired
software_idstring | nullRequired
software_versionstring | nullRequired

ClientRegistrationResponse

PropertyTypeRequired
client_idstringRequired
client_namestringRequired
redirect_urisstring[]Required
grant_typesstring[]Required
response_typesstring[]Required
token_endpoint_auth_methodstringRequired
client_id_issued_atinteger (int64)Required

HouseholdRole

Type

Values

OwnerAdultJunior

JsonWebKey

PropertyTypeRequired
ktystringRequired
kidstringRequired

JsonWebKeySet

PropertyTypeRequired
keysJsonWebKey[]Required

OAuthErrorResponse

PropertyTypeRequired
errorstringRequired
error_descriptionstring | nullRequired

OAuthRevocationForm

PropertyTypeRequired
tokenstringRequired
token_type_hintstring | nullRequired
client_idstringRequired

OAuthTokenForm

PropertyTypeRequired
grant_typestringRequired
codestring | nullRequired
code_verifierstring | nullRequired
redirect_uristring | nullRequired
client_idstring | nullRequired
resourcestring | nullRequired
refresh_tokenstring | nullRequired
client_assertion_typestring | nullRequired
client_assertionstring | nullRequired

OAuthTokenResponse

PropertyTypeRequired
access_tokenstringRequired
token_typestringRequired
expires_ininteger (int32)Required
refresh_tokenstringRequired
scopestringRequired

ProblemDetails

PropertyTypeRequired
typestring | null—
titlestring | null—
statusinteger (int32) | null—
detailstring | null—
instancestring | null—
codestring | null—

ProtectedResourceMetadata

PropertyTypeRequired
resourcestringRequired
authorization_serversstring[]Required
scopes_supportedstring[]Required
bearer_methods_supportedstring[]Required
resource_namestringRequired
resource_documentationstringRequired