Service Territories

Service Territories allow you to define geographic areas and assign specific providers to cover them. This is useful for building regional networks.

List Service Territories

GET /service-territories

{
  "results": [
    {
      "id": "st-uuid-1234",
      "name": "Midwest Region",
      "description": "MN, WI, IA coverage",
      "provider_count": 45,
      "created": { "utc": "2024-01-01 10:00:00" }
    }
  ]
}

Create Territory

POST /service-territories

{
  "name": "Midwest Region",
  "description": "MN, WI, IA coverage"
}

Get Territory Details

GET /service-territories/{service_territory_uuid}

{
  "id": "st-uuid-1234",
  "name": "Midwest Region",
  "description": "MN, WI, IA coverage",
  "providers": [ ... ]
}

Update Territory

PUT /service-territories/{service_territory_uuid}

Delete Territory

DELETE /service-territories/{service_territory_uuid}

Managing Providers in Territories

List Providers

GET /service-territories/{service_territory_uuid}/providers

Add Provider

Providers are typically added via Projects linking to the territory.

Remove Provider

DELETE /service-territories/{service_territory_uuid}/providers/{provider_id}

Query Parameters:

• tierId (optional): Remove provider from specific talent pool within group.
• removeFromProject (boolean): If true, removes the provider from all service territories in the project.

Usage in Projects

Service territories are most powerful when linked to Projects. This allows you to auto-route work in a specific zip code to the providers assigned to that territory.

Related

• Projects - Linking territories
• Providers - Managing individual providers
• Talent Pools - Alternative grouping method