zyphr 0.1.68 → 0.1.70

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f2596b07d582f41c8c0b47870fffed76bec30e6300074c61eeeb07ffc920a45
-  data.tar.gz: 47f799255402c58ae0f684dc8702ebe17c7da8b99065fa979a4c03a74168afc9
+  metadata.gz: ec25f83ab94d668fb0e695cea147b873355b441a475342b8ee4ceadc07c5fee0
+  data.tar.gz: 540ca72ea16878da2e76ea11959a267267e6163fb37251e93bdf60ffc537dd9b
 SHA512:
-  metadata.gz: 34a1cdbd81300103324cbb8a4974cabc52430a5b83993cea0412362e98b1d26cc38202215e00c08ec3be2fe5ddcb2ba53bb8defc183e5d8dbfba374674b53722
-  data.tar.gz: 89554d02d1dec553df415938f8eb1cc60d68e12b12a96297e351219a59539d466d8117d7c65989265639f6f3e452592d442cf01e6a94b55029303e1fe323d242
+  metadata.gz: 2a46fb8778200bcd7a06c943d2c35974bcaff35697416728776be4420d28c6f673ea1ef6c346c0b4e657907710eddb03566e545f06104526ac769039103ca2ee
+  data.tar.gz: 7790e1ccab6c414ca5043e43273517599ded85f20d6b0e354b70b4a90a17392b5c4ec8e3d99b9dfe443f2c4909507fb38892037e2753c176781115182c9d020c

data/README.md

@@ -505,6 +505,8 @@ Class | Method | HTTP request | Description
  - [Zyphr::ExecutionRetryResponse](docs/ExecutionRetryResponse.md)
  - [Zyphr::ExecutionRetryResponseData](docs/ExecutionRetryResponseData.md)
  - [Zyphr::ForgotPasswordRequest](docs/ForgotPasswordRequest.md)
+ - [Zyphr::ForgotPasswordResult](docs/ForgotPasswordResult.md)
+ - [Zyphr::ForgotPasswordResultData](docs/ForgotPasswordResultData.md)
  - [Zyphr::GenerateSubscriberToken200Response](docs/GenerateSubscriberToken200Response.md)
  - [Zyphr::GenerateSubscriberToken200ResponseData](docs/GenerateSubscriberToken200ResponseData.md)
  - [Zyphr::GenerateSubscriberTokenRequest](docs/GenerateSubscriberTokenRequest.md)
@@ -558,6 +560,8 @@ Class | Method | HTTP request | Description
  - [Zyphr::ListWorkflows200ResponseMeta](docs/ListWorkflows200ResponseMeta.md)
  - [Zyphr::LoginRequest](docs/LoginRequest.md)
  - [Zyphr::MagicLinkSendRequest](docs/MagicLinkSendRequest.md)
+ - [Zyphr::MagicLinkSendResult](docs/MagicLinkSendResult.md)
+ - [Zyphr::MagicLinkSendResultData](docs/MagicLinkSendResultData.md)
  - [Zyphr::MagicLinkVerifyRequest](docs/MagicLinkVerifyRequest.md)
  - [Zyphr::MagicLinkVerifyResponse](docs/MagicLinkVerifyResponse.md)
  - [Zyphr::MagicLinkVerifyResponseData](docs/MagicLinkVerifyResponseData.md)
@@ -666,6 +670,7 @@ Class | Method | HTTP request | Description
  - [Zyphr::ResetPasswordResponse](docs/ResetPasswordResponse.md)
  - [Zyphr::ResubscribeRequest](docs/ResubscribeRequest.md)
  - [Zyphr::ResubscribeResponse](docs/ResubscribeResponse.md)
+ - [Zyphr::ReturnedAuthLink](docs/ReturnedAuthLink.md)
  - [Zyphr::RevokeAllSessionsResponse](docs/RevokeAllSessionsResponse.md)
  - [Zyphr::RevokeAllSessionsResponseData](docs/RevokeAllSessionsResponseData.md)
  - [Zyphr::RevokeSessionRequest](docs/RevokeSessionRequest.md)

data/docs/AuthMagicLinksApi.md

@@ -10,11 +10,11 @@ All URIs are relative to *https://api.zyphr.dev/v1*
 
 ## send_magic_link
 
-> <SuccessResult> send_magic_link(magic_link_send_request)
+> <MagicLinkSendResult> send_magic_link(magic_link_send_request)
 
 Send a magic link
 
-Send a magic link email for passwordless authentication.
+Send a magic link email for passwordless authentication.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the link but sends nothing, returning it in `data.link`. Requires your application secret, so call it server-side only. 
 
 ### Examples
 
@@ -50,7 +50,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SuccessResult>, Integer, Hash)> send_magic_link_with_http_info(magic_link_send_request)
+> <Array(<MagicLinkSendResult>, Integer, Hash)> send_magic_link_with_http_info(magic_link_send_request)
 
 ```ruby
 begin
@@ -58,7 +58,7 @@ begin
   data, status_code, headers = api_instance.send_magic_link_with_http_info(magic_link_send_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SuccessResult>
+  p data # => <MagicLinkSendResult>
 rescue Zyphr::ApiError => e
   puts "Error when calling AuthMagicLinksApi->send_magic_link_with_http_info: #{e}"
 end
@@ -72,7 +72,7 @@ end
 
 ### Return type
 
-[**SuccessResult**](SuccessResult.md)
+[**MagicLinkSendResult**](MagicLinkSendResult.md)
 
 ### Authorization
 

data/docs/AuthPasswordResetApi.md

@@ -11,11 +11,11 @@ All URIs are relative to *https://api.zyphr.dev/v1*
 
 ## forgot_password
 
-> <SuccessResult> forgot_password(forgot_password_request)
+> <ForgotPasswordResult> forgot_password(forgot_password_request)
 
 Request a password reset
 
-Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`. 
+Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the token but sends nothing, returning the link in `data.link`. When no link is minted, `data.link` is null and `data.link_suppressed_reason` says why. Unlike the default response, this reveals whether the address is registered — acceptable only because the endpoint requires your application secret, so it must only be called server-side. 
 
 ### Examples
 
@@ -51,7 +51,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<SuccessResult>, Integer, Hash)> forgot_password_with_http_info(forgot_password_request)
+> <Array(<ForgotPasswordResult>, Integer, Hash)> forgot_password_with_http_info(forgot_password_request)
 
 ```ruby
 begin
@@ -59,7 +59,7 @@ begin
   data, status_code, headers = api_instance.forgot_password_with_http_info(forgot_password_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <SuccessResult>
+  p data # => <ForgotPasswordResult>
 rescue Zyphr::ApiError => e
   puts "Error when calling AuthPasswordResetApi->forgot_password_with_http_info: #{e}"
 end
@@ -73,7 +73,7 @@ end
 
 ### Return type
 
-[**SuccessResult**](SuccessResult.md)
+[**ForgotPasswordResult**](ForgotPasswordResult.md)
 
 ### Authorization
 

data/docs/AuthUserDirectoryApi.md

@@ -400,7 +400,7 @@ end
 
 Pre-provision (invite) an end user (server-side admin)
 
-Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted). 
+Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted).  **Sending the email yourself:** pass `return_link: true` with a `send_link` and Zyphr mints that link but sends nothing, returning it in `data.link` (`link_sent` stays false). The same `link_suppressed_reason` values apply when no link can be minted. 
 
 ### Examples
 

data/docs/ForgotPasswordRequest.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **email** | **String** |  |  |
 | **redirect_url** | **String** |  | [optional] |
+| **return_link** | **Boolean** | When true, Zyphr mints the token but sends no email, and returns the link in `data.link` so you can render and send the email yourself (for example through `POST /v1/emails`). Requires `redirect_url`.  | [optional][default to false] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'zyphr'
 
 instance = Zyphr::ForgotPasswordRequest.new(
   email: null,
-  redirect_url: null
+  redirect_url: null,
+  return_link: null
 )
 ```
 

data/docs/ForgotPasswordResult.md

@@ -0,0 +1,20 @@
+# Zyphr::ForgotPasswordResult
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**ForgotPasswordResultData**](ForgotPasswordResultData.md) |  | [optional] |
+| **meta** | [**GetDomain200ResponseMeta**](GetDomain200ResponseMeta.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::ForgotPasswordResult.new(
+  data: null,
+  meta: null
+)
+```
+

data/docs/ForgotPasswordResultData.md

@@ -0,0 +1,22 @@
+# Zyphr::ForgotPasswordResultData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **link** | [**ReturnedAuthLink**](ReturnedAuthLink.md) | Present only when `return_link` was true; null when no link was minted. | [optional] |
+| **link_suppressed_reason** | **String** | Present only when `return_link` was true and `link` is null. | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::ForgotPasswordResultData.new(
+  success: null,
+  link: null,
+  link_suppressed_reason: null
+)
+```
+

data/docs/InviteEndUser200ResponseData.md

@@ -7,6 +7,7 @@
 | **user_id** | **String** |  | [optional] |
 | **created** | **Boolean** | True when a new user was provisioned; false when an existing user was reused (idempotent on email). | [optional] |
 | **link_sent** | **Boolean** | True when the requested invitation, magic-link or password-reset email was successfully dispatched. | [optional] |
+| **link** | [**ReturnedAuthLink**](ReturnedAuthLink.md) |  | [optional] |
 | **link_suppressed_reason** | **String** | Present only when `send_link` was requested and `link_sent` is false — explains why, so a caller can distinguish \"suppressed by design\" from \"delivery failed\".  Known values:  - `identity_has_other_auth_methods` — the identity has no password but does have a   linked OAuth provider and/or a passkey, so it is not locked out and no   set-password link is sent. The attempt is recorded as a suppressed message,   visible via `GET /emails`.   (For `send_link: \"invitation\"` the reason is returned here only; no   suppressed message is recorded.) - `user_has_password` — `send_link: \"invitation\"` only: the identity already has   a password, so there is nothing to accept. Use `password_reset` to send a reset. - `user_not_found_in_environment` — the identity could not be resolved in the   calling environment (a race; it was created or resolved immediately prior). - `recipient_not_allowlisted` — the application's `test_recipients` allowlist   blocked the recipient. - `send_failed` — dispatch was attempted and failed with no more specific code.  Not a closed set: a mail-provider error code may be surfaced verbatim, so treat an unrecognised value as a generic failure rather than an error.  | [optional] |
 
 ## Example
@@ -18,6 +19,7 @@ instance = Zyphr::InviteEndUser200ResponseData.new(
   user_id: null,
   created: null,
   link_sent: null,
+  link: null,
   link_suppressed_reason: identity_has_other_auth_methods
 )
 ```

data/docs/InviteEndUserRequest.md

@@ -9,6 +9,7 @@
 | **metadata** | **Object** |  | [optional] |
 | **send_link** | **String** |  | [optional][default to 'none'] |
 | **redirect_url** | **String** |  | [optional] |
+| **return_link** | **Boolean** | Return the link in `data.link` instead of emailing it. Requires `send_link` other than \"none\". | [optional][default to false] |
 
 ## Example
 
@@ -20,7 +21,8 @@ instance = Zyphr::InviteEndUserRequest.new(
   name: null,
   metadata: null,
   send_link: null,
-  redirect_url: null
+  redirect_url: null,
+  return_link: null
 )
 ```
 

data/docs/MagicLinkSendRequest.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **email** | **String** |  |  |
 | **redirect_url** | **String** |  | [optional] |
+| **return_link** | **Boolean** | When true, Zyphr mints the token but sends no email, and returns the link in `data.link` so you can render and send the email yourself (for example through `POST /v1/emails`). Requires `redirect_url`.  | [optional][default to false] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'zyphr'
 
 instance = Zyphr::MagicLinkSendRequest.new(
   email: null,
-  redirect_url: null
+  redirect_url: null,
+  return_link: null
 )
 ```
 

data/docs/MagicLinkSendResult.md

@@ -0,0 +1,20 @@
+# Zyphr::MagicLinkSendResult
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**MagicLinkSendResultData**](MagicLinkSendResultData.md) |  | [optional] |
+| **meta** | [**GetDomain200ResponseMeta**](GetDomain200ResponseMeta.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::MagicLinkSendResult.new(
+  data: null,
+  meta: null
+)
+```
+

data/docs/MagicLinkSendResultData.md

@@ -0,0 +1,20 @@
+# Zyphr::MagicLinkSendResultData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **link** | [**ReturnedAuthLink**](ReturnedAuthLink.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::MagicLinkSendResultData.new(
+  success: null,
+  link: null
+)
+```
+

data/docs/ReturnedAuthLink.md

@@ -0,0 +1,22 @@
+# Zyphr::ReturnedAuthLink
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | Your `redirect_url` with `?token=` appended — the same URL Zyphr's email would carry. |  |
+| **token** | **String** | The raw token, redeemed at the matching endpoint (`/auth/magic-link/verify` or `/auth/reset-password`). |  |
+| **expires_at** | **Time** |  |  |
+
+## Example
+
+```ruby
+require 'zyphr'
+
+instance = Zyphr::ReturnedAuthLink.new(
+  url: null,
+  token: null,
+  expires_at: null
+)
+```
+

data/docs/WebhooksApi.md

@@ -815,7 +815,7 @@ end
 
 Get webhook usage metrics
 
-Get webhook delivery usage statistics for the current billing period.
+Get webhook delivery usage statistics for this project in the current billing period. The plan limit applies to the whole account.
 
 ### Examples
 

data/lib/zyphr/api/auth_magic_links_api.rb

@@ -20,20 +20,20 @@ module Zyphr
       @api_client = api_client
     end
     # Send a magic link
-    # Send a magic link email for passwordless authentication.
+    # Send a magic link email for passwordless authentication.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the link but sends nothing, returning it in `data.link`. Requires your application secret, so call it server-side only. 
     # @param magic_link_send_request [MagicLinkSendRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [SuccessResult]
+    # @return [MagicLinkSendResult]
     def send_magic_link(magic_link_send_request, opts = {})
       data, _status_code, _headers = send_magic_link_with_http_info(magic_link_send_request, opts)
       data
     end
 
     # Send a magic link
-    # Send a magic link email for passwordless authentication.
+    # Send a magic link email for passwordless authentication.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the link but sends nothing, returning it in `data.link`. Requires your application secret, so call it server-side only. 
     # @param magic_link_send_request [MagicLinkSendRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(SuccessResult, Integer, Hash)>] SuccessResult data, response status code and response headers
+    # @return [Array<(MagicLinkSendResult, Integer, Hash)>] MagicLinkSendResult data, response status code and response headers
     def send_magic_link_with_http_info(magic_link_send_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AuthMagicLinksApi.send_magic_link ...'
@@ -65,7 +65,7 @@ module Zyphr
       post_body = opts[:debug_body] || @api_client.object_to_http_body(magic_link_send_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'SuccessResult'
+      return_type = opts[:debug_return_type] || 'MagicLinkSendResult'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApplicationSecret', 'ApplicationPublicKey']

data/lib/zyphr/api/auth_password_reset_api.rb

@@ -20,20 +20,20 @@ module Zyphr
       @api_client = api_client
     end
     # Request a password reset
-    # Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`. 
+    # Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the token but sends nothing, returning the link in `data.link`. When no link is minted, `data.link` is null and `data.link_suppressed_reason` says why. Unlike the default response, this reveals whether the address is registered — acceptable only because the endpoint requires your application secret, so it must only be called server-side. 
     # @param forgot_password_request [ForgotPasswordRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [SuccessResult]
+    # @return [ForgotPasswordResult]
     def forgot_password(forgot_password_request, opts = {})
       data, _status_code, _headers = forgot_password_with_http_info(forgot_password_request, opts)
       data
     end
 
     # Request a password reset
-    # Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`. 
+    # Request a password reset email. Creates a reset token and sends an email to the user. Always returns success to prevent email enumeration — the response is identical whether or not the address is registered.  An identity with **no password set** still receives a link, which sets a first password. This covers users migrated from a provider that cannot export password hashes.  The one case where no email is sent (beyond an unknown address) is an identity that has no password but *does* have another way in — a linked OAuth provider and/or a passkey. Those users are not locked out, so no set-password link is sent; the attempt is recorded as a suppressed message visible via `GET /emails`.  **Sending the email yourself:** pass `return_link: true` (with `redirect_url`) and Zyphr mints the token but sends nothing, returning the link in `data.link`. When no link is minted, `data.link` is null and `data.link_suppressed_reason` says why. Unlike the default response, this reveals whether the address is registered — acceptable only because the endpoint requires your application secret, so it must only be called server-side. 
     # @param forgot_password_request [ForgotPasswordRequest] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(SuccessResult, Integer, Hash)>] SuccessResult data, response status code and response headers
+    # @return [Array<(ForgotPasswordResult, Integer, Hash)>] ForgotPasswordResult data, response status code and response headers
     def forgot_password_with_http_info(forgot_password_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AuthPasswordResetApi.forgot_password ...'
@@ -65,7 +65,7 @@ module Zyphr
       post_body = opts[:debug_body] || @api_client.object_to_http_body(forgot_password_request)
 
       # return_type
-      return_type = opts[:debug_return_type] || 'SuccessResult'
+      return_type = opts[:debug_return_type] || 'ForgotPasswordResult'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['ApplicationSecret', 'ApplicationPublicKey']

data/lib/zyphr/api/auth_user_directory_api.rb

@@ -334,7 +334,7 @@ module Zyphr
     end
 
     # Pre-provision (invite) an end user (server-side admin)
-    # Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted). 
+    # Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted).  **Sending the email yourself:** pass `return_link: true` with a `send_link` and Zyphr mints that link but sends nothing, returning it in `data.link` (`link_sent` stays false). The same `link_suppressed_reason` values apply when no link can be minted. 
     # @param invite_end_user_request [InviteEndUserRequest] 
     # @param [Hash] opts the optional parameters
     # @return [InviteEndUser200Response]
@@ -344,7 +344,7 @@ module Zyphr
     end
 
     # Pre-provision (invite) an end user (server-side admin)
-    # Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted). 
+    # Secret-key-scoped pre-provisioning for an end user. Creates a passwordless user in the authenticating application (idempotent on email — an existing, non-deleted user is reused, not duplicated) and, when `send_link` is set, sends a first-login link so the user can set up their account without self-registration.  - `send_link: \"invitation\"` sends the `invitation` auth email: a   set-password link (valid 7 days) redeemed at   `POST /auth/reset-password`, so the invitee ends up with a password.   It has its own per-application template, separate from password   reset's. Not sent to an identity that can already sign in. - `send_link: \"password_reset\"` sends a set-password email using the   password-reset template. - `send_link: \"magic\"` sends a magic-link sign-in email. The user   still has no credential afterwards. - `send_link: \"none\"` (default) creates the user with no email.  A `redirect_url` is required whenever `send_link` is not \"none\"; it must match the application's redirect_uris allowlist (custom schemes such as yourapp://path are permitted).  **Sending the email yourself:** pass `return_link: true` with a `send_link` and Zyphr mints that link but sends nothing, returning it in `data.link` (`link_sent` stays false). The same `link_suppressed_reason` values apply when no link can be minted. 
     # @param invite_end_user_request [InviteEndUserRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(InviteEndUser200Response, Integer, Hash)>] InviteEndUser200Response data, response status code and response headers

data/lib/zyphr/api/webhooks_api.rb

@@ -719,7 +719,7 @@ module Zyphr
     end
 
     # Get webhook usage metrics
-    # Get webhook delivery usage statistics for the current billing period.
+    # Get webhook delivery usage statistics for this project in the current billing period. The plan limit applies to the whole account.
     # @param [Hash] opts the optional parameters
     # @return [WebhookUsageResponse]
     def get_webhook_usage(opts = {})
@@ -728,7 +728,7 @@ module Zyphr
     end
 
     # Get webhook usage metrics
-    # Get webhook delivery usage statistics for the current billing period.
+    # Get webhook delivery usage statistics for this project in the current billing period. The plan limit applies to the whole account.
     # @param [Hash] opts the optional parameters
     # @return [Array<(WebhookUsageResponse, Integer, Hash)>] WebhookUsageResponse data, response status code and response headers
     def get_webhook_usage_with_http_info(opts = {})

data/lib/zyphr/models/forgot_password_request.rb

@@ -19,11 +19,15 @@ module Zyphr
 
     attr_accessor :redirect_url
 
+    # When true, Zyphr mints the token but sends no email, and returns the link in `data.link` so you can render and send the email yourself (for example through `POST /v1/emails`). Requires `redirect_url`. 
+    attr_accessor :return_link
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'email' => :'email',
-        :'redirect_url' => :'redirect_url'
+        :'redirect_url' => :'redirect_url',
+        :'return_link' => :'return_link'
       }
     end
 
@@ -41,7 +45,8 @@ module Zyphr
     def self.openapi_types
       {
         :'email' => :'String',
-        :'redirect_url' => :'String'
+        :'redirect_url' => :'String',
+        :'return_link' => :'Boolean'
       }
     end
 
@@ -76,6 +81,12 @@ module Zyphr
       if attributes.key?(:'redirect_url')
         self.redirect_url = attributes[:'redirect_url']
       end
+
+      if attributes.key?(:'return_link')
+        self.return_link = attributes[:'return_link']
+      else
+        self.return_link = false
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -114,7 +125,8 @@ module Zyphr
       return true if self.equal?(o)
       self.class == o.class &&
           email == o.email &&
-          redirect_url == o.redirect_url
+          redirect_url == o.redirect_url &&
+          return_link == o.return_link
     end
 
     # @see the `==` method
@@ -126,7 +138,7 @@ module Zyphr
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [email, redirect_url].hash
+      [email, redirect_url, return_link].hash
     end
 
     # Builds the object from hash