Back to API overview
Organizations
LiveTenant 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/mereadLiveGet 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/organizationsadminRoadmapList 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/organizationsadminRoadmapCreate 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}adminRoadmapUpdate 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}/grantsadminRoadmapGrant 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"
}