> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindshare.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Query Group Status

> Updates the status of an existing query group.

A query group represents a set of related queries for a specific product line or campaign. Customers can have multiple query groups. The caller must own the query group through their organization — the system validates that the query group belongs to a customer within the caller's organization.

**Note:** Changing status to **Active** consumes one credit from the organization's quota. Changing status to **Pause** or **Not Active** frees one credit back to the quota.



## OpenAPI

````yaml POST /update-query-group-status
openapi: 3.1.0
info:
  title: Mindshare API
  description: >-
    The Mindshare API provides comprehensive access to brand visibility
    analytics, customer intelligence, and growth tracking. Use this API to
    retrieve customer data, query groups, execution results, domain insights,
    and actionable recommendations for improving your brand's AI visibility.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.mindshare.so/customer/v1
security:
  - apiKeyHeader: []
paths:
  /update-query-group-status:
    post:
      description: >-
        Updates the status of an existing query group.


        A query group represents a set of related queries for a specific product
        line or campaign. Customers can have multiple query groups. The caller
        must own the query group through their organization — the system
        validates that the query group belongs to a customer within the caller's
        organization.


        **Note:** Changing status to **Active** consumes one credit from the
        organization's quota. Changing status to **Pause** or **Not Active**
        frees one credit back to the quota.
      requestBody:
        description: Query Group status update details
        content:
          application/json:
            schema:
              type: object
              properties:
                queryGroupId:
                  type: number
                  description: The ID of the query group to update.
                status:
                  type: string
                  enum:
                    - Active
                    - Not Active
                    - Pause
                  description: The new status for the query group.
              required:
                - queryGroupId
                - status
        required: true
      responses:
        '200':
          description: Query group status updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
components:
  schemas:
    MessageResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            message:
              type: string
              description: Success message
          required:
            - message
          description: Response details
        version:
          type: string
          description: API version
        env:
          type: string
          description: Environment name
      required:
        - data
        - version
        - env
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````