---
title: "Terminate a work assignment"
method: POST
path: "/work_assignment/{work_assignment}/terminate"
tags: ["Work Assignments"]
---

# Terminate a work assignment

`POST /work_assignment/{work_assignment}/terminate`

## Path parameters

- `work_assignment` string, required

## Request body

- object
  - `effective_date` string, date, required — The date for all recurring items to be ended, e.g. Pay Rates, Earnings, Allowances, Benefits, Reimbursements, Deductions.
  - `archived_at` string, date — The date to archive the work assignment. If not provided, the work assignment will remain active.

## Response `200`

OK

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"work_assignment"`).
  - `data` WorkAssignment
    - `title` string, nullable — An optional label for this work assignment, used to distinguish between multiple work assignments for the same Employee or Contractor.
    - `title_translations` Translations, nullable
      - `en` string
      - `fr` string
    - `title_translated` string — The translation of the `title` property for the request locale. Computed using the values in `title` and `title_translations` and the value of the request's `Accept-Language` header.
    - `employee` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"employee"`).
    - `pay_schedule` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"pay_schedule"`).
    - `business_entity` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"business_entity"`).
    - `current_tax_jurisdiction` string, nullable — The current Province of Employment (POE) for the work assignment, derived from the `ca::province_of_employment` Tax Property on the work assignment or, if none is set, from the Business Entity.
    - `is_primary` boolean — When `true`, the standard tax reductions are applied to this work assignment's Pay Stubs. Only one work assignment per Employee per Business Entity may be primary. If none is explicitly set to primary, the earliest work assignment is treated as primary.
    - `accrued_vacation_pay` number — This attribute is deprecated and will be removed.
    - `paid_vacation_pay` number — This attribute is deprecated and will be removed.
    - `first_non_draft_period_start` string, date, nullable — The start of the first pay period for which this work assignment has a non-draft Payroll. `null` if the work assignment has never appeared on an approved or paid Payroll.
    - `last_non_draft_period_end` string, date, nullable — The end of the most recent pay period for which this work assignment has a non-draft Payroll. `null` if the work assignment has never appeared on an approved or paid Payroll.
    - `available_tax_properties` string[], nullable — A list of Tax Property template identifiers supported for this work assignment, based on its jurisdiction.
    - `external_ref` string, nullable — A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.
    - `archived_at` string, dateTime, nullable — The date the work assignment was archived. Archiving ends the work assignment's participation in future Payrolls. The archive date must not fall before any active Pay Rate's effective period.
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/versions/a0c7a815860f/schema)