mencoro 1.0.1 → 2.0.0

data/docs/AsyncJobResource.md

@@ -8,6 +8,7 @@
 | **type** | **String** | What the job produces, and therefore the shape of `result` |  |
 | **status** | **String** | A job in `pending`, `running` or `awaiting_retry` is still in flight; `completed` and `failed` are terminal. |  |
 | **result** | **Object** | The job output, shaped by `type`. Null while the job is still in flight and for a job that failed: it means the result is not known, never that the job produced nothing. | [optional] |
+| **error** | [**AsyncJobResourceError**](AsyncJobResourceError.md) |  | [optional] |
 
 ## Example
 
@@ -18,7 +19,8 @@ instance = Mencoro::AsyncJobResource.new(
   job_id: null,
   type: null,
   status: null,
-  result: null
+  result: null,
+  error: null
 )
 ```
 

data/docs/AsyncJobResourceError.md

@@ -0,0 +1,20 @@
+# Mencoro::AsyncJobResourceError
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code** | **String** | A stable code for the kind of failure: `timed_out`, `provider_failed`, `submission_failed` or `internal_error`. |  |
+| **message** | **String** | A fixed, readable explanation of the code. It is the same for every job that failed with that code. |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::AsyncJobResourceError.new(
+  code: null,
+  message: null
+)
+```
+

data/docs/BillingApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://api.mencoro.com*
 
 Get the subscription of an organization
 
-Minimum role: viewer. The most recent subscription contract of the organization, whatever its state: tier, billing interval, check budget and consumption, and the cancellation and grace dates. An organization that has never subscribed answers 200 with \"status\": \"none\" and every other field null - a null is \"not applicable\", never a stand-in for a zero budget or zero consumption. Stripe identifiers, prices and payment methods are not part of this API.
+Minimum role: viewer. The most recent subscription contract of the organization, whatever its state: tier, billing interval, check budget and consumption, and the cancellation and grace dates. An organization that has never subscribed answers 200 with \"status\": \"none\" and every other field null - a null is \"not applicable\", never a stand-in for a zero budget or zero consumption. Stripe identifiers, prices and payment methods are not part of this API. For a member restricted to selected projects, `tierCode`, `billingCycleType`, `billingCycleAnchor`, `checkBudget`, `checksConsumed`, `checksAvailable`, `nextResetAt` and `deactivationReason` are null: they keep `status`, `isEntitled` and the cancellation and grace dates.
 
 ### Examples
 

data/docs/CitedSourceRow.md

@@ -0,0 +1,32 @@
+# Mencoro::CitedSourceRow
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **group_key** | **String** |  |  |
+| **domain** | **String** |  | [optional] |
+| **citation_count** | **Integer** |  |  |
+| **distinct_query_count** | **Integer** |  |  |
+| **distinct_response_count** | **Integer** |  |  |
+| **avg_position** | **Float** |  | [optional] |
+| **sample_title** | **String** |  | [optional] |
+| **sample_url** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CitedSourceRow.new(
+  group_key: null,
+  domain: null,
+  citation_count: null,
+  distinct_query_count: null,
+  distinct_response_count: null,
+  avg_position: null,
+  sample_title: null,
+  sample_url: null
+)
+```
+

data/docs/CitedSourcesResponse.md

@@ -0,0 +1,20 @@
+# Mencoro::CitedSourcesResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **sources** | [**Array<CitedSourceRow>**](CitedSourceRow.md) |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CitedSourcesResponse.new(
+  sources: null,
+  total: null
+)
+```
+

data/docs/ClusterBreakdownRow.md

@@ -0,0 +1,82 @@
+# Mencoro::ClusterBreakdownRow
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **cluster_id** | **String** |  | [optional] |
+| **cluster_name** | **String** |  |  |
+| **query_count** | **Integer** |  |  |
+| **keyword_count** | **Integer** |  |  |
+| **avg_serp_position** | **Float** |  | [optional] |
+| **trend_serp** | **Float** |  | [optional] |
+| **avg_shopping_position** | **Float** |  | [optional] |
+| **trend_shopping** | **Float** |  | [optional] |
+| **avg_mention_position** | **Float** |  | [optional] |
+| **trend_mention** | **Float** |  | [optional] |
+| **avg_link_position** | **Float** |  | [optional] |
+| **trend_link** | **Float** |  | [optional] |
+| **mention_position_stability** | **Float** |  | [optional] |
+| **trend_stability** | **Float** |  | [optional] |
+| **serp_position_stability** | **Float** |  | [optional] |
+| **trend_serp_stability** | **Float** |  | [optional] |
+| **shopping_position_stability** | **Float** |  | [optional] |
+| **trend_shopping_stability** | **Float** |  | [optional] |
+| **positivity_index** | **Integer** |  | [optional] |
+| **trend_positivity** | **Integer** |  | [optional] |
+| **mention_rate** | **Integer** |  | [optional] |
+| **trend_mention_rate** | **Integer** |  | [optional] |
+| **serp_rate** | **Integer** |  | [optional] |
+| **trend_serp_rate** | **Integer** |  | [optional] |
+| **shopping_rate** | **Integer** |  | [optional] |
+| **trend_shopping_rate** | **Integer** |  | [optional] |
+| **share_of_voice** | **Float** |  | [optional] |
+| **trend_share_of_voice** | **Float** |  | [optional] |
+| **sentiment_positive** | **Integer** |  |  |
+| **sentiment_neutral** | **Integer** |  |  |
+| **sentiment_negative** | **Integer** |  |  |
+| **avg_mention_count** | **Float** |  | [optional] |
+| **mention_type_counts** | [**MentionTypeCounts**](MentionTypeCounts.md) |  |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::ClusterBreakdownRow.new(
+  cluster_id: null,
+  cluster_name: null,
+  query_count: null,
+  keyword_count: null,
+  avg_serp_position: null,
+  trend_serp: null,
+  avg_shopping_position: null,
+  trend_shopping: null,
+  avg_mention_position: null,
+  trend_mention: null,
+  avg_link_position: null,
+  trend_link: null,
+  mention_position_stability: null,
+  trend_stability: null,
+  serp_position_stability: null,
+  trend_serp_stability: null,
+  shopping_position_stability: null,
+  trend_shopping_stability: null,
+  positivity_index: null,
+  trend_positivity: null,
+  mention_rate: null,
+  trend_mention_rate: null,
+  serp_rate: null,
+  trend_serp_rate: null,
+  shopping_rate: null,
+  trend_shopping_rate: null,
+  share_of_voice: null,
+  trend_share_of_voice: null,
+  sentiment_positive: null,
+  sentiment_neutral: null,
+  sentiment_negative: null,
+  avg_mention_count: null,
+  mention_type_counts: null
+)
+```
+

data/docs/ClustersApi.md

@@ -8,6 +8,7 @@ All URIs are relative to *https://api.mencoro.com*
 | [**batch_create_query_clusters**](ClustersApi.md#batch_create_query_clusters) | **POST** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters/batch | Create several keyword clusters at once |
 | [**create_query_cluster**](ClustersApi.md#create_query_cluster) | **POST** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters | Create a keyword cluster |
 | [**delete_query_cluster**](ClustersApi.md#delete_query_cluster) | **DELETE** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters/{clusterId} | Delete a keyword cluster |
+| [**get_query_cluster**](ClustersApi.md#get_query_cluster) | **GET** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters/{clusterId} | Get one of a project's keyword clusters |
 | [**rename_query_cluster**](ClustersApi.md#rename_query_cluster) | **PATCH** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters/{clusterId} | Rename a keyword cluster |
 | [**start_clustering_job**](ClustersApi.md#start_clustering_job) | **POST** /api/v1/organizations/{organizationId}/projects/{projectId}/clusters/jobs | Start a keyword clustering job |
 
@@ -312,6 +313,79 @@ end
 - **Accept**: application/json
 
 
+## get_query_cluster
+
+> <QueryClusterResource> get_query_cluster(organization_id, project_id, cluster_id)
+
+Get one of a project's keyword clusters
+
+Minimum role: viewer. Returns a single keyword cluster of the project, the same projection the cluster listing returns for each of its rows. A cluster belonging to another project answers 404, the same answer an unknown id and a malformed one get, so the API never confirms that a cluster the caller cannot reach exists.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mencoro'
+# setup authorization
+Mencoro.configure do |config|
+  # Configure Bearer authorization: ApiKey
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mencoro::ClustersApi.new
+organization_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+project_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | Must belong to the organization in the path.
+cluster_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | Must be a cluster of the project in the path.
+
+begin
+  # Get one of a project's keyword clusters
+  result = api_instance.get_query_cluster(organization_id, project_id, cluster_id)
+  p result
+rescue Mencoro::ApiError => e
+  puts "Error when calling ClustersApi->get_query_cluster: #{e}"
+end
+```
+
+#### Using the get_query_cluster_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<QueryClusterResource>, Integer, Hash)> get_query_cluster_with_http_info(organization_id, project_id, cluster_id)
+
+```ruby
+begin
+  # Get one of a project's keyword clusters
+  data, status_code, headers = api_instance.get_query_cluster_with_http_info(organization_id, project_id, cluster_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <QueryClusterResource>
+rescue Mencoro::ApiError => e
+  puts "Error when calling ClustersApi->get_query_cluster_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **organization_id** | **String** |  |  |
+| **project_id** | **String** | Must belong to the organization in the path. |  |
+| **cluster_id** | **String** | Must be a cluster of the project in the path. |  |
+
+### Return type
+
+[**QueryClusterResource**](QueryClusterResource.md)
+
+### Authorization
+
+[ApiKey](../README.md#ApiKey)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## rename_query_cluster
 
 > <QueryClusterResource> rename_query_cluster(organization_id, project_id, cluster_id, idempotency_key, create_query_cluster_request)

data/docs/CompetitorCoOccurrenceResponse.md

@@ -0,0 +1,18 @@
+# Mencoro::CompetitorCoOccurrenceResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **competitors** | [**Array<CompetitorCoOccurrenceRow>**](CompetitorCoOccurrenceRow.md) |  |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CompetitorCoOccurrenceResponse.new(
+  competitors: null
+)
+```
+

data/docs/CompetitorCoOccurrenceRow.md

@@ -0,0 +1,36 @@
+# Mencoro::CompetitorCoOccurrenceRow
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **competitor_id** | **String** |  |  |
+| **shared_response_count** | **Integer** |  |  |
+| **brand_wins** | **Integer** |  |  |
+| **competitor_wins** | **Integer** |  |  |
+| **ties** | **Integer** |  |  |
+| **win_rate** | **Integer** |  | [optional] |
+| **avg_own_position** | **Float** |  | [optional] |
+| **avg_competitor_position** | **Float** |  | [optional] |
+| **example_query_text** | **String** |  | [optional] |
+| **example_ai_response_id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CompetitorCoOccurrenceRow.new(
+  competitor_id: null,
+  shared_response_count: null,
+  brand_wins: null,
+  competitor_wins: null,
+  ties: null,
+  win_rate: null,
+  avg_own_position: null,
+  avg_competitor_position: null,
+  example_query_text: null,
+  example_ai_response_id: null
+)
+```
+

data/docs/CompetitorShareOfVoice.md

@@ -0,0 +1,20 @@
+# Mencoro::CompetitorShareOfVoice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **competitor_id** | **String** |  |  |
+| **share_of_voice** | **Float** |  | [optional] |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CompetitorShareOfVoice.new(
+  competitor_id: null,
+  share_of_voice: null
+)
+```
+

data/docs/CreateInvitation201Response.md

@@ -11,6 +11,8 @@
 | **created_at** | **Time** |  |  |
 | **expires_at** | **Time** |  |  |
 | **accepted_at** | **Time** |  | [optional] |
+| **project_access_mode** | **String** | Which projects of the organization the invitee reaches on accepting: every project, or only projectIds |  |
+| **project_ids** | **Array<String>** | The projects a selected access reaches, limited to those still in the organization; empty when the mode is all. It may be empty on selected once its projects left the organization, which grants nothing |  |
 | **created** | **Boolean** | Always true on a 201. | [optional] |
 
 ## Example
@@ -26,6 +28,8 @@ instance = Mencoro::CreateInvitation201Response.new(
   created_at: null,
   expires_at: null,
   accepted_at: null,
+  project_access_mode: null,
+  project_ids: null,
   created: null
 )
 ```

data/docs/CreateInvitationRequest.md

@@ -6,6 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **email** | **String** |  | [optional] |
 | **role** | **String** |  | [optional][default to 'viewer'] |
+| **project_access** | [**CreateInvitationRequestProjectAccess**](CreateInvitationRequestProjectAccess.md) |  | [optional] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'mencoro'
 
 instance = Mencoro::CreateInvitationRequest.new(
   email: null,
-  role: null
+  role: null,
+  project_access: null
 )
 ```
 

data/docs/CreateInvitationRequestProjectAccess.md

@@ -0,0 +1,20 @@
+# Mencoro::CreateInvitationRequestProjectAccess
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **mode** | **String** |  |  |
+| **project_ids** | **Array<String>** | For selected: at least one and at most 500 projects of the organization. | [optional] |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::CreateInvitationRequestProjectAccess.new(
+  mode: null,
+  project_ids: null
+)
+```
+

data/docs/DiscoveryApi.md

@@ -93,7 +93,7 @@ end
 
 Start a brand-name alias suggestion job
 
-Minimum role: manager. Starts a background, web-search-grounded job that suggests alias spellings for one entity - a brand, a project or a competitor - described entirely by the body, and answers 202 with the job to poll; it never returns suggestions inline. The entity need not exist: nothing is looked up, nothing is attached and nothing is saved, so the suggestions are the caller's to apply. Names sent in `enteredBrandNames` are excluded from the result. The organization must be active; no subscription is required, matching the application behaviour this mirrors. Ten starts per minute per organization, counted across every key of every member; a retry carrying an Idempotency-Key already answered is served from the record and does not count.
+Minimum role: manager, with access to every project of the organization: the job names no project, so a member restricted to selected projects is refused as a role below the minimum is. Starts a background, web-search-grounded job that suggests alias spellings for one entity - a brand, a project or a competitor - described entirely by the body, and answers 202 with the job to poll; it never returns suggestions inline. The entity need not exist: nothing is looked up, nothing is attached and nothing is saved, so the suggestions are the caller's to apply. Names sent in `enteredBrandNames` are excluded from the result. The organization must be active; no subscription is required, matching the application behaviour this mirrors. Ten starts per minute per organization, counted across every key of every member; a retry carrying an Idempotency-Key already answered is served from the record and does not count.
 
 ### Examples
 

data/docs/GetMeStats200ResponseProjects.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **total** | **Integer** | Projects across those organizations, archived ones included. | [optional] |
+| **total** | **Integer** | Projects across those organizations the owner can access, archived ones included. | [optional] |
 | **active** | **Integer** | How many of those are active; the remainder are archived. | [optional] |
 
 ## Example

data/docs/GetOrganizationOverview200ResponseAggregate.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_count** | **Integer** | Active projects in the organization, the length of `projects`. | [optional] |
+| **project_count** | **Integer** | Active projects of the organization the caller can access, the length of `projects`. | [optional] |
 | **projects_with_data** | **Integer** | How many of those have a share of voice; the averages below are means over the projects that report each metric, never over the ones still null. | [optional] |
 | **total_tracked_queries** | **Integer** |  | [optional] |
 | **avg_share_of_voice** | **Float** | Null when no project reports a share of voice. | [optional] |

data/docs/GetOrganizationOverview200ResponseProjectsInner.md

@@ -7,9 +7,12 @@
 | **project_id** | **String** |  | [optional] |
 | **name** | **String** |  | [optional] |
 | **status** | **String** |  | [optional] |
-| **tracked_query_count** | **Integer** |  | [optional] |
+| **tracked_query_count** | **Integer** | Configured tracked queries of the project, paused ones included. | [optional] |
+| **ai_tracked_query_count** | **Integer** | How many of trackedQueryCount run on an AI answer engine (ChatGPT, Claude, Perplexity, Google AI Overview, Google AI Mode). | [optional] |
+| **serp_tracked_query_count** | **Integer** | How many of trackedQueryCount run on classic Google SERP. | [optional] |
+| **shopping_tracked_query_count** | **Integer** | How many of trackedQueryCount run on Google Shopping. | [optional] |
 | **share_of_voice** | **Float** | 0-100 percentage share of weighted AI mentions against all tracked brands; higher is better. Null when the project has no rank data yet. | [optional] |
-| **mention_rate** | **Integer** | 0-100 percentage of tracked queries with a result; higher is better. Null when the project has no rank data yet. | [optional] |
+| **mention_rate** | **Integer** | 0-100 percentage of AI checks (one per tracked query x engine x UTC day) across all retained data that mentioned the brand, each check counted as the share of its passes that did; higher is better. Null when the project has no rank data yet. | [optional] |
 | **avg_mention_position** | **Float** | 1-based average rank of the brand within the answer; LOWER is better. Null when the project has no rank data yet. | [optional] |
 | **positivity_index** | **Integer** | 0-100 sentiment score; higher is better. Null when the project has no rank data yet. | [optional] |
 
@@ -23,6 +26,9 @@ instance = Mencoro::GetOrganizationOverview200ResponseProjectsInner.new(
   name: null,
   status: null,
   tracked_query_count: null,
+  ai_tracked_query_count: null,
+  serp_tracked_query_count: null,
+  shopping_tracked_query_count: null,
   share_of_voice: null,
   mention_rate: null,
   avg_mention_position: null,

data/docs/GetOrganizationStats200ResponseInvitations.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **pending** | **Integer** | Invitations still awaiting an answer. Accepted, cancelled and expired ones are excluded. | [optional] |
+| **pending** | **Integer** | Invitations still awaiting an answer. Accepted, cancelled and expired ones are excluded. Null for a member restricted to selected projects. | [optional] |
 
 ## Example
 

data/docs/GetOrganizationStats200ResponseMembers.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **total** | **Integer** | Active memberships. Suspended members are excluded. | [optional] |
+| **total** | **Integer** | Active memberships. Suspended members are excluded. Null for a member restricted to selected projects. | [optional] |
 
 ## Example
 

data/docs/GetOrganizationStats200ResponseProjects.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **total** | **Integer** | Every project in the organization, archived ones included. | [optional] |
+| **total** | **Integer** | Every project of the organization the caller can access, archived ones included. | [optional] |
 | **active** | **Integer** | Projects that are not archived; never greater than `total`. | [optional] |
 
 ## Example

data/docs/InvitationResource.md

@@ -11,6 +11,8 @@
 | **created_at** | **Time** |  |  |
 | **expires_at** | **Time** |  |  |
 | **accepted_at** | **Time** |  | [optional] |
+| **project_access_mode** | **String** | Which projects of the organization the invitee reaches on accepting: every project, or only projectIds |  |
+| **project_ids** | **Array<String>** | The projects a selected access reaches, limited to those still in the organization; empty when the mode is all. It may be empty on selected once its projects left the organization, which grants nothing |  |
 
 ## Example
 
@@ -24,7 +26,9 @@ instance = Mencoro::InvitationResource.new(
   state: null,
   created_at: null,
   expires_at: null,
-  accepted_at: null
+  accepted_at: null,
+  project_access_mode: null,
+  project_ids: null
 )
 ```
 

data/docs/JobsApi.md

@@ -13,7 +13,7 @@ All URIs are relative to *https://api.mencoro.com*
 
 Get an asynchronous job
 
-Minimum role: manager. The status of one asynchronous job started inside this organization — geo prompt discovery, keyword discovery, query clustering, brand discovery or brand-name suggestion — and, once it has completed, its result. Poll it until `status` is terminal: `completed` or `failed`. A null `result` means the result is not known, either because the job is still in flight or because it failed; it never means the job produced an empty result. A failed job carries no reason: the stored one is an internal exception message, not a published field. A job started by another organization, a job of a type this API does not publish, and a job id that does not exist all answer 404 alike, so the API never confirms that an inaccessible job exists.
+Minimum role: manager. The status of one asynchronous job started inside this organization — geo prompt discovery, keyword discovery, query clustering, brand discovery or brand-name suggestion — and, once it has completed, its result. Poll it until `status` is terminal: `completed` or `failed`. A null `result` means the result is not known, either because the job is still in flight or because it failed; it never means the job produced an empty result. A failed job carries `error`: a stable `code` (`timed_out`, `provider_failed`, `submission_failed` or `internal_error`) and a fixed `message` saying what to do next; `error` is null for a job that has not failed. A job started by another organization, a job of a type this API does not publish, and a job id that does not exist all answer 404 alike, so the API never confirms that an inaccessible job exists.
 
 ### Examples
 

data/docs/KeywordListingResource.md

@@ -15,16 +15,16 @@
 | **status_summary** | **String** | \"mixed\" when the variants disagree; otherwise the one status they share. |  |
 | **statuses** | **Array<String>** | Distinct statuses across the variants. |  |
 | **check_frequencies** | **Array<String>** | Distinct check frequencies across the variants. |  |
-| **n_passes_values** | **Array<Integer>** | Distinct pass counts across the variants. A pass is one budget unit per check. |  |
+| **n_passes_values** | **Array<Integer>** | Distinct pass counts across the variants. Each Claude pass consumes five checks; each other engine pass consumes one. |  |
 | **last_checked_at** | **Time** | The most recent completed check across the variants. Null when none has ever completed — not a check that found nothing. | [optional] |
-| **avg_serp_position** | **Float** | Average position in traditional search over the window. 1-based, LOWER is better. | [optional] |
-| **trend_serp** | **Float** | Signed improvement in avgSerpPosition against the previous window. Positive is better. | [optional] |
-| **avg_shopping_position** | **Float** | Average position in shopping results over the window. 1-based, LOWER is better. | [optional] |
-| **trend_shopping** | **Float** | Signed improvement in avgShoppingPosition. Positive is better. | [optional] |
-| **avg_mention_position** | **Float** | Average position of the brand mention inside the AI answer. 1-based, LOWER is better. | [optional] |
-| **trend_mention** | **Float** | Signed improvement in avgMentionPosition. Positive is better. | [optional] |
-| **avg_link_position** | **Float** | Average position of a cited link to the brand. 1-based, LOWER is better. | [optional] |
-| **trend_link** | **Float** | Signed improvement in avgLinkPosition. Positive is better. | [optional] |
+| **avg_serp_position** | **Float** | Average position in traditional search over the window. 1-based, LOWER is better. A variant not checked in the window contributes its latest earlier measurement instead; see carriedPositions. | [optional] |
+| **trend_serp** | **Float** | Signed improvement in avgSerpPosition against the previous window. Positive is better. Null when carriedPositions.serp is set. | [optional] |
+| **avg_shopping_position** | **Float** | Average position in shopping results over the window. 1-based, LOWER is better. A variant not checked in the window contributes its latest earlier measurement instead; see carriedPositions. | [optional] |
+| **trend_shopping** | **Float** | Signed improvement in avgShoppingPosition. Positive is better. Null when carriedPositions.shopping is set. | [optional] |
+| **avg_mention_position** | **Float** | Average position of the brand mention inside the AI answer. 1-based, LOWER is better. A variant not checked in the window contributes its latest earlier measurement instead; see carriedPositions. | [optional] |
+| **trend_mention** | **Float** | Signed improvement in avgMentionPosition. Positive is better. Null when carriedPositions.mention is set. | [optional] |
+| **avg_link_position** | **Float** | Average position of a cited link to the brand. 1-based, LOWER is better. A variant not checked in the window contributes its latest earlier measurement instead; see carriedPositions. | [optional] |
+| **trend_link** | **Float** | Signed improvement in avgLinkPosition. Positive is better. Null when carriedPositions.link is set. | [optional] |
 | **mention_position_stability** | **Float** | Day-to-day spread of the mention position (a standard deviation): LOWER means steadier. | [optional] |
 | **trend_stability** | **Float** | Signed improvement in mentionPositionStability. Positive means steadier than the previous window. | [optional] |
 | **positivity_index** | **Integer** | 0-100 weighted sentiment score of the mentions; HIGHER is better. Null when there were no mentions to score. | [optional] |
@@ -40,6 +40,7 @@
 | **sentiment_negative** | **Integer** | Negative brand mentions counted in the window. |  |
 | **avg_mention_count** | **Float** | Mentions per AI engine per day with a capture, over the window. Not a total: the window total is not part of this contract. | [optional] |
 | **mention_type_counts** | [**KeywordListingResourceMentionTypeCounts**](KeywordListingResourceMentionTypeCounts.md) |  |  |
+| **carried_positions** | [**KeywordListingResourceCarriedPositions**](KeywordListingResourceCarriedPositions.md) |  |  |
 
 ## Example
 
@@ -82,7 +83,8 @@ instance = Mencoro::KeywordListingResource.new(
   sentiment_neutral: null,
   sentiment_negative: null,
   avg_mention_count: null,
-  mention_type_counts: null
+  mention_type_counts: null,
+  carried_positions: null
 )
 ```
 

data/docs/KeywordListingResourceCarriedPositions.md

@@ -0,0 +1,24 @@
+# Mencoro::KeywordListingResourceCarriedPositions
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **serp** | [**KeywordListingResourceCarriedPositionsSerp**](KeywordListingResourceCarriedPositionsSerp.md) |  |  |
+| **shopping** | [**KeywordListingResourceCarriedPositionsSerp**](KeywordListingResourceCarriedPositionsSerp.md) |  |  |
+| **mention** | [**KeywordListingResourceCarriedPositionsSerp**](KeywordListingResourceCarriedPositionsSerp.md) |  |  |
+| **link** | [**KeywordListingResourceCarriedPositionsSerp**](KeywordListingResourceCarriedPositionsSerp.md) |  |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::KeywordListingResourceCarriedPositions.new(
+  serp: null,
+  shopping: null,
+  mention: null,
+  link: null
+)
+```
+

data/docs/KeywordListingResourceCarriedPositionsSerp.md

@@ -0,0 +1,20 @@
+# Mencoro::KeywordListingResourceCarriedPositionsSerp
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **measured_at** | **Date** | Date (YYYY-MM-DD) of the oldest carried measurement. |  |
+| **all_carried** | **Boolean** | True when every variant behind the figure carried, so it holds no measurement from the window. |  |
+
+## Example
+
+```ruby
+require 'mencoro'
+
+instance = Mencoro::KeywordListingResourceCarriedPositionsSerp.new(
+  measured_at: null,
+  all_carried: null
+)
+```
+

data/docs/ListProjects200Response.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **items** | [**Array<ProjectResource>**](ProjectResource.md) |  | [optional] |
-| **total** | **Integer** | Every project matching the filters, not the size of this page. | [optional] |
+| **total** | **Integer** | Every project matching the filters that the caller can access, not the size of this page. | [optional] |
 
 ## Example
 

data/docs/MemberResource.md

@@ -10,6 +10,8 @@
 | **state** | **String** |  |  |
 | **is_active** | **Boolean** |  |  |
 | **joined_at** | **Time** |  |  |
+| **project_access_mode** | **String** | Which projects of the organization the member reaches: every project, or only projectIds |  |
+| **project_ids** | **Array<String>** | The projects a selected access reaches; empty when the mode is all |  |
 
 ## Example
 
@@ -22,7 +24,9 @@ instance = Mencoro::MemberResource.new(
   role: null,
   state: null,
   is_active: null,
-  joined_at: null
+  joined_at: null,
+  project_access_mode: null,
+  project_ids: null
 )
 ```