Tasks

POST /tasks

Create a new task

Request

  • Base URL
    https://api.fergus.com
  • Auth
    • OAuth 2
      Authorization codehttps://auth.fergus.com/oauth2/authorize
      Token URLhttps://auth.fergus.com/oauth2/token
    • or HTTP bearer
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Request body

descriptionstring required

The task description

dueDatestring date nullable

The due date in yyyy-mm-dd format

jobIdnumber nullable

Link this task to a job. Cannot be changed after creation.

assignedEmployeeIdsnumber[]

Employee IDs to assign to this task

Example request

{
  "dueDate": "2025-06-30",
  "jobId": 123,
  "assignedEmployeeIds": [
    20,
    23
  ]
}

Response

Resource created successfully

resultstring required

Changes

No recorded changes to this operation across all 18 revisions of this API.