PUT|PATCH /trainees/{trainee_id}/placements/{placement_id}

Updates an existing placement for this trainee.

Request

PUT /api/v2025.0/trainees/{trainee_id}/placements/{placement_id}

or

PATCH /api/v2025.0/trainees/{trainee_id}/placements/{placement_id}

Parameters

Parameter	In	Type	Required	Description
trainee_id	path	string	true	The unique ID of the trainee
placement_id	path	string	true	The unique ID of the placement

Request body

Placement details

• data:

  Placement object

Example request body

    {
      "data": {
        "urn": "137523",
        "name": "Wellsway School"
      }
    }

Possible responses

HTTP 200 - A placement

    {
      "data": {
        "urn": "137523",
        "name": "Wellsway School",
        "address": "URN 137523",
        "postcode": null,
        "placement_id": 4fjxTZgHxFgzYrwB8L3UNRvM,
        "created_at": "2024-03-19T22:23:48.619Z",
        "updated_at": "2024-03-19T22:23:48.619Z"
      }
    }

HTTP 401 - Unauthorized

    {
      "error": "Unauthorized"
    }

HTTP 404 - Not found

    {
      "errors": [
        {
          "error": "NotFound",
          "message": "Placement(s) not found"
        }
      ]
    }

HTTP 422 - Unprocessable Entity

    {
      "errors": [
        {
          "error": "UnprocessableEntity",
          "message": "Name can't be blank"
        }
      ]
    }