Field NationDeveloper Platform
Field NationDeveloper Platform
IntroductionQuick StartAPI Playground

Getting Started

API Reference

People

UsersProvidersTalent PoolsTalent Pool GroupsService Territories

Organization

ClientsProjectsLocations

Configuration

TemplatesTypes of WorkCompany
Resources

Talent Pool Groups

Manage groups containing multiple talent pools.


Talent Pool Groups

A Talent Pool Group is a collection of talent pools, typically associated with a project. This allows you to route work orders to a broader set of providers with a single ID.

List Talent Pool Groups

GET /talent-pool-groups

Query Parameters:

  • f_ids - Filter by group IDs
  • f_name - Filter by name
  • f_project_id - Filter by project
  • limit - Results per page
  • sort_by - Sort field
  • sort_direction - asc or desc

Response

{
  "data": [
    {
      "uuid": "abc-123-def",
      "name": "Q4 Rollout Team",
      "project_id": 501,
      "talent_pools": [
        { "id": 1, "name": "Tier 1 - Premium" },
        { "id": 2, "name": "Tier 2 - Standard" }
      ]
    }
  ],
  "pagination": {
    "has_next_page": false
  }
}

Create Talent Pool Group

POST /talent-pool-groups

{
  "name": "New Rollout Team",
  "project_id": 502,
  "talent_pools": [
    { "name": "Priority Techs" },
    { "name": "Backup Techs" }
  ]
}

Get Talent Pool Group Details

GET /talent-pool-groups/{group_uuid}

Returns detailed information about a specific group including all talent pools and settings.

Update Talent Pool Group

PUT /talent-pool-groups/{group_uuid}

{
  "name": "Updated Team Name",
  "talent_pools": [
    { "id": 1, "name": "Renamed Tier 1" },
    { "name": "New Tier 3" }
  ]
}

Delete Talent Pool Group

DELETE /talent-pool-groups/{group_uuid}

Deleting a talent pool group removes all associated talent pools and provider memberships. This action cannot be undone.


Managing Providers in Groups

List Providers in a Group

GET /talent-pool-groups/{group_uuid}/providers

Response:

{
  "data": [
    {
      "provider_id": 25,
      "name": "John Smith",
      "tier": {
        "id": 1,
        "name": "Tier 1"
      },
      "exists_in_multiple_talent_pool_groups": false
    }
  ]
}

Remove Provider from Group

DELETE /talent-pool-groups/{group_uuid}/providers/{provider_id}

Query Parameters:

  • tierId - Remove from specific tier/pool
  • removeFromProject - Remove from all groups in the project
DELETE /talent-pool-groups/{uuid}/providers/25?tierId=1
DELETE /talent-pool-groups/{uuid}/providers/25?removeFromProject=true

Related Resources

  • Talent Pools - Individual pools and provider attributes
  • Providers - Provider profiles
  • Projects - Project configuration

Last updated on

Talent Pools

Individual talent pools containing providers with custom attributes.

Service Territories

Manage geographic zones and provider coverage.

On this page

Talent Pool Groups
List Talent Pool Groups
Response
Create Talent Pool Group
Get Talent Pool Group Details
Update Talent Pool Group
Delete Talent Pool Group
Managing Providers in Groups
List Providers in a Group
Remove Provider from Group
Related Resources