Sign in
Organizations

Get Organization

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

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
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
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

Changed in 3 of the 31 revisions of this API.4

  • 5d4c905106b41See the full diff
    • ○

      the endpoint scheme security BearerAuth was added to the API

      api-security-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 220a3b263fda1See the full diff
    • ○

      added the optional property is_internal to the response with the 200 status

      response-optional-property-added

  • 7cb0515333112See the full diff
    • ○

      added the optional property effective_monthly_credit_cap to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property onboarding_answers to the response with the 200 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog