zyphr 0.1.32 → 0.1.33

data/docs/AuthOrganizationsApi.md

@@ -0,0 +1,864 @@
+# Zyphr::AuthOrganizationsApi
+
+All URIs are relative to *https://api.zyphr.dev/v1*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**add_organization_member**](AuthOrganizationsApi.md#add_organization_member) | **POST** /auth/organizations/{id}/members | Add a member to an organization |
+| [**create_organization**](AuthOrganizationsApi.md#create_organization) | **POST** /auth/organizations | Create an organization |
+| [**delete_organization**](AuthOrganizationsApi.md#delete_organization) | **DELETE** /auth/organizations/{id} | Delete an organization |
+| [**get_organization**](AuthOrganizationsApi.md#get_organization) | **GET** /auth/organizations/{id} | Get organization by id |
+| [**list_organization_members**](AuthOrganizationsApi.md#list_organization_members) | **GET** /auth/organizations/{id}/members | List organization members |
+| [**list_organizations**](AuthOrganizationsApi.md#list_organizations) | **GET** /auth/organizations | List organizations |
+| [**list_organizations_for_end_user**](AuthOrganizationsApi.md#list_organizations_for_end_user) | **GET** /auth/end-users/{user_id}/organizations | List organizations an end user belongs to |
+| [**remove_organization_member**](AuthOrganizationsApi.md#remove_organization_member) | **DELETE** /auth/organizations/{id}/members/{user_id} | Remove a member from an organization |
+| [**switch_organization**](AuthOrganizationsApi.md#switch_organization) | **POST** /auth/sessions/switch-organization | Switch the active organization on a session |
+| [**update_organization**](AuthOrganizationsApi.md#update_organization) | **PATCH** /auth/organizations/{id} | Update an organization |
+| [**update_organization_member_role**](AuthOrganizationsApi.md#update_organization_member_role) | **PATCH** /auth/organizations/{id}/members/{user_id} | Update a member's role |
+
+
+## add_organization_member
+
+> <OrganizationMembershipResponse> add_organization_member(id, add_organization_member_request)
+
+Add a member to an organization
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+add_organization_member_request = Zyphr::AddOrganizationMemberRequest.new({user_id: 'user_id_example'}) # AddOrganizationMemberRequest | 
+
+begin
+  # Add a member to an organization
+  result = api_instance.add_organization_member(id, add_organization_member_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->add_organization_member: #{e}"
+end
+```
+
+#### Using the add_organization_member_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationMembershipResponse>, Integer, Hash)> add_organization_member_with_http_info(id, add_organization_member_request)
+
+```ruby
+begin
+  # Add a member to an organization
+  data, status_code, headers = api_instance.add_organization_member_with_http_info(id, add_organization_member_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationMembershipResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->add_organization_member_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **add_organization_member_request** | [**AddOrganizationMemberRequest**](AddOrganizationMemberRequest.md) |  |  |
+
+### Return type
+
+[**OrganizationMembershipResponse**](OrganizationMembershipResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_organization
+
+> <OrganizationResponse> create_organization(create_organization_request)
+
+Create an organization
+
+Create a new organization inside the current application × environment. Membership is many-to-many — add end users via POST /auth/organizations/{id}/members. The Default organization for the environment is auto-created at migration time and cannot be created via API.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+create_organization_request = Zyphr::CreateOrganizationRequest.new({name: 'Acme Inc'}) # CreateOrganizationRequest | 
+
+begin
+  # Create an organization
+  result = api_instance.create_organization(create_organization_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->create_organization: #{e}"
+end
+```
+
+#### Using the create_organization_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationResponse>, Integer, Hash)> create_organization_with_http_info(create_organization_request)
+
+```ruby
+begin
+  # Create an organization
+  data, status_code, headers = api_instance.create_organization_with_http_info(create_organization_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->create_organization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_organization_request** | [**CreateOrganizationRequest**](CreateOrganizationRequest.md) |  |  |
+
+### Return type
+
+[**OrganizationResponse**](OrganizationResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_organization
+
+> delete_organization(id)
+
+Delete an organization
+
+Hard-deletes the org and cascades memberships. The Default organization cannot be deleted.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+
+begin
+  # Delete an organization
+  api_instance.delete_organization(id)
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->delete_organization: #{e}"
+end
+```
+
+#### Using the delete_organization_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)> delete_organization_with_http_info(id)
+
+```ruby
+begin
+  # Delete an organization
+  data, status_code, headers = api_instance.delete_organization_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->delete_organization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+
+## get_organization
+
+> <OrganizationResponse> get_organization(id)
+
+Get organization by id
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+
+begin
+  # Get organization by id
+  result = api_instance.get_organization(id)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->get_organization: #{e}"
+end
+```
+
+#### Using the get_organization_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationResponse>, Integer, Hash)> get_organization_with_http_info(id)
+
+```ruby
+begin
+  # Get organization by id
+  data, status_code, headers = api_instance.get_organization_with_http_info(id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->get_organization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+
+### Return type
+
+[**OrganizationResponse**](OrganizationResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_organization_members
+
+> <OrganizationMembersListResponse> list_organization_members(id, opts)
+
+List organization members
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+opts = {
+  limit: 56, # Integer | 
+  cursor: 'cursor_example' # String | 
+}
+
+begin
+  # List organization members
+  result = api_instance.list_organization_members(id, opts)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organization_members: #{e}"
+end
+```
+
+#### Using the list_organization_members_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationMembersListResponse>, Integer, Hash)> list_organization_members_with_http_info(id, opts)
+
+```ruby
+begin
+  # List organization members
+  data, status_code, headers = api_instance.list_organization_members_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationMembersListResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organization_members_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **limit** | **Integer** |  | [optional][default to 50] |
+| **cursor** | **String** |  | [optional] |
+
+### Return type
+
+[**OrganizationMembersListResponse**](OrganizationMembersListResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_organizations
+
+> <OrganizationListResponse> list_organizations(opts)
+
+List organizations
+
+List organizations in the current environment. Cursor-paginated.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+opts = {
+  limit: 56, # Integer | 
+  cursor: 'cursor_example', # String | 
+  search: 'search_example' # String | ILIKE match on name OR slug
+}
+
+begin
+  # List organizations
+  result = api_instance.list_organizations(opts)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organizations: #{e}"
+end
+```
+
+#### Using the list_organizations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationListResponse>, Integer, Hash)> list_organizations_with_http_info(opts)
+
+```ruby
+begin
+  # List organizations
+  data, status_code, headers = api_instance.list_organizations_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationListResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organizations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **limit** | **Integer** |  | [optional][default to 50] |
+| **cursor** | **String** |  | [optional] |
+| **search** | **String** | ILIKE match on name OR slug | [optional] |
+
+### Return type
+
+[**OrganizationListResponse**](OrganizationListResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_organizations_for_end_user
+
+> <OrganizationListResponse> list_organizations_for_end_user(user_id)
+
+List organizations an end user belongs to
+
+Inverse of the membership list — returns all orgs the user is a member of within the current environment. Use this when the orgs[] JWT claim is omitted because the user belongs to more than 50.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+user_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+
+begin
+  # List organizations an end user belongs to
+  result = api_instance.list_organizations_for_end_user(user_id)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organizations_for_end_user: #{e}"
+end
+```
+
+#### Using the list_organizations_for_end_user_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationListResponse>, Integer, Hash)> list_organizations_for_end_user_with_http_info(user_id)
+
+```ruby
+begin
+  # List organizations an end user belongs to
+  data, status_code, headers = api_instance.list_organizations_for_end_user_with_http_info(user_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationListResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->list_organizations_for_end_user_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user_id** | **String** |  |  |
+
+### Return type
+
+[**OrganizationListResponse**](OrganizationListResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## remove_organization_member
+
+> remove_organization_member(id, user_id)
+
+Remove a member from an organization
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+user_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+
+begin
+  # Remove a member from an organization
+  api_instance.remove_organization_member(id, user_id)
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->remove_organization_member: #{e}"
+end
+```
+
+#### Using the remove_organization_member_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)> remove_organization_member_with_http_info(id, user_id)
+
+```ruby
+begin
+  # Remove a member from an organization
+  data, status_code, headers = api_instance.remove_organization_member_with_http_info(id, user_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->remove_organization_member_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **user_id** | **String** |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+
+## switch_organization
+
+> <SwitchOrganizationResponse> switch_organization(switch_organization_request)
+
+Switch the active organization on a session
+
+Takes a valid refresh token + a target organization the user is a member of, verifies membership at mint time, revokes the old session, and mints a fresh access + refresh pair with `org_id` set to the target. The old refresh token is invalidated (jti rotated). Use this when the user's active workspace changes (the Slack/Linear workspace-switch pattern).
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+switch_organization_request = Zyphr::SwitchOrganizationRequest.new({refresh_token: 'refresh_token_example', organization_id: 'organization_id_example'}) # SwitchOrganizationRequest | 
+
+begin
+  # Switch the active organization on a session
+  result = api_instance.switch_organization(switch_organization_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->switch_organization: #{e}"
+end
+```
+
+#### Using the switch_organization_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SwitchOrganizationResponse>, Integer, Hash)> switch_organization_with_http_info(switch_organization_request)
+
+```ruby
+begin
+  # Switch the active organization on a session
+  data, status_code, headers = api_instance.switch_organization_with_http_info(switch_organization_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SwitchOrganizationResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->switch_organization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **switch_organization_request** | [**SwitchOrganizationRequest**](SwitchOrganizationRequest.md) |  |  |
+
+### Return type
+
+[**SwitchOrganizationResponse**](SwitchOrganizationResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_organization
+
+> <OrganizationResponse> update_organization(id, update_organization_request)
+
+Update an organization
+
+The Default organization cannot be renamed or have its slug/metadata changed.
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+update_organization_request = Zyphr::UpdateOrganizationRequest.new # UpdateOrganizationRequest | 
+
+begin
+  # Update an organization
+  result = api_instance.update_organization(id, update_organization_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->update_organization: #{e}"
+end
+```
+
+#### Using the update_organization_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationResponse>, Integer, Hash)> update_organization_with_http_info(id, update_organization_request)
+
+```ruby
+begin
+  # Update an organization
+  data, status_code, headers = api_instance.update_organization_with_http_info(id, update_organization_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->update_organization_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **update_organization_request** | [**UpdateOrganizationRequest**](UpdateOrganizationRequest.md) |  |  |
+
+### Return type
+
+[**OrganizationResponse**](OrganizationResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_organization_member_role
+
+> <OrganizationMembershipResponse> update_organization_member_role(id, user_id, update_organization_member_role_request)
+
+Update a member's role
+
+### Examples
+
+```ruby
+require 'time'
+require 'zyphr'
+# setup authorization
+Zyphr.configure do |config|
+  # Configure API key authorization: ApplicationSecret
+  config.api_key['X-Application-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Secret'] = 'Bearer'
+
+  # Configure API key authorization: ApplicationPublicKey
+  config.api_key['X-Application-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['X-Application-Key'] = 'Bearer'
+end
+
+api_instance = Zyphr::AuthOrganizationsApi.new
+id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+user_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+update_organization_member_role_request = Zyphr::UpdateOrganizationMemberRoleRequest.new({role: 'role_example'}) # UpdateOrganizationMemberRoleRequest | 
+
+begin
+  # Update a member's role
+  result = api_instance.update_organization_member_role(id, user_id, update_organization_member_role_request)
+  p result
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->update_organization_member_role: #{e}"
+end
+```
+
+#### Using the update_organization_member_role_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<OrganizationMembershipResponse>, Integer, Hash)> update_organization_member_role_with_http_info(id, user_id, update_organization_member_role_request)
+
+```ruby
+begin
+  # Update a member's role
+  data, status_code, headers = api_instance.update_organization_member_role_with_http_info(id, user_id, update_organization_member_role_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <OrganizationMembershipResponse>
+rescue Zyphr::ApiError => e
+  puts "Error when calling AuthOrganizationsApi->update_organization_member_role_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **user_id** | **String** |  |  |
+| **update_organization_member_role_request** | [**UpdateOrganizationMemberRoleRequest**](UpdateOrganizationMemberRoleRequest.md) |  |  |
+
+### Return type
+
+[**OrganizationMembershipResponse**](OrganizationMembershipResponse.md)
+
+### Authorization
+
+[ApplicationSecret](../README.md#ApplicationSecret), [ApplicationPublicKey](../README.md#ApplicationPublicKey)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+