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

# Get Organization

> Get current organization details.

Security: Infrastructure configuration is NOT exposed via this endpoint.
Infrastructure (Qdrant URLs, Ray clusters) is only accessible via private admin endpoints.



## OpenAPI

````yaml get /v1/organizations
openapi: 3.1.0
info:
  title: Mixpeek API
  description: >-
    This is the Mixpeek API, providing access to various endpoints for data
    processing and retrieval.
  termsOfService: https://mixpeek.com/terms
  contact:
    name: Mixpeek Support
    url: https://mixpeek.com/contact
    email: info@mixpeek.com
  version: '0.82'
servers:
  - url: https://api.mixpeek.com
    description: Production
security: []
paths:
  /v1/organizations:
    get:
      tags:
        - Organizations
      summary: Get Organization
      description: >-
        Get current organization details.


        Security: Infrastructure configuration is NOT exposed via this endpoint.

        Infrastructure (Qdrant URLs, Ray clusters) is only accessible via
        private admin endpoints.
      operationId: get_organization_v1_organizations_get
      parameters: []
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationModelResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    OrganizationModelResponse:
      properties:
        organization_id:
          type: string
          title: Organization Id
        organization_name:
          type: string
          title: Organization Name
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
        account_type:
          $ref: '#/components/schemas/AccountTier'
        credit_count:
          type: integer
          title: Credit Count
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        billing_email:
          anyOf:
            - type: string
              format: email
            - type: 'null'
          title: Billing Email
        notifications_email:
          anyOf:
            - type: string
              format: email
            - type: 'null'
          title: Notifications Email
        rate_limits:
          $ref: '#/components/schemas/BaseRateLimits'
        auto_billing_enabled:
          type: boolean
          title: Auto Billing Enabled
          default: false
        billing_cycle_start:
          type: integer
          title: Billing Cycle Start
          default: 1
        current_month_usage:
          type: integer
          title: Current Month Usage
          default: 0
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        users:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Users
        auth_provider_org_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Auth Provider Org Id
        default_llm_credentials:
          additionalProperties:
            type: string
          type: object
          title: Default Llm Credentials
        api_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Api Url
      type: object
      required:
        - organization_id
        - organization_name
        - account_type
        - credit_count
        - rate_limits
        - created_at
        - updated_at
      title: OrganizationModelResponse
      description: >-
        Response model for organization endpoints.


        SECURITY: Does NOT expose internal_id to prevent leakage of high-entropy
        secrets.

        Only organization_id (public identifier) is included in API responses.
      examples:
        - account_type: pro
          created_at: '2025-01-01T00:00:00Z'
          credit_count: 250000
          logo_url: https://www.google.com/s2/favicons?domain=acme.com&sz=128
          organization_id: org_demo123
          organization_name: Acme Corporation
    ErrorResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Always false for error responses
          default: false
        status:
          type: integer
          title: Status
          description: HTTP status code for this error
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: Error details payload
      type: object
      required:
        - status
        - error
      title: ErrorResponse
      description: Error response model.
      examples:
        - error:
            details:
              id: ns_123
              resource: namespace
            message: Namespace not found
            type: NotFoundError
          status: 404
          success: false
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AccountTier:
      type: string
      enum:
        - free
        - pro
        - team
        - enterprise
      title: AccountTier
      description: |-
        Account tier with monthly credit allocations.

        Tiers:
            FREE: 1,000 credits/month - Limited modalities, shared compute
            PRO: 100,000 credits/month - All modalities, dedicated namespace
            TEAM: 1,000,000 credits/month - Shared buckets, retrieval DAGs
            ENTERPRISE: Custom credits - Dedicated Ray cluster, SLA
    BaseRateLimits:
      properties:
        metadata:
          type: integer
          minimum: 1
          title: Metadata
          description: >-
            REQUIRED. Rate limit for infrastructure and configuration operations
            (namespaces, collections, retrievers, taxonomies, clusters CRUD).
            These are zero-credit operations with highest rate limits since
            they're cheap to execute. Examples: creating collections, updating
            retrievers, listing namespaces.
          default: 10
          examples:
            - 20
            - 100
            - 200
        data:
          type: integer
          minimum: 1
          title: Data
          description: >-
            REQUIRED. Rate limit for data operations (objects, documents CRUD).
            Low-credit operations with high rate limits. Examples: creating
            documents, updating objects, batch document updates.
          default: 10
          examples:
            - 10
            - 60
            - 100
        search:
          type: integer
          minimum: 1
          title: Search
          description: >-
            REQUIRED. Rate limit for search and retrieval operations
            (retriever/taxonomy execution). Medium-credit operations with
            moderate rate limits. Examples: executing retrievers, running
            taxonomy matching.
          default: 10
          examples:
            - 10
            - 60
            - 100
        upload:
          type: integer
          minimum: 1
          title: Upload
          description: >-
            REQUIRED. Rate limit for file upload operations. Credit-intensive (1
            credit/MB) with lower rate limits to prevent excessive resource
            consumption. Examples: uploading files, generating presigned URLs.
          default: 10
          examples:
            - 5
            - 30
            - 50
        compute:
          type: integer
          minimum: 1
          title: Compute
          description: >-
            REQUIRED. Rate limit for compute operations (cluster execution,
            batch processing). High-credit operations (10 credits/min video)
            with lowest rate limits. Examples: submitting batches, executing
            clusters, triggering syncs.
          default: 10
          examples:
            - 5
            - 30
            - 50
      type: object
      title: BaseRateLimits
      description: >-
        Rate limits by operation type (requests per minute).


        The rate limiting system uses 5 categories aligned with actual resource
        consumption:


        Categories:
            metadata: Infrastructure and configuration operations (namespaces, collections,
                     retrievers, taxonomies, clusters CRUD). Zero-credit operations with
                     highest rate limits.

            data: Data operations (objects, documents CRUD). Low-credit operations with
                  high rate limits.

            search: Search and retrieval operations (retriever/taxonomy execution).
                    Medium-credit operations with moderate rate limits.

            upload: File upload operations (credit-intensive: 1 credit/MB). Variable-credit
                    operations with lower rate limits.

            compute: Compute operations (cluster execution, batch processing). High-credit
                     operations (10 credits/min video) with lowest rate limits.

        Rate Limit Strategy:
            Higher limits for low-cost operations (metadata, data)
            Lower limits for high-cost operations (upload, compute)
            This aligns API throttling with actual infrastructure costs

        Examples:
            - Creating a namespace: Uses 'metadata' category (fast, cheap)
            - Uploading a file: Uses 'upload' category (slow, expensive per MB)
            - Executing a retriever: Uses 'search' category (moderate cost)
            - Running batch processing: Uses 'compute' category (very expensive)
    ErrorDetail:
      properties:
        message:
          type: string
          title: Message
          description: Human-readable error message
        type:
          type: string
          title: Type
          description: Stable error type identifier (machine-readable)
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: >-
            Fine-grained error code for programmatic handling (e.g.,
            namespace_name_taken, feature_extractor_not_found). Present only
            when consumers may need to branch on a specific error condition.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: >-
            Optional structured details to help debugging (validation errors,
            IDs, etc.)
      type: object
      required:
        - message
        - type
      title: ErrorDetail
      description: Error detail model.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````