---
title: "Update status of assignment"
method: PATCH
path: "/v3/gfw/assignments/{assignmentId}/status"
tags: ["Assignments"]
---

# Update status of assignment

`PATCH /v3/gfw/assignments/{assignmentId}/status`

Allow the user to update the status of the asssignment even if they are monitors but not creators of the assignment. Monitors can perform on hold to open and open to on hold status change. Creators can perform all status changes.

## Request body

- object
  - `status` 'open' | 'completed' | 'on hold', required

## Response `200`

Single assignment

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` AssignmentModel
      - `name` string, required
      - `location` object[]
        - `lat` integer
        - `lon` integer
        - `alertType` string
        - `alertId` string
      - `priority` number, required
      - `monitors` string[], required
      - `notes` string, required
      - `status` 'open' | 'on hold' | 'completed', required
      - `areaId` string, required
      - `templateIds` string[], required
      - `createdAt` number
      - `createdBy` string
      - `areaName` string
      - `geostore` GeostoreModel
        - `id` string
        - `geojson` string
        - `hash` string
        - `provider` string
        - `areaHa` integer
        - `bbox` integer[]
        - `lock` boolean
        - `info` string
      - `templates` TemplateModel[]
        - `name` string
        - `user` string
        - `languages` string[]
        - `defaultLanguage` string
        - `public` boolean
        - `status` string
        - `createdAt` string
        - `questions` QuestionModel[]
          - `type` string, required
          - `label` object, required
            - `en` string
          - `name` string, required
          - `defaultValue` string
          - `values` string, required
          - `required` boolean, required
          - `order` number
          - `childQuestions` ChildQuestionModel
            - `type` string, required
            - `label` object, required
              - …
            - `name` string, required
            - `defaultValue` string
            - `values` string, required
            - `required` boolean, required
            - `order` number
            - `conditionalValue` number
            - `maxImageCount` number
          - `maxImageCount` number
        - `answersCount` integer
        - `isLatest` boolean
        - `editGroupId` string
        - `areas` object[]
          - `id` string
          - `name` string
      - `monitorNames` object[]
        - `id` string
        - `name` string
      - `image` string

---

[API](https://skmtc.dev/wri/apis/fw-core.md) · [All operations](https://skmtc.dev/wri/apis/fw-core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wri/fw-core/revisions/400d22a78fbd/schema)