@meshery/schemas 1.3.123 → 1.3.125

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/dist/cloudApi.d.mts +20 -18
  2. package/dist/cloudApi.d.ts +20 -18
  3. package/dist/constructs/v1alpha1/core/Core.d.ts +22 -0
  4. package/dist/constructs/v1alpha1/core/CoreSchema.js +1 -1
  5. package/dist/constructs/v1alpha1/core/CoreSchema.mjs +1 -1
  6. package/dist/constructs/v1beta1/feature/Feature.d.ts +3 -3
  7. package/dist/constructs/v1beta1/feature/FeatureSchema.js +1 -1
  8. package/dist/constructs/v1beta1/feature/FeatureSchema.mjs +1 -1
  9. package/dist/constructs/v1beta2/core/Core.d.ts +52 -1
  10. package/dist/constructs/v1beta2/core/CoreSchema.js +1 -1
  11. package/dist/constructs/v1beta2/core/CoreSchema.mjs +1 -1
  12. package/dist/constructs/v1beta2/user/User.d.ts +60 -2
  13. package/dist/constructs/v1beta2/user/UserSchema.js +1 -1
  14. package/dist/constructs/v1beta2/user/UserSchema.mjs +1 -1
  15. package/dist/constructs/v1beta3/connection/Connection.d.ts +92 -5
  16. package/dist/constructs/v1beta3/connection/ConnectionSchema.js +5 -5
  17. package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +5 -5
  18. package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +90 -3
  19. package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +6 -6
  20. package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +6 -6
  21. package/dist/constructs/v1beta3/event/Event.d.ts +60 -2
  22. package/dist/constructs/v1beta3/event/EventSchema.js +3 -3
  23. package/dist/constructs/v1beta3/event/EventSchema.mjs +3 -3
  24. package/dist/constructs/v1beta3/oauth_consent_request/OauthConsentRequest.d.ts +36 -17
  25. package/dist/constructs/v1beta3/oauth_consent_request/OauthConsentRequestSchema.js +27 -15
  26. package/dist/constructs/v1beta3/oauth_consent_request/OauthConsentRequestSchema.mjs +27 -15
  27. package/dist/constructs/v1beta3/request/Request.d.ts +5 -5
  28. package/dist/constructs/v1beta3/request/RequestSchema.js +5 -5
  29. package/dist/constructs/v1beta3/request/RequestSchema.mjs +5 -5
  30. package/dist/constructs/v1beta3/schedule/Schedule.d.ts +90 -3
  31. package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +5 -5
  32. package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +5 -5
  33. package/dist/index.d.mts +53 -2
  34. package/dist/index.d.ts +53 -2
  35. package/dist/mesheryApi.d.mts +2 -2
  36. package/dist/mesheryApi.d.ts +2 -2
  37. package/package.json +1 -1
@@ -445,7 +445,7 @@ type GetFeaturesByOrganizationApiResponse = {
445
445
  type GetFeaturesByOrganizationApiArg = {
446
446
  /** The ID of the organization */
447
447
  orgId: string;
448
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
448
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
449
449
  "X-Current-Orgid"?: string;
450
450
  };
451
451
  type GetOrganizationSmtpEnvironmentApiResponse =
@@ -4263,7 +4263,7 @@ type GetUserApiResponse = {
4263
4263
  };
4264
4264
  };
4265
4265
  type GetUserApiArg = {
4266
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
4266
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
4267
4267
  "X-Current-Orgid"?: string;
4268
4268
  };
4269
4269
  type UpdateUserPreferencesApiResponse = unknown;
@@ -7496,7 +7496,7 @@ type GetConnectionsApiArg = {
7496
7496
  order?: string;
7497
7497
  /** Organization ID to scope the request. */
7498
7498
  orgId?: string;
7499
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
7499
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
7500
7500
  "X-Current-Orgid"?: string;
7501
7501
  /** Filter connections (general filter string) */
7502
7502
  filter?: string;
@@ -8868,7 +8868,7 @@ type ReportDesktopPlatformSessionsApiResponse = {
8868
8868
  type ReportDesktopPlatformSessionsApiArg = {
8869
8869
  /** Installation identifier from `metadata.installationId`. */
8870
8870
  installationId: string;
8871
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
8871
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
8872
8872
  "X-Current-Orgid"?: string;
8873
8873
  body: {
8874
8874
  /** Browser sign-ins of one install, at most one per platform and handle, handles compared case-insensitively. */
@@ -8959,7 +8959,7 @@ type GetPlatformSessionsApiArg = {
8959
8959
  page?: number;
8960
8960
  /** Number of items per page */
8961
8961
  pageSize?: number;
8962
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
8962
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
8963
8963
  "X-Current-Orgid"?: string;
8964
8964
  /** Only sessions on this platform, for example `x`, `linkedin` or `reddit`. */
8965
8965
  platform?: string;
@@ -9802,7 +9802,7 @@ type ListContentItemsApiArg = {
9802
9802
  whose `threadId` names it.
9803
9803
  */
9804
9804
  threadId?: string;
9805
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
9805
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
9806
9806
  "X-Current-Orgid"?: string;
9807
9807
  };
9808
9808
  type InsertContentItemApiResponse = {
@@ -10059,7 +10059,7 @@ type GetContentItemApiResponse = {
10059
10059
  type GetContentItemApiArg = {
10060
10060
  /** Content item ID */
10061
10061
  contentItemId: string;
10062
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
10062
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
10063
10063
  "X-Current-Orgid"?: string;
10064
10064
  };
10065
10065
  type UpdateContentItemApiResponse = {
@@ -14652,7 +14652,7 @@ type GetEventsApiArg = {
14652
14652
  /** Which events are returned. `user` (default): only the caller's own events (unchanged behavior). `organization`: every member's events in the caller's session organization. Requires organization administration permission in the session organization; callers without it get 403.
14653
14653
  */
14654
14654
  scope?: "user" | "organization";
14655
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
14655
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
14656
14656
  "X-Current-Orgid"?: string;
14657
14657
  };
14658
14658
  type GetEventFeedApiResponse = {
@@ -16450,14 +16450,16 @@ type GetOauthConsentRequestApiResponse = {
16450
16450
  client: {
16451
16451
  /** OAuth client ID. An identifier issued by the identity provider, not a UUID. */
16452
16452
  clientId: string;
16453
- /** Display name the client registered. Empty when it registered none. Self-asserted by the client; only `verified` marks trust. */
16453
+ /** Display name the client registered. Empty when it registered none. Self-asserted by a dynamically registered client; set by the operator for an operator-managed client. Only `verified` marks trust. */
16454
16454
  clientName: string;
16455
- /** The network hosts the client can send the user to after the decision: the host of each https redirect URI (for example `app.example.com`) and of each loopback redirect URI (`127.0.0.1` or `[::1]`), without duplicates. Only redirect URIs whose scheme is `https`, or `http` on a loopback IP literal, are listed here; the `localhost` hostname is never registered (RFC 8252 section 8.3), and a private-use app redirect is listed in `appSchemes` instead. Lowercase ASCII, with no scheme, port or path; an internationalized hostname is sent in IDNA A-label (punycode) form. Empty when the client registered only app redirects; `redirectHosts` and `appSchemes` are never both empty. */
16455
+ /** The network hosts the client can send the user to after the decision: the host of each http or https redirect URI, with its port when the redirect has one, without duplicates. For a dynamically registered client, registration policy limits these to `https` hosts and loopback http hosts (`127.0.0.1` or `[::1]`), and never `localhost` (RFC 8252 section 8.3). For an operator-managed client any http or https redirect is listed, so a host may also be a single-label name such as `localhost`. A redirect URI of any other scheme is listed in `appSchemes` instead. Empty when the client registered only app redirects; `redirectHosts` and `appSchemes` are never both empty. */
16456
16456
  redirectHosts: string[];
16457
- /** The private-use URI schemes (RFC 8252 section 7.1) of the client's app redirect URIs, without duplicates, for example `vscode` or `com.example.app`: the app that claims the scheme on the user's device receives the user after the decision. Registration accepts a private-use scheme only when it is on the server-side app-scheme allowlist read from configuration (defaults `vscode` and `cursor`), so only allowlisted schemes appear here. A reverse-domain scheme such as `com.example.app` names an app, not a host, and must not be shown as one. Empty when the client registered only https and loopback redirects; `redirectHosts` and `appSchemes` are never both empty. */
16457
+ /** The URI schemes of the client's app redirect URIs (any scheme other than http and https), without duplicates, for example `vscode` or `com.example.app`: the app that claims the scheme on the user's device receives the user after the decision. For a dynamically registered client, registration accepts a private-use scheme (RFC 8252 section 7.1) only when it is on the server-side app-scheme allowlist read from configuration (defaults `vscode` and `cursor`), so only allowlisted schemes appear here. For an operator-managed client any other scheme is listed, as registered. A reverse-domain scheme such as `com.example.app` names an app, not a host, and must not be shown as one. Empty when every redirect URI of the client is http or https; `redirectHosts` and `appSchemes` are never both empty. */
16458
16458
  appSchemes: string[];
16459
- /** Derived only from the client's redirect targets, never from `clientName` or `clientId`: true only when every redirect URI of the client matches one operator-listed known-client entry (that entry's https hosts or its app schemes). Marks trust and never blocks: a false value is shown as an unverified client, and the user may still allow it. */
16459
+ /** Marks trust and never blocks. For a dynamically registered client it is true only when every redirect URI of the client matches one operator-listed known-client entry (that entry's https hosts or its app schemes). For an operator-managed client it is true when the operator set the verified mark in the client's identity-provider metadata, which only the admin API can write; a client can never set or clear it. It is never derived from a self-asserted name or from the client ID. A false value is shown as an unverified client, and the user may still allow it. */
16460
16460
  verified: boolean;
16461
+ /** An https URL of the client's logo image. Sent only for an operator-managed client whose operator set one; never sent for a dynamically registered client, whose self-asserted logo is not shown. Omitted when there is none. */
16462
+ logoUri?: string;
16461
16463
  };
16462
16464
  /** Scopes the client asks for, as the identity provider recorded them. An accept grants only what the client requested, never more: these scopes, and any audience the client asked the identity provider for. Empty when the client asks for none. */
16463
16465
  requestedScopes: string[];
@@ -17796,7 +17798,7 @@ type ListRequestsApiResponse = {
17796
17798
  }[];
17797
17799
  };
17798
17800
  type ListRequestsApiArg = {
17799
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17801
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17800
17802
  "X-Current-Orgid"?: string;
17801
17803
  /** Get responses by page */
17802
17804
  page?: number;
@@ -17842,7 +17844,7 @@ type GetRequestApiResponse = {
17842
17844
  updatedAt: string;
17843
17845
  };
17844
17846
  type GetRequestApiArg = {
17845
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17847
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17846
17848
  "X-Current-Orgid"?: string;
17847
17849
  /** Request ID */
17848
17850
  requestId: string;
@@ -17880,7 +17882,7 @@ type ApproveRequestApiResponse = {
17880
17882
  updatedAt: string;
17881
17883
  };
17882
17884
  type ApproveRequestApiArg = {
17883
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17885
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17884
17886
  "X-Current-Orgid"?: string;
17885
17887
  /** Request ID */
17886
17888
  requestId: string;
@@ -17922,7 +17924,7 @@ type DenyRequestApiResponse = {
17922
17924
  updatedAt: string;
17923
17925
  };
17924
17926
  type DenyRequestApiArg = {
17925
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17927
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17926
17928
  "X-Current-Orgid"?: string;
17927
17929
  /** Request ID */
17928
17930
  requestId: string;
@@ -18074,7 +18076,7 @@ type ListSchedulesApiResponse = {
18074
18076
  }[];
18075
18077
  };
18076
18078
  type ListSchedulesApiArg = {
18077
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
18079
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
18078
18080
  "X-Current-Orgid"?: string;
18079
18081
  /** Get responses by page */
18080
18082
  page?: number;
@@ -18441,7 +18443,7 @@ type GetScheduleByIdApiResponse = {
18441
18443
  type GetScheduleByIdApiArg = {
18442
18444
  /** Schedule ID */
18443
18445
  scheduleId: string;
18444
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
18446
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
18445
18447
  "X-Current-Orgid"?: string;
18446
18448
  };
18447
18449
  type UpdateScheduleApiResponse = {
@@ -445,7 +445,7 @@ type GetFeaturesByOrganizationApiResponse = {
445
445
  type GetFeaturesByOrganizationApiArg = {
446
446
  /** The ID of the organization */
447
447
  orgId: string;
448
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
448
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
449
449
  "X-Current-Orgid"?: string;
450
450
  };
451
451
  type GetOrganizationSmtpEnvironmentApiResponse =
@@ -4263,7 +4263,7 @@ type GetUserApiResponse = {
4263
4263
  };
4264
4264
  };
4265
4265
  type GetUserApiArg = {
4266
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
4266
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
4267
4267
  "X-Current-Orgid"?: string;
4268
4268
  };
4269
4269
  type UpdateUserPreferencesApiResponse = unknown;
@@ -7496,7 +7496,7 @@ type GetConnectionsApiArg = {
7496
7496
  order?: string;
7497
7497
  /** Organization ID to scope the request. */
7498
7498
  orgId?: string;
7499
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
7499
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
7500
7500
  "X-Current-Orgid"?: string;
7501
7501
  /** Filter connections (general filter string) */
7502
7502
  filter?: string;
@@ -8868,7 +8868,7 @@ type ReportDesktopPlatformSessionsApiResponse = {
8868
8868
  type ReportDesktopPlatformSessionsApiArg = {
8869
8869
  /** Installation identifier from `metadata.installationId`. */
8870
8870
  installationId: string;
8871
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
8871
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
8872
8872
  "X-Current-Orgid"?: string;
8873
8873
  body: {
8874
8874
  /** Browser sign-ins of one install, at most one per platform and handle, handles compared case-insensitively. */
@@ -8959,7 +8959,7 @@ type GetPlatformSessionsApiArg = {
8959
8959
  page?: number;
8960
8960
  /** Number of items per page */
8961
8961
  pageSize?: number;
8962
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
8962
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
8963
8963
  "X-Current-Orgid"?: string;
8964
8964
  /** Only sessions on this platform, for example `x`, `linkedin` or `reddit`. */
8965
8965
  platform?: string;
@@ -9802,7 +9802,7 @@ type ListContentItemsApiArg = {
9802
9802
  whose `threadId` names it.
9803
9803
  */
9804
9804
  threadId?: string;
9805
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
9805
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
9806
9806
  "X-Current-Orgid"?: string;
9807
9807
  };
9808
9808
  type InsertContentItemApiResponse = {
@@ -10059,7 +10059,7 @@ type GetContentItemApiResponse = {
10059
10059
  type GetContentItemApiArg = {
10060
10060
  /** Content item ID */
10061
10061
  contentItemId: string;
10062
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
10062
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
10063
10063
  "X-Current-Orgid"?: string;
10064
10064
  };
10065
10065
  type UpdateContentItemApiResponse = {
@@ -14652,7 +14652,7 @@ type GetEventsApiArg = {
14652
14652
  /** Which events are returned. `user` (default): only the caller's own events (unchanged behavior). `organization`: every member's events in the caller's session organization. Requires organization administration permission in the session organization; callers without it get 403.
14653
14653
  */
14654
14654
  scope?: "user" | "organization";
14655
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
14655
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
14656
14656
  "X-Current-Orgid"?: string;
14657
14657
  };
14658
14658
  type GetEventFeedApiResponse = {
@@ -16450,14 +16450,16 @@ type GetOauthConsentRequestApiResponse = {
16450
16450
  client: {
16451
16451
  /** OAuth client ID. An identifier issued by the identity provider, not a UUID. */
16452
16452
  clientId: string;
16453
- /** Display name the client registered. Empty when it registered none. Self-asserted by the client; only `verified` marks trust. */
16453
+ /** Display name the client registered. Empty when it registered none. Self-asserted by a dynamically registered client; set by the operator for an operator-managed client. Only `verified` marks trust. */
16454
16454
  clientName: string;
16455
- /** The network hosts the client can send the user to after the decision: the host of each https redirect URI (for example `app.example.com`) and of each loopback redirect URI (`127.0.0.1` or `[::1]`), without duplicates. Only redirect URIs whose scheme is `https`, or `http` on a loopback IP literal, are listed here; the `localhost` hostname is never registered (RFC 8252 section 8.3), and a private-use app redirect is listed in `appSchemes` instead. Lowercase ASCII, with no scheme, port or path; an internationalized hostname is sent in IDNA A-label (punycode) form. Empty when the client registered only app redirects; `redirectHosts` and `appSchemes` are never both empty. */
16455
+ /** The network hosts the client can send the user to after the decision: the host of each http or https redirect URI, with its port when the redirect has one, without duplicates. For a dynamically registered client, registration policy limits these to `https` hosts and loopback http hosts (`127.0.0.1` or `[::1]`), and never `localhost` (RFC 8252 section 8.3). For an operator-managed client any http or https redirect is listed, so a host may also be a single-label name such as `localhost`. A redirect URI of any other scheme is listed in `appSchemes` instead. Empty when the client registered only app redirects; `redirectHosts` and `appSchemes` are never both empty. */
16456
16456
  redirectHosts: string[];
16457
- /** The private-use URI schemes (RFC 8252 section 7.1) of the client's app redirect URIs, without duplicates, for example `vscode` or `com.example.app`: the app that claims the scheme on the user's device receives the user after the decision. Registration accepts a private-use scheme only when it is on the server-side app-scheme allowlist read from configuration (defaults `vscode` and `cursor`), so only allowlisted schemes appear here. A reverse-domain scheme such as `com.example.app` names an app, not a host, and must not be shown as one. Empty when the client registered only https and loopback redirects; `redirectHosts` and `appSchemes` are never both empty. */
16457
+ /** The URI schemes of the client's app redirect URIs (any scheme other than http and https), without duplicates, for example `vscode` or `com.example.app`: the app that claims the scheme on the user's device receives the user after the decision. For a dynamically registered client, registration accepts a private-use scheme (RFC 8252 section 7.1) only when it is on the server-side app-scheme allowlist read from configuration (defaults `vscode` and `cursor`), so only allowlisted schemes appear here. For an operator-managed client any other scheme is listed, as registered. A reverse-domain scheme such as `com.example.app` names an app, not a host, and must not be shown as one. Empty when every redirect URI of the client is http or https; `redirectHosts` and `appSchemes` are never both empty. */
16458
16458
  appSchemes: string[];
16459
- /** Derived only from the client's redirect targets, never from `clientName` or `clientId`: true only when every redirect URI of the client matches one operator-listed known-client entry (that entry's https hosts or its app schemes). Marks trust and never blocks: a false value is shown as an unverified client, and the user may still allow it. */
16459
+ /** Marks trust and never blocks. For a dynamically registered client it is true only when every redirect URI of the client matches one operator-listed known-client entry (that entry's https hosts or its app schemes). For an operator-managed client it is true when the operator set the verified mark in the client's identity-provider metadata, which only the admin API can write; a client can never set or clear it. It is never derived from a self-asserted name or from the client ID. A false value is shown as an unverified client, and the user may still allow it. */
16460
16460
  verified: boolean;
16461
+ /** An https URL of the client's logo image. Sent only for an operator-managed client whose operator set one; never sent for a dynamically registered client, whose self-asserted logo is not shown. Omitted when there is none. */
16462
+ logoUri?: string;
16461
16463
  };
16462
16464
  /** Scopes the client asks for, as the identity provider recorded them. An accept grants only what the client requested, never more: these scopes, and any audience the client asked the identity provider for. Empty when the client asks for none. */
16463
16465
  requestedScopes: string[];
@@ -17796,7 +17798,7 @@ type ListRequestsApiResponse = {
17796
17798
  }[];
17797
17799
  };
17798
17800
  type ListRequestsApiArg = {
17799
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17801
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17800
17802
  "X-Current-Orgid"?: string;
17801
17803
  /** Get responses by page */
17802
17804
  page?: number;
@@ -17842,7 +17844,7 @@ type GetRequestApiResponse = {
17842
17844
  updatedAt: string;
17843
17845
  };
17844
17846
  type GetRequestApiArg = {
17845
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17847
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17846
17848
  "X-Current-Orgid"?: string;
17847
17849
  /** Request ID */
17848
17850
  requestId: string;
@@ -17880,7 +17882,7 @@ type ApproveRequestApiResponse = {
17880
17882
  updatedAt: string;
17881
17883
  };
17882
17884
  type ApproveRequestApiArg = {
17883
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17885
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17884
17886
  "X-Current-Orgid"?: string;
17885
17887
  /** Request ID */
17886
17888
  requestId: string;
@@ -17922,7 +17924,7 @@ type DenyRequestApiResponse = {
17922
17924
  updatedAt: string;
17923
17925
  };
17924
17926
  type DenyRequestApiArg = {
17925
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
17927
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
17926
17928
  "X-Current-Orgid"?: string;
17927
17929
  /** Request ID */
17928
17930
  requestId: string;
@@ -18074,7 +18076,7 @@ type ListSchedulesApiResponse = {
18074
18076
  }[];
18075
18077
  };
18076
18078
  type ListSchedulesApiArg = {
18077
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
18079
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
18078
18080
  "X-Current-Orgid"?: string;
18079
18081
  /** Get responses by page */
18080
18082
  page?: number;
@@ -18441,7 +18443,7 @@ type GetScheduleByIdApiResponse = {
18441
18443
  type GetScheduleByIdApiArg = {
18442
18444
  /** Schedule ID */
18443
18445
  scheduleId: string;
18444
- /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, the caller's selected organization applies. */
18446
+ /** Organization the call acts in, by ID (a UUID). When present, the server resolves the session organization from it instead of the caller's selected organization, and runs its membership and permission checks there. A caller who is not a live member of the named organization receives the same 404 as an unknown resource. Omitted, a path or query `orgId` the operation takes names the organization when sent; otherwise the caller's selected organization applies when it is not nil; otherwise the server defaults among the caller's live organizations, using the only one when exactly one qualifies. When the call needs an acting organization and several qualify, an operation that declares the OrganizationSelectionRequired response answers 409 `organization_selection_required`. The resolution order is in docs/mcp-operation-contract.md, the organization selector. */
18445
18447
  "X-Current-Orgid"?: string;
18446
18448
  };
18447
18449
  type UpdateScheduleApiResponse = {
@@ -627,6 +627,28 @@ export interface components {
627
627
  /** @description The sentence the caller is shown. */
628
628
  message: string;
629
629
  };
630
+ /** @description The call needs an acting organization, the caller named none, and more than one of the caller's live organizations qualifies. Nothing was done by this request. Repeat it naming one of `choices` as `X-Current-Orgid` (the `organizationId` tool argument). */
631
+ OrganizationSelectionRequiredError: {
632
+ /**
633
+ * @description Machine-readable reason. Always `organization_selection_required` for this body.
634
+ * @enum {string}
635
+ */
636
+ code: "organization_selection_required";
637
+ /** @description The sentence the caller is shown. */
638
+ message: string;
639
+ /** @description The caller's own live organizations the call could act in. Pass one `id` as `X-Current-Orgid`. */
640
+ choices: {
641
+ /**
642
+ * Format: uuid
643
+ * @description Organization ID.
644
+ */
645
+ id: string;
646
+ /** @description Name of the organization. */
647
+ name: string;
648
+ /** @description Description of the organization. */
649
+ description: string;
650
+ }[];
651
+ };
630
652
  /** @description A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way. */
631
653
  MeshkitError: {
632
654
  /** @description The sentence the caller is shown. */