Skip to main content

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

Updates an existing placement for this trainee.

Request

PUT /api/v1.0-pre/trainees/{trainee_id}/placements/{placement_id}

or

PATCH /api/v1.0-pre/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"
        }
      ]
    }