@lumoauth/api-client 1.1.0 → 1.3.0

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 (147) hide show
  1. package/.openapi-generator/FILES +16 -0
  2. package/README.md +14 -4
  3. package/api/aauth-api.ts +5 -5
  4. package/api/admin-email-api.ts +67 -15
  5. package/api/admin-mcp-api.ts +5 -5
  6. package/api/admin-oauth-clients-api.ts +370 -0
  7. package/api/agents-api.ts +5 -5
  8. package/api/mcp-api.ts +130 -0
  9. package/api/oauth-api.ts +0 -186
  10. package/api/well-known-api.ts +10 -10
  11. package/dist/api/aauth-api.d.ts +5 -5
  12. package/dist/api/aauth-api.js +4 -4
  13. package/dist/api/admin-email-api.d.ts +41 -9
  14. package/dist/api/admin-email-api.js +34 -14
  15. package/dist/api/admin-mcp-api.d.ts +5 -5
  16. package/dist/api/admin-mcp-api.js +4 -4
  17. package/dist/api/admin-oauth-clients-api.d.ts +210 -0
  18. package/dist/api/admin-oauth-clients-api.js +236 -0
  19. package/dist/api/agents-api.d.ts +5 -5
  20. package/dist/api/agents-api.js +4 -4
  21. package/dist/api/mcp-api.d.ts +73 -0
  22. package/dist/api/mcp-api.js +82 -0
  23. package/dist/api/oauth-api.d.ts +0 -110
  24. package/dist/api/oauth-api.js +0 -132
  25. package/dist/api/well-known-api.d.ts +10 -10
  26. package/dist/api/well-known-api.js +8 -8
  27. package/dist/esm/api/aauth-api.d.ts +5 -5
  28. package/dist/esm/api/aauth-api.js +4 -4
  29. package/dist/esm/api/admin-email-api.d.ts +41 -9
  30. package/dist/esm/api/admin-email-api.js +34 -14
  31. package/dist/esm/api/admin-mcp-api.d.ts +5 -5
  32. package/dist/esm/api/admin-mcp-api.js +4 -4
  33. package/dist/esm/api/admin-oauth-clients-api.d.ts +210 -0
  34. package/dist/esm/api/admin-oauth-clients-api.js +236 -0
  35. package/dist/esm/api/agents-api.d.ts +5 -5
  36. package/dist/esm/api/agents-api.js +4 -4
  37. package/dist/esm/api/mcp-api.d.ts +73 -0
  38. package/dist/esm/api/mcp-api.js +83 -1
  39. package/dist/esm/api/oauth-api.d.ts +0 -110
  40. package/dist/esm/api/oauth-api.js +0 -132
  41. package/dist/esm/api/well-known-api.d.ts +10 -10
  42. package/dist/esm/api/well-known-api.js +8 -8
  43. package/dist/esm/models/admin-agents-generate-token-request.d.ts +7 -1
  44. package/dist/esm/models/admin-agents-generate-token-response-data.d.ts +12 -0
  45. package/dist/esm/models/admin-clients-get-branding-response-data.d.ts +34 -0
  46. package/dist/esm/models/admin-clients-get-branding-response-data.js +14 -0
  47. package/dist/esm/models/admin-clients-get-branding-response.d.ts +25 -0
  48. package/dist/esm/models/admin-clients-get-branding-response.js +14 -0
  49. package/dist/esm/models/attest-response.d.ts +2 -1
  50. package/dist/esm/models/attest-response.js +1 -0
  51. package/dist/esm/models/authorization-server-metadata.d.ts +0 -6
  52. package/dist/esm/models/authorize-mcp-request.d.ts +1 -1
  53. package/dist/esm/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  54. package/dist/esm/models/index.d.ts +8 -0
  55. package/dist/esm/models/index.js +8 -0
  56. package/dist/esm/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  57. package/dist/esm/models/mcp-server-tool-authorize-request-subject.js +22 -0
  58. package/dist/esm/models/mcp-server-tool-authorize-request.d.ts +31 -0
  59. package/dist/esm/models/mcp-server-tool-authorize-request.js +14 -0
  60. package/dist/esm/models/mcp-server-tool-authorize-response.d.ts +36 -0
  61. package/dist/esm/models/mcp-server-tool-authorize-response.js +14 -0
  62. package/dist/esm/models/mcp-server.d.ts +18 -0
  63. package/dist/esm/models/open-id-configuration.d.ts +7 -7
  64. package/dist/esm/models/patch-admin-clients-update-branding-response.d.ts +32 -0
  65. package/dist/esm/models/patch-admin-clients-update-branding-response.js +14 -0
  66. package/dist/esm/models/protected-resource-metadata.d.ts +1 -1
  67. package/dist/esm/models/put-admin-clients-update-branding-request.d.ts +34 -0
  68. package/dist/esm/models/put-admin-clients-update-branding-request.js +14 -0
  69. package/dist/esm/models/put-admin-clients-update-branding-response.d.ts +32 -0
  70. package/dist/esm/models/put-admin-clients-update-branding-response.js +14 -0
  71. package/dist/esm/models/single-server-metadata.d.ts +1 -1
  72. package/dist/models/admin-agents-generate-token-request.d.ts +7 -1
  73. package/dist/models/admin-agents-generate-token-response-data.d.ts +12 -0
  74. package/dist/models/admin-clients-get-branding-response-data.d.ts +34 -0
  75. package/dist/models/admin-clients-get-branding-response-data.js +15 -0
  76. package/dist/models/admin-clients-get-branding-response.d.ts +25 -0
  77. package/dist/models/admin-clients-get-branding-response.js +15 -0
  78. package/dist/models/attest-response.d.ts +2 -1
  79. package/dist/models/attest-response.js +1 -0
  80. package/dist/models/authorization-server-metadata.d.ts +0 -6
  81. package/dist/models/authorize-mcp-request.d.ts +1 -1
  82. package/dist/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  83. package/dist/models/index.d.ts +8 -0
  84. package/dist/models/index.js +8 -0
  85. package/dist/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  86. package/dist/models/mcp-server-tool-authorize-request-subject.js +25 -0
  87. package/dist/models/mcp-server-tool-authorize-request.d.ts +31 -0
  88. package/dist/models/mcp-server-tool-authorize-request.js +15 -0
  89. package/dist/models/mcp-server-tool-authorize-response.d.ts +36 -0
  90. package/dist/models/mcp-server-tool-authorize-response.js +15 -0
  91. package/dist/models/mcp-server.d.ts +18 -0
  92. package/dist/models/open-id-configuration.d.ts +7 -7
  93. package/dist/models/patch-admin-clients-update-branding-response.d.ts +32 -0
  94. package/dist/models/patch-admin-clients-update-branding-response.js +15 -0
  95. package/dist/models/protected-resource-metadata.d.ts +1 -1
  96. package/dist/models/put-admin-clients-update-branding-request.d.ts +34 -0
  97. package/dist/models/put-admin-clients-update-branding-request.js +15 -0
  98. package/dist/models/put-admin-clients-update-branding-response.d.ts +32 -0
  99. package/dist/models/put-admin-clients-update-branding-response.js +15 -0
  100. package/dist/models/single-server-metadata.d.ts +1 -1
  101. package/docs/AAuthApi.md +1 -1
  102. package/docs/AdminAgentsApi.md +1 -1
  103. package/docs/AdminAgentsGenerateTokenRequest.md +3 -1
  104. package/docs/AdminAgentsGenerateTokenResponseData.md +4 -0
  105. package/docs/AdminClientsGetBrandingResponse.md +20 -0
  106. package/docs/AdminClientsGetBrandingResponseData.md +22 -0
  107. package/docs/AdminEmailApi.md +15 -2
  108. package/docs/AdminMcpApi.md +1 -1
  109. package/docs/AdminOAuthClientsApi.md +174 -0
  110. package/docs/AgentsApi.md +4 -3
  111. package/docs/AuthorizationServerMetadata.md +0 -2
  112. package/docs/AuthorizeMcpRequest.md +1 -1
  113. package/docs/GetProtectedResourceMetadataRoot200Response.md +1 -1
  114. package/docs/GetProtectedResourceMetadataRootResponse1ResourcesItem.md +1 -1
  115. package/docs/McpApi.md +64 -0
  116. package/docs/McpServer.md +6 -0
  117. package/docs/McpServerToolAuthorizeRequest.md +22 -0
  118. package/docs/McpServerToolAuthorizeRequestSubject.md +22 -0
  119. package/docs/McpServerToolAuthorizeResponse.md +24 -0
  120. package/docs/OAuthApi.md +0 -105
  121. package/docs/OpenIdConfiguration.md +3 -3
  122. package/docs/PatchAdminClientsUpdateBrandingResponse.md +22 -0
  123. package/docs/ProtectedResourceMetadata.md +1 -1
  124. package/docs/PutAdminClientsUpdateBrandingRequest.md +22 -0
  125. package/docs/PutAdminClientsUpdateBrandingResponse.md +22 -0
  126. package/docs/SingleServerMetadata.md +1 -1
  127. package/docs/WellKnownApi.md +2 -2
  128. package/models/admin-agents-generate-token-request.ts +7 -1
  129. package/models/admin-agents-generate-token-response-data.ts +12 -0
  130. package/models/admin-clients-get-branding-response-data.ts +36 -0
  131. package/models/admin-clients-get-branding-response.ts +33 -0
  132. package/models/attest-response.ts +2 -1
  133. package/models/authorization-server-metadata.ts +0 -6
  134. package/models/authorize-mcp-request.ts +1 -1
  135. package/models/get-protected-resource-metadata-root-response1-resources-item.ts +1 -1
  136. package/models/index.ts +8 -0
  137. package/models/mcp-server-tool-authorize-request-subject.ts +46 -0
  138. package/models/mcp-server-tool-authorize-request.ts +39 -0
  139. package/models/mcp-server-tool-authorize-response.ts +42 -0
  140. package/models/mcp-server.ts +18 -0
  141. package/models/open-id-configuration.ts +7 -7
  142. package/models/patch-admin-clients-update-branding-response.ts +36 -0
  143. package/models/protected-resource-metadata.ts +1 -1
  144. package/models/put-admin-clients-update-branding-request.ts +36 -0
  145. package/models/put-admin-clients-update-branding-response.ts +36 -0
  146. package/models/single-server-metadata.ts +1 -1
  147. package/package.json +1 -1
@@ -0,0 +1,34 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface PutAdminClientsUpdateBrandingRequest
16
+ */
17
+ export interface PutAdminClientsUpdateBrandingRequest {
18
+ /**
19
+ *
20
+ * @type {{ [key: string]: any; }}
21
+ * @memberof PutAdminClientsUpdateBrandingRequest
22
+ */
23
+ 'login'?: {
24
+ [key: string]: any;
25
+ };
26
+ /**
27
+ *
28
+ * @type {{ [key: string]: any; }}
29
+ * @memberof PutAdminClientsUpdateBrandingRequest
30
+ */
31
+ 'consent'?: {
32
+ [key: string]: any;
33
+ };
34
+ }
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,32 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface PutAdminClientsUpdateBrandingResponse
16
+ */
17
+ export interface PutAdminClientsUpdateBrandingResponse {
18
+ /**
19
+ *
20
+ * @type {{ [key: string]: any; }}
21
+ * @memberof PutAdminClientsUpdateBrandingResponse
22
+ */
23
+ 'data'?: {
24
+ [key: string]: any;
25
+ };
26
+ /**
27
+ * Keys whose value was refused by validation and not saved
28
+ * @type {Array<string>}
29
+ * @memberof PutAdminClientsUpdateBrandingResponse
30
+ */
31
+ 'rejected'?: Array<string>;
32
+ }
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -23,7 +23,7 @@ export interface SingleServerMetadata {
23
23
  */
24
24
  'resource': string;
25
25
  /**
26
- *
26
+ * The organization\'s issuer identifier (RFC 8414).
27
27
  * @type {Array<string>}
28
28
  * @memberof SingleServerMetadata
29
29
  */
package/docs/AAuthApi.md CHANGED
@@ -492,7 +492,7 @@ No authorization required
492
492
  # **issueAgentToken**
493
493
  > IssueAgentTokenResponse issueAgentToken(issueAgentTokenRequest)
494
494
 
495
- Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
495
+ Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
496
496
 
497
497
  ### Example
498
498
 
@@ -469,7 +469,7 @@ const { status, data } = await apiInstance.adminAgentsGenerateToken(
469
469
  | Status code | Description | Response headers |
470
470
  |-------------|-------------|------------------|
471
471
  |**200** | A generated agent token. The token value is returned ONCE. | - |
472
- |**400** | Inactive agent, or requested scopes outside the agent\&#39;s capabilities. | - |
472
+ |**400** | Inactive agent, requested scopes outside the agent\&#39;s capabilities, a resource that is not an active MCP server of this organization, or expiresIn above 3600 without a resource. | - |
473
473
  |**401** | Authentication required. | - |
474
474
  |**403** | Admin privileges required. | - |
475
475
  |**404** | Tenant or agent not found. | - |
@@ -5,8 +5,9 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **expiresIn** | **number** | Token lifetime in seconds. Default 3600, at most 2592000 (30 days). | [optional] [default to undefined]
8
+ **expiresIn** | **number** | Token lifetime in seconds. Default 3600, minimum 60, at most 86400 (24 hours). Above 3600 only together with &#x60;resource&#x60;: a long-lived token is always bound to one MCP server, never to the organization API. | [optional] [default to undefined]
9
9
  **scopes** | **Array&lt;string&gt;** | Optional subset of the agent\&#39;s capabilities to carry in the token. Omit for all of them; a scope the agent does not have is rejected with 400. | [optional] [default to undefined]
10
+ **resource** | **string** | Optional resource URI of an active MCP server of this organization. The token is then audience-bound to that server (and no longer works on the LumoAuth API) and lives at most the server\&#39;s token lifetime. Servers that require DPoP are refused with 400. | [optional] [default to undefined]
10
11
 
11
12
  ## Example
12
13
 
@@ -16,6 +17,7 @@ import { AdminAgentsGenerateTokenRequest } from '@lumoauth/api-client';
16
17
  const instance: AdminAgentsGenerateTokenRequest = {
17
18
  expiresIn,
18
19
  scopes,
20
+ resource,
19
21
  };
20
22
  ```
21
23
 
@@ -8,7 +8,9 @@ Name | Type | Description | Notes
8
8
  **accessToken** | **string** | | [optional] [default to undefined]
9
9
  **tokenType** | **string** | | [optional] [default to undefined]
10
10
  **expiresIn** | **number** | | [optional] [default to undefined]
11
+ **jti** | **string** | The token id. Written to the agent.token_issued audit event; the kill switch and a capability reduction deny-list it. | [optional] [default to undefined]
11
12
  **scopes** | **Array&lt;string&gt;** | | [optional] [default to undefined]
13
+ **resource** | **string** | The MCP server the token is bound to, when &#x60;resource&#x60; was sent. | [optional] [default to undefined]
12
14
 
13
15
  ## Example
14
16
 
@@ -19,7 +21,9 @@ const instance: AdminAgentsGenerateTokenResponseData = {
19
21
  accessToken,
20
22
  tokenType,
21
23
  expiresIn,
24
+ jti,
22
25
  scopes,
26
+ resource,
23
27
  };
24
28
  ```
25
29
 
@@ -0,0 +1,20 @@
1
+ # AdminClientsGetBrandingResponse
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **data** | [**AdminClientsGetBrandingResponseData**](AdminClientsGetBrandingResponseData.md) | | [optional] [default to undefined]
9
+
10
+ ## Example
11
+
12
+ ```typescript
13
+ import { AdminClientsGetBrandingResponse } from '@lumoauth/api-client';
14
+
15
+ const instance: AdminClientsGetBrandingResponse = {
16
+ data,
17
+ };
18
+ ```
19
+
20
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,22 @@
1
+ # AdminClientsGetBrandingResponseData
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **login** | **{ [key: string]: any; }** | | [optional] [default to undefined]
9
+ **consent** | **{ [key: string]: any; }** | | [optional] [default to undefined]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AdminClientsGetBrandingResponseData } from '@lumoauth/api-client';
15
+
16
+ const instance: AdminClientsGetBrandingResponseData = {
17
+ login,
18
+ consent,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -28,10 +28,14 @@ const apiInstance = new AdminEmailApi(configuration);
28
28
 
29
29
  let orgId: string; // (default to undefined)
30
30
  let type: string; // (default to undefined)
31
+ let locale: string; // (optional) (default to undefined)
32
+ let clientId: string; // (optional) (default to undefined)
31
33
 
32
34
  const { status, data } = await apiInstance.adminEmailTemplatesDelete(
33
35
  orgId,
34
- type
36
+ type,
37
+ locale,
38
+ clientId
35
39
  );
36
40
  ```
37
41
 
@@ -41,6 +45,8 @@ const { status, data } = await apiInstance.adminEmailTemplatesDelete(
41
45
  |------------- | ------------- | ------------- | -------------|
42
46
  | **orgId** | [**string**] | | defaults to undefined|
43
47
  | **type** | [**string**] | | defaults to undefined|
48
+ | **locale** | [**string**] | | (optional) defaults to undefined|
49
+ | **clientId** | [**string**] | | (optional) defaults to undefined|
44
50
 
45
51
 
46
52
  ### Return type
@@ -82,10 +88,14 @@ const apiInstance = new AdminEmailApi(configuration);
82
88
 
83
89
  let orgId: string; // (default to undefined)
84
90
  let type: string; // (default to undefined)
91
+ let locale: string; //Language variant (BCP 47, e.g. fr or pt-BR); omit for the variant used in every language (optional) (default to undefined)
92
+ let clientId: string; //Application variant (OAuth client_id); omit for the variant used by every application (optional) (default to undefined)
85
93
 
86
94
  const { status, data } = await apiInstance.adminEmailTemplatesGet(
87
95
  orgId,
88
- type
96
+ type,
97
+ locale,
98
+ clientId
89
99
  );
90
100
  ```
91
101
 
@@ -95,6 +105,8 @@ const { status, data } = await apiInstance.adminEmailTemplatesGet(
95
105
  |------------- | ------------- | ------------- | -------------|
96
106
  | **orgId** | [**string**] | | defaults to undefined|
97
107
  | **type** | [**string**] | | defaults to undefined|
108
+ | **locale** | [**string**] | Language variant (BCP 47, e.g. fr or pt-BR); omit for the variant used in every language | (optional) defaults to undefined|
109
+ | **clientId** | [**string**] | Application variant (OAuth client_id); omit for the variant used by every application | (optional) defaults to undefined|
98
110
 
99
111
 
100
112
  ### Return type
@@ -226,6 +238,7 @@ const { status, data } = await apiInstance.adminEmailTemplatesPreview(
226
238
  # **adminEmailTemplatesUpsert**
227
239
  > EmailTemplate adminEmailTemplatesUpsert()
228
240
 
241
+ Body: subject, body_html, and optionally locale (BCP 47) and client_id to save a language- or application-specific version. Mails use the most specific version: application + language, application, language, then the default.
229
242
 
230
243
  ### Example
231
244
 
@@ -12,7 +12,7 @@ All URIs are relative to *https://app.lumoauth.dev*
12
12
  # **adminMcpServersCreate**
13
13
  > AdminMcpServersCreateResponse adminMcpServersCreate()
14
14
 
15
- Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
15
+ Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
16
16
 
17
17
  ### Example
18
18
 
@@ -5,6 +5,7 @@ All URIs are relative to *https://app.lumoauth.dev*
5
5
  |Method | HTTP request | Description|
6
6
  |------------- | ------------- | -------------|
7
7
  |[**adminClientsCimdCheck**](#adminclientscimdcheck) | **POST** /orgs/{orgId}/api/v1/admin/clients/cimd/check | Check a Client ID Metadata Document|
8
+ |[**adminClientsGetBranding**](#adminclientsgetbranding) | **GET** /orgs/{orgId}/api/v1/admin/clients/{clientId}/branding | Get an OAuth client\&#39;s login and consent page branding|
8
9
  |[**createClient**](#createclient) | **POST** /orgs/{orgId}/api/v1/admin/clients | Create an OAuth client|
9
10
  |[**deleteClient**](#deleteclient) | **DELETE** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Delete an OAuth client|
10
11
  |[**disableClient**](#disableclient) | **POST** /orgs/{orgId}/api/v1/admin/clients/{clientId}/disable | Disable an OAuth client|
@@ -12,7 +13,9 @@ All URIs are relative to *https://app.lumoauth.dev*
12
13
  |[**getClient**](#getclient) | **GET** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Get an OAuth client|
13
14
  |[**listClientScopes**](#listclientscopes) | **GET** /orgs/{orgId}/api/v1/admin/clients/{clientId}/scopes | List the scopes granted to an OAuth client|
14
15
  |[**listClients**](#listclients) | **GET** /orgs/{orgId}/api/v1/admin/clients | List OAuth clients|
16
+ |[**patchAdminClientsUpdateBranding**](#patchadminclientsupdatebranding) | **PATCH** /orgs/{orgId}/api/v1/admin/clients/{clientId}/branding | Change keys of an OAuth client\&#39;s login and/or consent page branding|
15
17
  |[**patchClient**](#patchclient) | **PATCH** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Update an OAuth client|
18
+ |[**putAdminClientsUpdateBranding**](#putadminclientsupdatebranding) | **PUT** /orgs/{orgId}/api/v1/admin/clients/{clientId}/branding | Replace an OAuth client\&#39;s login and/or consent page branding|
16
19
  |[**rotateClientSecret**](#rotateclientsecret) | **POST** /orgs/{orgId}/api/v1/admin/clients/{clientId}/rotate-secret | Rotate an OAuth client secret|
17
20
  |[**setClientScopes**](#setclientscopes) | **PUT** /orgs/{orgId}/api/v1/admin/clients/{clientId}/scopes | Replace the scopes granted to an OAuth client|
18
21
  |[**updateClient**](#updateclient) | **PUT** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Replace an OAuth client|
@@ -73,6 +76,61 @@ const { status, data } = await apiInstance.adminClientsCimdCheck(
73
76
 
74
77
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
75
78
 
79
+ # **adminClientsGetBranding**
80
+ > AdminClientsGetBrandingResponse adminClientsGetBranding()
81
+
82
+ Login settings use the same keys as the organization branding settings (GET /settings/branding); a missing or null value means \"same as the organization\".
83
+
84
+ ### Example
85
+
86
+ ```typescript
87
+ import {
88
+ AdminOAuthClientsApi,
89
+ Configuration
90
+ } from '@lumoauth/api-client';
91
+
92
+ const configuration = new Configuration();
93
+ const apiInstance = new AdminOAuthClientsApi(configuration);
94
+
95
+ let orgId: string; // (default to undefined)
96
+ let clientId: string; // (default to undefined)
97
+
98
+ const { status, data } = await apiInstance.adminClientsGetBranding(
99
+ orgId,
100
+ clientId
101
+ );
102
+ ```
103
+
104
+ ### Parameters
105
+
106
+ |Name | Type | Description | Notes|
107
+ |------------- | ------------- | ------------- | -------------|
108
+ | **orgId** | [**string**] | | defaults to undefined|
109
+ | **clientId** | [**string**] | | defaults to undefined|
110
+
111
+
112
+ ### Return type
113
+
114
+ **AdminClientsGetBrandingResponse**
115
+
116
+ ### Authorization
117
+
118
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
119
+
120
+ ### HTTP request headers
121
+
122
+ - **Content-Type**: Not defined
123
+ - **Accept**: application/json
124
+
125
+
126
+ ### HTTP response details
127
+ | Status code | Description | Response headers |
128
+ |-------------|-------------|------------------|
129
+ |**200** | Branding of the application | - |
130
+ |**404** | OAuth client not found | - |
131
+
132
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
133
+
76
134
  # **createClient**
77
135
  > CreateClientResponse createClient()
78
136
 
@@ -443,6 +501,64 @@ const { status, data } = await apiInstance.listClients(
443
501
 
444
502
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
445
503
 
504
+ # **patchAdminClientsUpdateBranding**
505
+ > PatchAdminClientsUpdateBrandingResponse patchAdminClientsUpdateBranding()
506
+
507
+
508
+ ### Example
509
+
510
+ ```typescript
511
+ import {
512
+ AdminOAuthClientsApi,
513
+ Configuration,
514
+ AdminClientsGetBrandingResponseData
515
+ } from '@lumoauth/api-client';
516
+
517
+ const configuration = new Configuration();
518
+ const apiInstance = new AdminOAuthClientsApi(configuration);
519
+
520
+ let orgId: string; // (default to undefined)
521
+ let clientId: string; // (default to undefined)
522
+ let adminClientsGetBrandingResponseData: AdminClientsGetBrandingResponseData; // (optional)
523
+
524
+ const { status, data } = await apiInstance.patchAdminClientsUpdateBranding(
525
+ orgId,
526
+ clientId,
527
+ adminClientsGetBrandingResponseData
528
+ );
529
+ ```
530
+
531
+ ### Parameters
532
+
533
+ |Name | Type | Description | Notes|
534
+ |------------- | ------------- | ------------- | -------------|
535
+ | **adminClientsGetBrandingResponseData** | **AdminClientsGetBrandingResponseData**| | |
536
+ | **orgId** | [**string**] | | defaults to undefined|
537
+ | **clientId** | [**string**] | | defaults to undefined|
538
+
539
+
540
+ ### Return type
541
+
542
+ **PatchAdminClientsUpdateBrandingResponse**
543
+
544
+ ### Authorization
545
+
546
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
547
+
548
+ ### HTTP request headers
549
+
550
+ - **Content-Type**: application/json
551
+ - **Accept**: application/json
552
+
553
+
554
+ ### HTTP response details
555
+ | Status code | Description | Response headers |
556
+ |-------------|-------------|------------------|
557
+ |**200** | Updated branding | - |
558
+ |**404** | OAuth client not found | - |
559
+
560
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
561
+
446
562
  # **patchClient**
447
563
  > UpdateClientResponse patchClient()
448
564
 
@@ -497,6 +613,64 @@ const { status, data } = await apiInstance.patchClient(
497
613
 
498
614
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
499
615
 
616
+ # **putAdminClientsUpdateBranding**
617
+ > PutAdminClientsUpdateBrandingResponse putAdminClientsUpdateBranding()
618
+
619
+
620
+ ### Example
621
+
622
+ ```typescript
623
+ import {
624
+ AdminOAuthClientsApi,
625
+ Configuration,
626
+ PutAdminClientsUpdateBrandingRequest
627
+ } from '@lumoauth/api-client';
628
+
629
+ const configuration = new Configuration();
630
+ const apiInstance = new AdminOAuthClientsApi(configuration);
631
+
632
+ let orgId: string; // (default to undefined)
633
+ let clientId: string; // (default to undefined)
634
+ let putAdminClientsUpdateBrandingRequest: PutAdminClientsUpdateBrandingRequest; // (optional)
635
+
636
+ const { status, data } = await apiInstance.putAdminClientsUpdateBranding(
637
+ orgId,
638
+ clientId,
639
+ putAdminClientsUpdateBrandingRequest
640
+ );
641
+ ```
642
+
643
+ ### Parameters
644
+
645
+ |Name | Type | Description | Notes|
646
+ |------------- | ------------- | ------------- | -------------|
647
+ | **putAdminClientsUpdateBrandingRequest** | **PutAdminClientsUpdateBrandingRequest**| | |
648
+ | **orgId** | [**string**] | | defaults to undefined|
649
+ | **clientId** | [**string**] | | defaults to undefined|
650
+
651
+
652
+ ### Return type
653
+
654
+ **PutAdminClientsUpdateBrandingResponse**
655
+
656
+ ### Authorization
657
+
658
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
659
+
660
+ ### HTTP request headers
661
+
662
+ - **Content-Type**: application/json
663
+ - **Accept**: application/json
664
+
665
+
666
+ ### HTTP response details
667
+ | Status code | Description | Response headers |
668
+ |-------------|-------------|------------------|
669
+ |**200** | Updated branding | - |
670
+ |**404** | OAuth client not found | - |
671
+
672
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
673
+
500
674
  # **rotateClientSecret**
501
675
  > RotateClientSecretResponse rotateClientSecret()
502
676
 
package/docs/AgentsApi.md CHANGED
@@ -125,7 +125,7 @@ const { status, data } = await apiInstance.attest(
125
125
  ### HTTP response details
126
126
  | Status code | Description | Response headers |
127
127
  |-------------|-------------|------------------|
128
- |**200** | Attestation accepted: a short-lived (15 minute) LumoAuth access token scoped to the agent\&#39;s capabilities. | - |
128
+ |**200** | Attestation accepted: a short-lived (15 minute) LumoAuth access token scoped to the agent\&#39;s capabilities, or to the subset named by the optional &#x60;scope&#x60; field of the request body. Sent with a &#x60;DPoP&#x60; header, the token is DPoP-bound (token_type DPoP, cnf.jkt). | - |
129
129
  |**400** | invalid_json or missing_attestation_token. | - |
130
130
  |**401** | attestation_rejected — generic for unknown agent, inactive agent / organization, or a token that failed verification. | - |
131
131
  |**403** | access_policy_denied — a conditional access policy refused the agent (reason code included). | - |
@@ -137,7 +137,7 @@ const { status, data } = await apiInstance.attest(
137
137
  # **authorizeMcp**
138
138
  > AuthorizeMcpResponse authorizeMcp(authorizeMcpRequest)
139
139
 
140
- The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
140
+ An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
141
141
 
142
142
  ### Example
143
143
 
@@ -187,7 +187,8 @@ const { status, data } = await apiInstance.authorizeMcp(
187
187
  |-------------|-------------|------------------|
188
188
  |**200** | Allowed — the agent may invoke the tool. | - |
189
189
  |**403** | Denied — no matching per-tool or server-wide grant. | - |
190
- |**400** | server_id and tool are required, or contain forbidden characters. | - |
190
+ |**400** | server_id and tool are required, or contain forbidden characters, or are too long together. | - |
191
+ |**404** | unknown_server — server_id is not an active MCP server of this organization. | - |
191
192
 
192
193
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
193
194
 
@@ -34,7 +34,6 @@ Name | Type | Description | Notes
34
34
  **pushed_authorization_request_endpoint** | **string** | | [optional] [default to undefined]
35
35
  **require_pushed_authorization_requests** | **boolean** | | [optional] [default to undefined]
36
36
  **dpop_signing_alg_values_supported** | **Array&lt;string&gt;** | | [optional] [default to undefined]
37
- **tls_client_certificate_bound_access_tokens** | **boolean** | | [optional] [default to undefined]
38
37
  **backchannel_authentication_endpoint** | **string** | | [optional] [default to undefined]
39
38
  **backchannel_token_delivery_modes_supported** | **Array&lt;string&gt;** | | [optional] [default to undefined]
40
39
  **backchannel_user_code_parameter_supported** | **boolean** | | [optional] [default to undefined]
@@ -79,7 +78,6 @@ const instance: AuthorizationServerMetadata = {
79
78
  pushed_authorization_request_endpoint,
80
79
  require_pushed_authorization_requests,
81
80
  dpop_signing_alg_values_supported,
82
- tls_client_certificate_bound_access_tokens,
83
81
  backchannel_authentication_endpoint,
84
82
  backchannel_token_delivery_modes_supported,
85
83
  backchannel_user_code_parameter_supported,
@@ -5,7 +5,7 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **server_id** | **string** | | [optional] [default to undefined]
8
+ **server_id** | **string** | Id of an active MCP server registered in this organization. | [optional] [default to undefined]
9
9
  **tool** | **string** | | [optional] [default to undefined]
10
10
 
11
11
  ## Example
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
- **authorization_servers** | **Array&lt;string&gt;** | | [default to undefined]
9
+ **authorization_servers** | **Array&lt;string&gt;** | The organization\&#39;s issuer identifier (RFC 8414). | [default to undefined]
10
10
  **bearer_methods_supported** | **Array&lt;string&gt;** | | [default to undefined]
11
11
  **scopes_supported** | **Array&lt;string&gt;** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | | [optional] [default to undefined]
@@ -7,7 +7,7 @@ Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
9
  **resource_metadata_url** | **string** | Per-server protected resource metadata URL. | [default to undefined]
10
- **authorization_servers** | **Array&lt;string&gt;** | | [default to undefined]
10
+ **authorization_servers** | **Array&lt;string&gt;** | The organization\&#39;s issuer identifier (RFC 8414). | [default to undefined]
11
11
 
12
12
  ## Example
13
13
 
package/docs/McpApi.md CHANGED
@@ -9,6 +9,7 @@ All URIs are relative to *https://app.lumoauth.dev*
9
9
  |[**getServer**](#getserver) | **GET** /orgs/{orgId}/api/v1/mcp/servers/{serverId} | REST API: Get a specific MCP server.|
10
10
  |[**getServerChallenge**](#getserverchallenge) | **GET** /orgs/{orgId}/api/v1/mcp/{serverId}/challenge | Simulated MCP server authorization challenge|
11
11
  |[**listServers**](#listservers) | **GET** /orgs/{orgId}/api/v1/mcp/servers | REST API: List MCP servers for a tenant.|
12
+ |[**mcpServerToolAuthorize**](#mcpservertoolauthorize) | **POST** /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize | Per-tool authorization for an MCP server (server credential)|
12
13
  |[**postServerChallenge**](#postserverchallenge) | **POST** /orgs/{orgId}/api/v1/mcp/{serverId}/challenge | Simulated MCP server authorization challenge (POST)|
13
14
 
14
15
  # **getProtectedResourceMetadata**
@@ -286,6 +287,69 @@ const { status, data } = await apiInstance.listServers(
286
287
 
287
288
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
288
289
 
290
+ # **mcpServerToolAuthorize**
291
+ > McpServerToolAuthorizeResponse mcpServerToolAuthorize(mcpServerToolAuthorizeRequest)
292
+
293
+ Called by the MCP server with its own client-credentials access token (scope mcp:authorize; the client must be listed in the server\'s tool_authorizer_client_ids). The body names the caller the server already verified. The server never forwards the caller\'s token.
294
+
295
+ ### Example
296
+
297
+ ```typescript
298
+ import {
299
+ McpApi,
300
+ Configuration,
301
+ McpServerToolAuthorizeRequest
302
+ } from '@lumoauth/api-client';
303
+
304
+ const configuration = new Configuration();
305
+ const apiInstance = new McpApi(configuration);
306
+
307
+ let orgId: string; // (default to undefined)
308
+ let serverId: string; // (default to undefined)
309
+ let mcpServerToolAuthorizeRequest: McpServerToolAuthorizeRequest; //
310
+
311
+ const { status, data } = await apiInstance.mcpServerToolAuthorize(
312
+ orgId,
313
+ serverId,
314
+ mcpServerToolAuthorizeRequest
315
+ );
316
+ ```
317
+
318
+ ### Parameters
319
+
320
+ |Name | Type | Description | Notes|
321
+ |------------- | ------------- | ------------- | -------------|
322
+ | **mcpServerToolAuthorizeRequest** | **McpServerToolAuthorizeRequest**| | |
323
+ | **orgId** | [**string**] | | defaults to undefined|
324
+ | **serverId** | [**string**] | | defaults to undefined|
325
+
326
+
327
+ ### Return type
328
+
329
+ **McpServerToolAuthorizeResponse**
330
+
331
+ ### Authorization
332
+
333
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
334
+
335
+ ### HTTP request headers
336
+
337
+ - **Content-Type**: application/json
338
+ - **Accept**: application/json
339
+
340
+
341
+ ### HTTP response details
342
+ | Status code | Description | Response headers |
343
+ |-------------|-------------|------------------|
344
+ |**200** | Allowed. | - |
345
+ |**400** | invalid_request — malformed subject or tool. | - |
346
+ |**401** | invalid_token — no valid client-credentials token of this organization. | - |
347
+ |**403** | Denied (allowed&#x3D;false), or insufficient_scope / not an authorizer client of this server. | - |
348
+ |**404** | not_found — unknown organization, or unknown / inactive MCP server. | - |
349
+ |**429** | too_many_requests (Retry-After header). | - |
350
+
351
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
352
+
289
353
  # **postServerChallenge**
290
354
  > GetServerChallengeResponse postServerChallenge()
291
355