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

Projects

Manage projects for work order templates and configuration.


Projects

Projects represent specific initiatives (e.g., "Q4 POS Rollout", "Network Refresh 2024"). They can enforce default templates, pay rates, and selection rules for all work orders assigned to them.

List Projects

GET /projects

Response

{
  "results": [
    {
      "id": 501,
      "name": "Q4 POS Rollout",
      "client_id": 102,
      "active": true,
      "work_orders_count": 45,
      "template_id": 88
    }
  ]
}

Create Project

POST /projects

{
  "name": "Network Refresh 2024",
  "client_id": 102,
  "template_id": 88,
  "description": "Nationwide router replacement initiative"
}

Project Configuration

Projects can enforce:

SettingDescription
template_idDefault work order template
pay_rateStandard pay for the project
talent_pool_group_idPreferred provider group
selection_rulesAuto-assignment criteria

Using Projects in Work Orders

Assign a work order to a project to inherit its settings:

{
  "title": "Site #44 - Router Install",
  "project": { "id": 501 },
  "client": { "id": 102 }
}

Best Practice: Create projects in the Field Nation UI where you can configure complex settings, then reference the project_id in your API integration.

Adding Providers to Project

You can add multiple providers to a project's talent pool:

POST /projects/{project_id}/providers

{
  "provider_ids": [123, 456, 789]
}

Related Resources

  • Clients - Customer organization
  • Talent Pool Groups - Provider groups for projects
  • Templates - Work order templates

Last updated on

Clients

Manage client companies for work order organization and reporting.

Locations

Manage your saved locations for easier work order creation.

On this page

Projects
List Projects
Response
Create Project
Project Configuration
Using Projects in Work Orders
Adding Providers to Project
Related Resources