Organizations

Get Organization

Changed on

Get current organization details.

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

get/v1/organizations

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/organizations
  • Auth: HTTP bearer

Response

Successful Response

organization_idstring required
organization_namestring required
logo_urlstring nullable
account_type'build' | 'scale' | 'enterprise' | 'free' | 'pro' | 'team' required

Account tier (2026-07 pricing overhaul).

Current tiers (CC-required, tier minimum is a billing floor): BUILD: $25/mo min — 100K objects/mo (managed) / 1M vectors (MVS) SCALE: $250/mo min — 1M objects/mo (managed) / 25M vectors (MVS) ENTERPRISE: Custom — dedicated compute, SLA

LEGACY tiers — still stored on unmigrated orgs; resolvable until the Phase-4 migration completes (do NOT remove before then — org records in Mongo carry these strings): FREE (→ Build or read-only), PRO (→ Build), TEAM (→ Scale)

credit_countinteger required
effective_monthly_credit_capinteger nullable
onboarding_answersobject nullable
metadataobject
billing_emailstring email nullable
notifications_emailstring email nullable
notifications_email_delivery_statusobject nullable

Delivery health of notifications_email. Set when the email vendor reports the address undeliverable; cleared when the address is re-saved. None = no known problem.

auto_billing_enabledboolean
billing_cycle_startinteger
current_month_usageinteger
created_atstring date-time required
updated_atstring date-time required
usersobject[] nullable
auth_provider_org_idstring nullable
default_llm_credentialsobject
api_urlstring nullable
spend_limitsobject nullable

The organization's effective spend budget: daily_usd, monthly_usd, the namespace defaults, the plan's safety ceilings, spend to date, headroom, where each number comes from, and the change history.

requires_planboolean

True when this workspace must pick a plan before it can create namespaces or run billable work. When gated, write endpoints return 403 PlanRequiredError linking to https://studio.mixpeek.com/signup/plan where the workspace picks one.

is_internalboolean

True when this org is Mixpeek-internal (team/dogfood/ops), derived server-side at read time. Analytics consumers should exclude internal orgs from customer metrics.

Example response

{
  "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"
}

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 0fff3e39f57fRevision changes
    • info

      added the optional property to the response with the status