lockally 0.2.0 → 0.3.0

data/docs/DomainsApi.md

@@ -4,24 +4,24 @@ All URIs are relative to *https://api.lockally.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**v1_domains_domain_delete**](DomainsApi.md#v1_domains_domain_delete) | **DELETE** /v1/domains/{domain} | Delete a domain |
-| [**v1_domains_domain_get**](DomainsApi.md#v1_domains_domain_get) | **GET** /v1/domains/{domain} | Get a domain |
-| [**v1_domains_domain_return_path_delete**](DomainsApi.md#v1_domains_domain_return_path_delete) | **DELETE** /v1/domains/{domain}/return-path | Turn off the custom Return-Path |
-| [**v1_domains_domain_return_path_get**](DomainsApi.md#v1_domains_domain_return_path_get) | **GET** /v1/domains/{domain}/return-path | Get the custom Return-Path |
-| [**v1_domains_domain_return_path_post**](DomainsApi.md#v1_domains_domain_return_path_post) | **POST** /v1/domains/{domain}/return-path | Turn on the custom Return-Path |
-| [**v1_domains_domain_return_path_verify_post**](DomainsApi.md#v1_domains_domain_return_path_verify_post) | **POST** /v1/domains/{domain}/return-path/verify | Check the custom Return-Path records |
-| [**v1_domains_domain_verify_post**](DomainsApi.md#v1_domains_domain_verify_post) | **POST** /v1/domains/{domain}/verify | Force-poll DNS verification |
-| [**v1_domains_get**](DomainsApi.md#v1_domains_get) | **GET** /v1/domains | List domains |
-| [**v1_domains_post**](DomainsApi.md#v1_domains_post) | **POST** /v1/domains | Register a domain |
+| [**create_domain**](DomainsApi.md#create_domain) | **POST** /v1/domains | Register a domain |
+| [**delete_domain**](DomainsApi.md#delete_domain) | **DELETE** /v1/domains/{domain} | Delete a domain |
+| [**disable_return_path**](DomainsApi.md#disable_return_path) | **DELETE** /v1/domains/{domain}/return-path | Turn off the custom Return-Path |
+| [**enable_return_path**](DomainsApi.md#enable_return_path) | **POST** /v1/domains/{domain}/return-path | Turn on the custom Return-Path |
+| [**get_domain**](DomainsApi.md#get_domain) | **GET** /v1/domains/{domain} | Get a domain |
+| [**get_return_path**](DomainsApi.md#get_return_path) | **GET** /v1/domains/{domain}/return-path | Get the custom Return-Path |
+| [**list_domains**](DomainsApi.md#list_domains) | **GET** /v1/domains | List domains |
+| [**verify_domain**](DomainsApi.md#verify_domain) | **POST** /v1/domains/{domain}/verify | Force-poll DNS verification |
+| [**verify_return_path**](DomainsApi.md#verify_return_path) | **POST** /v1/domains/{domain}/return-path/verify | Check the custom Return-Path records |
 
 
-## v1_domains_domain_delete
+## create_domain
 
-> v1_domains_domain_delete(domain)
+> <Domain> create_domain(create_domain_request)
 
-Delete a domain
+Register a domain
 
-Removes the domain registration. Refuses with 409 if any mailbox is still attached — delete the mailboxes first. 
+Registers a new domain for the calling tenant. Generates a DKIM keypair and verification token. Returns DNS instructions the tenant must publish under their own DNS (verification TXT, SPF include, DKIM TXT, MX records to `mx1`/`mx2.lockally.com`, DMARC seed).  **Idempotent** — re-posting the same domain returns the existing record with the same DKIM keys and token (regenerating would break the tenant's published DNS). Returns 200 on idempotent hit, 201 on first create.  Returns 409 if the domain is already claimed by a different tenant. 
 
 ### Examples
 
@@ -35,31 +35,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::DomainsApi.new
-domain = 'domain_example' # String | 
+create_domain_request = Lockally::CreateDomainRequest.new({domain: 'acme.com'}) # CreateDomainRequest | 
 
 begin
-  # Delete a domain
-  api_instance.v1_domains_domain_delete(domain)
+  # Register a domain
+  result = api_instance.create_domain(create_domain_request)
+  p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_delete: #{e}"
+  puts "Error when calling DomainsApi->create_domain: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_delete_with_http_info variant
+#### Using the create_domain_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> v1_domains_domain_delete_with_http_info(domain)
+> <Array(<Domain>, Integer, Hash)> create_domain_with_http_info(create_domain_request)
 
 ```ruby
 begin
-  # Delete a domain
-  data, status_code, headers = api_instance.v1_domains_domain_delete_with_http_info(domain)
+  # Register a domain
+  data, status_code, headers = api_instance.create_domain_with_http_info(create_domain_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <Domain>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_delete_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->create_domain_with_http_info: #{e}"
 end
 ```
 
@@ -67,11 +68,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **domain** | **String** |  |  |
+| **create_domain_request** | [**CreateDomainRequest**](CreateDomainRequest.md) |  |  |
 
 ### Return type
 
-nil (empty response body)
+[**Domain**](Domain.md)
 
 ### Authorization
 
@@ -79,15 +80,17 @@ nil (empty response body)
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
-- **Accept**: application/problem+json
+- **Content-Type**: application/json
+- **Accept**: application/json, application/problem+json
 
 
-## v1_domains_domain_get
+## delete_domain
 
-> <Domain> v1_domains_domain_get(domain)
+> delete_domain(domain)
 
-Get a domain
+Delete a domain
+
+Removes the domain registration. Refuses with 409 if any mailbox is still attached — delete the mailboxes first. 
 
 ### Examples
 
@@ -104,29 +107,28 @@ api_instance = Lockally::DomainsApi.new
 domain = 'domain_example' # String | 
 
 begin
-  # Get a domain
-  result = api_instance.v1_domains_domain_get(domain)
-  p result
+  # Delete a domain
+  api_instance.delete_domain(domain)
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_get: #{e}"
+  puts "Error when calling DomainsApi->delete_domain: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_get_with_http_info variant
+#### Using the delete_domain_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<Domain>, Integer, Hash)> v1_domains_domain_get_with_http_info(domain)
+> <Array(nil, Integer, Hash)> delete_domain_with_http_info(domain)
 
 ```ruby
 begin
-  # Get a domain
-  data, status_code, headers = api_instance.v1_domains_domain_get_with_http_info(domain)
+  # Delete a domain
+  data, status_code, headers = api_instance.delete_domain_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Domain>
+  p data # => nil
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_get_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->delete_domain_with_http_info: #{e}"
 end
 ```
 
@@ -138,7 +140,7 @@ end
 
 ### Return type
 
-[**Domain**](Domain.md)
+nil (empty response body)
 
 ### Authorization
 
@@ -147,12 +149,12 @@ end
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json, application/problem+json
+- **Accept**: application/problem+json
 
 
-## v1_domains_domain_return_path_delete
+## disable_return_path
 
-> v1_domains_domain_return_path_delete(domain)
+> disable_return_path(domain)
 
 Turn off the custom Return-Path
 
@@ -174,27 +176,27 @@ domain = 'domain_example' # String |
 
 begin
   # Turn off the custom Return-Path
-  api_instance.v1_domains_domain_return_path_delete(domain)
+  api_instance.disable_return_path(domain)
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_delete: #{e}"
+  puts "Error when calling DomainsApi->disable_return_path: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_return_path_delete_with_http_info variant
+#### Using the disable_return_path_with_http_info variant
 
 This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(nil, Integer, Hash)> v1_domains_domain_return_path_delete_with_http_info(domain)
+> <Array(nil, Integer, Hash)> disable_return_path_with_http_info(domain)
 
 ```ruby
 begin
   # Turn off the custom Return-Path
-  data, status_code, headers = api_instance.v1_domains_domain_return_path_delete_with_http_info(domain)
+  data, status_code, headers = api_instance.disable_return_path_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => nil
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_delete_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->disable_return_path_with_http_info: #{e}"
 end
 ```
 
@@ -218,13 +220,13 @@ nil (empty response body)
 - **Accept**: application/problem+json
 
 
-## v1_domains_domain_return_path_get
+## enable_return_path
 
-> <ReturnPath> v1_domains_domain_return_path_get(domain)
+> <ReturnPath> enable_return_path(domain)
 
-Get the custom Return-Path
+Turn on the custom Return-Path
 
-A custom Return-Path moves the envelope sender of mail sent through the API from this domain onto `bounces.<domain>`. Bounce reports then come back to Lockally instead of the sending mailbox, and a bounce that arrives after delivery marks the message bounced, suppresses the address and fires `delivery.bounced`. Mail sent from webmail or mail apps is not affected. DKIM stays signed by the domain itself. `status` is `off`, `pending` (records not confirmed yet) or `active`. 
+Moves it to `pending` and returns the two records to publish on `bounces.<domain>`. Nothing changes for mail until they are confirmed with the verify call. The domain must be verified. Available on every plan except Free. 
 
 ### Examples
 
@@ -241,29 +243,29 @@ api_instance = Lockally::DomainsApi.new
 domain = 'domain_example' # String | 
 
 begin
-  # Get the custom Return-Path
-  result = api_instance.v1_domains_domain_return_path_get(domain)
+  # Turn on the custom Return-Path
+  result = api_instance.enable_return_path(domain)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_get: #{e}"
+  puts "Error when calling DomainsApi->enable_return_path: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_return_path_get_with_http_info variant
+#### Using the enable_return_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<ReturnPath>, Integer, Hash)> v1_domains_domain_return_path_get_with_http_info(domain)
+> <Array(<ReturnPath>, Integer, Hash)> enable_return_path_with_http_info(domain)
 
 ```ruby
 begin
-  # Get the custom Return-Path
-  data, status_code, headers = api_instance.v1_domains_domain_return_path_get_with_http_info(domain)
+  # Turn on the custom Return-Path
+  data, status_code, headers = api_instance.enable_return_path_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <ReturnPath>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_get_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->enable_return_path_with_http_info: #{e}"
 end
 ```
 
@@ -287,13 +289,11 @@ end
 - **Accept**: application/json, application/problem+json
 
 
-## v1_domains_domain_return_path_post
+## get_domain
 
-> <ReturnPath> v1_domains_domain_return_path_post(domain)
+> <Domain> get_domain(domain)
 
-Turn on the custom Return-Path
-
-Moves it to `pending` and returns the two records to publish on `bounces.<domain>`. Nothing changes for mail until they are confirmed with the verify call. The domain must be verified. Available on every plan except Free. 
+Get a domain
 
 ### Examples
 
@@ -310,29 +310,29 @@ api_instance = Lockally::DomainsApi.new
 domain = 'domain_example' # String | 
 
 begin
-  # Turn on the custom Return-Path
-  result = api_instance.v1_domains_domain_return_path_post(domain)
+  # Get a domain
+  result = api_instance.get_domain(domain)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_post: #{e}"
+  puts "Error when calling DomainsApi->get_domain: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_return_path_post_with_http_info variant
+#### Using the get_domain_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<ReturnPath>, Integer, Hash)> v1_domains_domain_return_path_post_with_http_info(domain)
+> <Array(<Domain>, Integer, Hash)> get_domain_with_http_info(domain)
 
 ```ruby
 begin
-  # Turn on the custom Return-Path
-  data, status_code, headers = api_instance.v1_domains_domain_return_path_post_with_http_info(domain)
+  # Get a domain
+  data, status_code, headers = api_instance.get_domain_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <ReturnPath>
+  p data # => <Domain>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_post_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->get_domain_with_http_info: #{e}"
 end
 ```
 
@@ -344,7 +344,7 @@ end
 
 ### Return type
 
-[**ReturnPath**](ReturnPath.md)
+[**Domain**](Domain.md)
 
 ### Authorization
 
@@ -356,13 +356,13 @@ end
 - **Accept**: application/json, application/problem+json
 
 
-## v1_domains_domain_return_path_verify_post
+## get_return_path
 
-> <ReturnPath> v1_domains_domain_return_path_verify_post(domain)
+> <ReturnPath> get_return_path(domain)
 
-Check the custom Return-Path records
+Get the custom Return-Path
 
-Looks up the MX and SPF records on `bounces.<domain>`. Returns 200 either way: while a record is missing the status stays `pending` and `check` says which one. Once both are found the Return-Path becomes `active` and the send path starts using it. 
+A custom Return-Path moves the envelope sender of mail sent through the API from this domain onto `bounces.<domain>`. Bounce reports then come back to Lockally instead of the sending mailbox, and a bounce that arrives after delivery marks the message bounced, suppresses the address and fires `delivery.bounced`. Mail sent from webmail or mail apps is not affected. DKIM stays signed by the domain itself. `status` is `off`, `pending` (records not confirmed yet) or `active`. 
 
 ### Examples
 
@@ -379,29 +379,29 @@ api_instance = Lockally::DomainsApi.new
 domain = 'domain_example' # String | 
 
 begin
-  # Check the custom Return-Path records
-  result = api_instance.v1_domains_domain_return_path_verify_post(domain)
+  # Get the custom Return-Path
+  result = api_instance.get_return_path(domain)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_verify_post: #{e}"
+  puts "Error when calling DomainsApi->get_return_path: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_return_path_verify_post_with_http_info variant
+#### Using the get_return_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<ReturnPath>, Integer, Hash)> v1_domains_domain_return_path_verify_post_with_http_info(domain)
+> <Array(<ReturnPath>, Integer, Hash)> get_return_path_with_http_info(domain)
 
 ```ruby
 begin
-  # Check the custom Return-Path records
-  data, status_code, headers = api_instance.v1_domains_domain_return_path_verify_post_with_http_info(domain)
+  # Get the custom Return-Path
+  data, status_code, headers = api_instance.get_return_path_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <ReturnPath>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_return_path_verify_post_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->get_return_path_with_http_info: #{e}"
 end
 ```
 
@@ -425,13 +425,13 @@ end
 - **Accept**: application/json, application/problem+json
 
 
-## v1_domains_domain_verify_post
+## list_domains
 
-> <Domain> v1_domains_domain_verify_post(domain)
+> <ListDomains200Response> list_domains
 
-Force-poll DNS verification
+List domains
 
-Synchronously checks the `_lockally-verify.<domain>` TXT record against the stored verification token. Returns 200 either way: the returned `verified` boolean tells you whether DNS now confirms. Caller polls until `verified: true`. In v2 a background worker auto-polls and fires a `domain.verified` webhook. 
+Returns every domain registered under the calling tenant.
 
 ### Examples
 
@@ -445,44 +445,41 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::DomainsApi.new
-domain = 'domain_example' # String | 
 
 begin
-  # Force-poll DNS verification
-  result = api_instance.v1_domains_domain_verify_post(domain)
+  # List domains
+  result = api_instance.list_domains
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_verify_post: #{e}"
+  puts "Error when calling DomainsApi->list_domains: #{e}"
 end
 ```
 
-#### Using the v1_domains_domain_verify_post_with_http_info variant
+#### Using the list_domains_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Domain>, Integer, Hash)> v1_domains_domain_verify_post_with_http_info(domain)
+> <Array(<ListDomains200Response>, Integer, Hash)> list_domains_with_http_info
 
 ```ruby
 begin
-  # Force-poll DNS verification
-  data, status_code, headers = api_instance.v1_domains_domain_verify_post_with_http_info(domain)
+  # List domains
+  data, status_code, headers = api_instance.list_domains_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Domain>
+  p data # => <ListDomains200Response>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_domain_verify_post_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->list_domains_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **domain** | **String** |  |  |
+This endpoint does not need any parameter.
 
 ### Return type
 
-[**Domain**](Domain.md)
+[**ListDomains200Response**](ListDomains200Response.md)
 
 ### Authorization
 
@@ -494,13 +491,13 @@ end
 - **Accept**: application/json, application/problem+json
 
 
-## v1_domains_get
+## verify_domain
 
-> <V1DomainsGet200Response> v1_domains_get
+> <Domain> verify_domain(domain)
 
-List domains
+Force-poll DNS verification
 
-Returns every domain registered under the calling tenant.
+Synchronously checks the `_lockally-verify.<domain>` TXT record against the stored verification token. Returns 200 either way: the returned `verified` boolean tells you whether DNS now confirms. Caller polls until `verified: true`. In v2 a background worker auto-polls and fires a `domain.verified` webhook. 
 
 ### Examples
 
@@ -514,41 +511,44 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::DomainsApi.new
+domain = 'domain_example' # String | 
 
 begin
-  # List domains
-  result = api_instance.v1_domains_get
+  # Force-poll DNS verification
+  result = api_instance.verify_domain(domain)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_get: #{e}"
+  puts "Error when calling DomainsApi->verify_domain: #{e}"
 end
 ```
 
-#### Using the v1_domains_get_with_http_info variant
+#### Using the verify_domain_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<V1DomainsGet200Response>, Integer, Hash)> v1_domains_get_with_http_info
+> <Array(<Domain>, Integer, Hash)> verify_domain_with_http_info(domain)
 
 ```ruby
 begin
-  # List domains
-  data, status_code, headers = api_instance.v1_domains_get_with_http_info
+  # Force-poll DNS verification
+  data, status_code, headers = api_instance.verify_domain_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <V1DomainsGet200Response>
+  p data # => <Domain>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_get_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->verify_domain_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **domain** | **String** |  |  |
 
 ### Return type
 
-[**V1DomainsGet200Response**](V1DomainsGet200Response.md)
+[**Domain**](Domain.md)
 
 ### Authorization
 
@@ -560,13 +560,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json, application/problem+json
 
 
-## v1_domains_post
+## verify_return_path
 
-> <Domain> v1_domains_post(v1_domains_post_request)
+> <ReturnPath> verify_return_path(domain)
 
-Register a domain
+Check the custom Return-Path records
 
-Registers a new domain for the calling tenant. Generates a DKIM keypair and verification token. Returns DNS instructions the tenant must publish under their own DNS (verification TXT, SPF include, DKIM TXT, MX records to `mx1`/`mx2.lockally.com`, DMARC seed).  **Idempotent** — re-posting the same domain returns the existing record with the same DKIM keys and token (regenerating would break the tenant's published DNS). Returns 200 on idempotent hit, 201 on first create.  Returns 409 if the domain is already claimed by a different tenant. 
+Looks up the MX and SPF records on `bounces.<domain>`. Returns 200 either way: while a record is missing the status stays `pending` and `check` says which one. Once both are found the Return-Path becomes `active` and the send path starts using it. 
 
 ### Examples
 
@@ -580,32 +580,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::DomainsApi.new
-v1_domains_post_request = Lockally::V1DomainsPostRequest.new({domain: 'acme.com'}) # V1DomainsPostRequest | 
+domain = 'domain_example' # String | 
 
 begin
-  # Register a domain
-  result = api_instance.v1_domains_post(v1_domains_post_request)
+  # Check the custom Return-Path records
+  result = api_instance.verify_return_path(domain)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_post: #{e}"
+  puts "Error when calling DomainsApi->verify_return_path: #{e}"
 end
 ```
 
-#### Using the v1_domains_post_with_http_info variant
+#### Using the verify_return_path_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Domain>, Integer, Hash)> v1_domains_post_with_http_info(v1_domains_post_request)
+> <Array(<ReturnPath>, Integer, Hash)> verify_return_path_with_http_info(domain)
 
 ```ruby
 begin
-  # Register a domain
-  data, status_code, headers = api_instance.v1_domains_post_with_http_info(v1_domains_post_request)
+  # Check the custom Return-Path records
+  data, status_code, headers = api_instance.verify_return_path_with_http_info(domain)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <Domain>
+  p data # => <ReturnPath>
 rescue Lockally::ApiError => e
-  puts "Error when calling DomainsApi->v1_domains_post_with_http_info: #{e}"
+  puts "Error when calling DomainsApi->verify_return_path_with_http_info: #{e}"
 end
 ```
 
@@ -613,11 +613,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **v1_domains_post_request** | [**V1DomainsPostRequest**](V1DomainsPostRequest.md) |  |  |
+| **domain** | **String** |  |  |
 
 ### Return type
 
-[**Domain**](Domain.md)
+[**ReturnPath**](ReturnPath.md)
 
 ### Authorization
 
@@ -625,6 +625,6 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json, application/problem+json
 

data/docs/Draft.md

@@ -0,0 +1,44 @@
+# Lockally::Draft
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **mailbox_id** | **String** |  |  |
+| **mailbox** | **String** |  | [optional] |
+| **thread_id** | **String** |  | [optional] |
+| **to** | **Array<String>** |  |  |
+| **cc** | **Array<String>** |  | [optional] |
+| **subject** | **String** |  | [optional] |
+| **body_text** | **String** |  | [optional] |
+| **status** | **String** |  |  |
+| **policy_flags** | **Hash<String, Object>** |  |  |
+| **reviewed_at** | **Time** |  | [optional] |
+| **sent_message_id** | **String** |  | [optional] |
+| **created_at** | **Time** |  |  |
+| **updated_at** | **Time** |  |  |
+
+## Example
+
+```ruby
+require 'lockally'
+
+instance = Lockally::Draft.new(
+  id: null,
+  mailbox_id: null,
+  mailbox: null,
+  thread_id: null,
+  to: null,
+  cc: null,
+  subject: null,
+  body_text: null,
+  status: null,
+  policy_flags: null,
+  reviewed_at: null,
+  sent_message_id: null,
+  created_at: null,
+  updated_at: null
+)
+```
+