Contact UsContact About UsAbout Leadership

Organizations

Live

Tenant entities. One organization per franchise location. Organizations may have a parent_organization_id; parent-org reads require an explicit grant from each child (Q3 2026 endpoint).

GET/api/v1/organizations/mereadLive

Get the calling organization

Returns the organization tied to the API key making the request.

Example response

{
  "id": "8c2f0a14-0c8a-4a3a-9a4d-3e0f1d6c2a91",
  "name": "PuroClean of North Metro Atlanta",
  "industry": "restoration",
  "parent_organization_id": null,
  "settings": {
    "timezone": "America/New_York",
    "default_locale": "en-US"
  },
  "created_at": "2025-09-12T14:23:01.418Z"
}

GET/api/v1/organizationsadminRoadmap

List child organizations (parent-org only)

Returns child organizations for parent-corp roll-up access. Requires admin-scope key on a parent organization.

Example response

{
  "data": [
    {
      "id": "8c2f0a14-0c8a-4a3a-9a4d-3e0f1d6c2a91",
      "name": "PuroClean of North Metro Atlanta",
      "industry": "restoration",
      "grants": ["leads.read", "calls.read", "audit_log.read"]
    }
  ],
  "next_cursor": null
}

POST/api/v1/organizationsadminRoadmap

Create a child organization

Create a new tenant under the calling parent organization. Returns the new organization id and an initial admin invite link.

Example request body

{
  "name": "PuroClean of West Cobb",
  "industry": "restoration",
  "settings": {
    "timezone": "America/New_York"
  },
  "primary_admin_email": "owner@example.com"
}

Example response

{
  "id": "5b2c7a31-4f98-4a7d-9e2b-c1f7e4a18b62",
  "name": "PuroClean of West Cobb",
  "parent_organization_id": "ab12c3d4-e5f6-7890-abcd-ef1234567890",
  "invite_url": "https://www.expertailabs.ai/invite/itok_a1f3...",
  "invite_expires_at": "2026-05-04T17:00:00.000Z",
  "created_at": "2026-04-27T17:00:12.314Z"
}

PATCH/api/v1/organizations/{id}adminRoadmap

Update organization settings

Update name and settings (timezone, locale, integration toggles).

Example request body

{
  "settings": {
    "timezone": "America/New_York",
    "default_locale": "en-US"
  }
}

Example response

{
  "id": "5b2c7a31-4f98-4a7d-9e2b-c1f7e4a18b62",
  "settings": {
    "timezone": "America/New_York",
    "default_locale": "en-US"
  },
  "updated_at": "2026-04-27T17:02:55.901Z"
}

POST/api/v1/organizations/{id}/grantsadminRoadmap

Grant parent-corp read access

A child organization grants read-only access to its parent organization for network roll-up reporting.

Example request body

{
  "parent_organization_id": "ab12c3d4-e5f6-7890-abcd-ef1234567890",
  "scopes": ["leads.read", "calls.read", "audit_log.read"],
  "expires_at": "2027-04-27T00:00:00.000Z"
}

Example response

{
  "grant_id": "f4e9c2a8-7d31-4b6f-9c83-21e5d4a07b14",
  "parent_organization_id": "ab12c3d4-e5f6-7890-abcd-ef1234567890",
  "scopes": ["leads.read", "calls.read", "audit_log.read"],
  "created_at": "2026-04-27T17:09:33.001Z",
  "expires_at": "2027-04-27T00:00:00.000Z"
}

Health & Identity Leads