---
title: "Update a scheduling task"
method: PATCH
path: "/v1/tasks/{taskId}"
tags: ["Scheduling Task"]
---

# Update a scheduling task

`PATCH /v1/tasks/{taskId}`

Updates the supplied assignee, urgency, queue, tags, debrief requirement, or meeting location for a scheduling task. Omitted fields are preserved; null clears the assignee, queue, or meeting location, while supplying tags replaces the task's tag list. An empty PATCH body is rejected.

## Path parameters

- `taskId` string, required — a task ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.

## Request body

- SchedulingTaskPatch
  - `assignee_id` string, nullable — an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
  - `is_urgent` boolean — Replaces the urgency flag when supplied; omit to preserve it.
  - `queue_id` string, nullable — a task queue ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
  - `tags` string[] — Tags must already exist in the organization; unknown tags are rejected.
  - `is_debrief_required` boolean — Replaces whether a debrief is required when supplied; omit to preserve it.
  - `meeting_location` union — Replaces the meeting location. Omit to preserve; null clears it.
    - object
      - `type` 'NONE', required
    - object
      - `type` 'CANDIDATE_PHONE', required
    - object
      - `type` 'ZOOM', required
      - `host` union, required
        - object
          - `host_type` 'DYNAMIC_INTERVIEWERS', required
        - object
          - `host_type` 'DYNAMIC_SCHEDULER', required
        - object
          - `host_type` 'EMPLOYEE', required
          - `host_employee_id` string, required — an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
        - object
          - `host_type` 'REMOTE_USER', required
          - `remote_video_meeting_host_user_id` string, required
    - object
      - `type` 'GOOGLE_MEET', required
      - `host` union, required
        - object
          - `host_type` 'DYNAMIC_INTERVIEWERS', required
        - object
          - `host_type` 'DYNAMIC_SCHEDULER', required
        - object
          - `host_type` 'EMPLOYEE', required
          - `host_employee_id` string, required — an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
    - object
      - `type` 'MICROSOFT_TEAMS', required
      - `host` union, required
        - object
          - `host_type` 'DYNAMIC_INTERVIEWERS', required
        - object
          - `host_type` 'DYNAMIC_SCHEDULER', required
        - object
          - `host_type` 'EMPLOYEE', required
          - `host_employee_id` string, required — an employee ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.
    - object
      - `type` 'CUSTOM_LINK', required
      - `value` string, required
    - object
      - `type` 'CUSTOM_PHONE', required
      - `value` string, required
    - object
      - `type` 'CUSTOM_TEXT', required
      - `value` string, required

## Response `200`

Success

- SchedulingTask
  - `id` string, required — Canonical task ID (tsk_ followed by 32 lowercase hexadecimal UUID characters).
  - `application` object, required
    - `id` string, required — Canonical application ID (app_ followed by 32 lowercase hexadecimal UUID characters).
    - `candidate` object, required
      - `id` string, required — Canonical candidate ID (can_ followed by 32 lowercase hexadecimal UUID characters).
      - `name` string, required
    - `job` object, required
      - `id` string, required — Canonical job ID (job_ followed by 32 lowercase hexadecimal UUID characters).
      - `name` string, required
  - `job_stage` object, required
    - `id` string, required — Canonical job stage ID (stg_ followed by 32 lowercase hexadecimal UUID characters).
    - `name` string, required
  - `status` 'NEEDS_AVAILABILITY' | 'WAITING_FOR_CANDIDATE' | 'READY_TO_SCHEDULE' | 'READY_TO_RESCHEDULE' | 'HOLD' | 'READY_TO_SEND_TO_CANDIDATE' | 'SCHEDULED' | 'COMPLETED' | 'CANCELED' | 'NEEDS_DEBRIEF', required
  - `is_urgent` boolean, required
  - `assignee` object, nullable, required
    - `id` string, required — Canonical employee ID (emp_ followed by 32 lowercase hexadecimal UUID characters).
    - `name` string, required
  - `queue_id` string, nullable, required — Canonical task queue ID (que_ followed by 32 lowercase hexadecimal UUID characters).
  - `tags` string[], required
  - `flags` object[], required
    - `code` string, required
    - `message` string, required
    - `raised_at` string, date-time, required — ISO 8601 timestamp.
  - `is_debrief_required` boolean, required
  - `delegation` object, required
    - `type` 'NONE' | 'AGENT', required
    - `status` 'NONE' | 'QUEUED' | 'ACTIVE' | 'WAITING_ON_CANDIDATE' | 'WAITING_ON_TEAM' | 'COMPLETED' | 'STOPPED', required
  - `notes` object[], required
    - `id` string, required
    - `author` object, required
      - `id` string, required — Canonical employee ID (emp_ followed by 32 lowercase hexadecimal UUID characters).
      - `name` string, required
    - `body` string, required
    - `created_at` string, date-time, required — ISO 8601 timestamp.
  - `created_at` string, date-time, required — ISO 8601 timestamp.
  - `updated_at` string, date-time, required — ISO 8601 timestamp.
  - `app_url` string, uri, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `410` — Gone
- `500` — Internal error

---

[API](https://skmtc.dev/modernloop/apis/modernloop-platform-api.md) · [All operations](https://skmtc.dev/modernloop/apis/modernloop-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modernloop/modernloop-platform-api/revisions/33a0f9f44e4c/schema)