Skip to main content

Place Training Agreement on hold

Place Training Agreement on hold

Path Parameters
trainingAgreementLocalId string REQUIRED
Header Parameters
EID string REQUIRED

Enter the EDUMIS (Organisation) ID

Request Body
pauseDate date REQUIRED

Pause Date

The date on which the Training Agreement is paused.

Type: Date

Guidance: 2024-04-08

You must use ISO-8601 for your dates.

Status Change Date must be before or equal to today. Status Change Date must be after the Training Agreement Signed Date.

Status can be backdated a maximum of three months from the current date. Completions are excluded from this limitation and any backdated events stemming from the receipt of a completion from NZQA can be applied beyond the three-month limit.

onHoldReasonCode string REQUIRED

Possible values: 1 ≤ length ≤ 2

On Hold Reason Code

Identifies why a Training Agreement has moved into either a HOLD or GRACE

Length: 2

Type: Character

Guidance: A reason code must be provided if status code is HOLD. Please select one of the reason codes below.

Reason Code: Description

SW: Seasonal work

PL: Parental leave

OV: Overseas travel

MD: Medical/ACC

CI: Attending correctional institution

OT: Other

ST: Stop training (still with employer)

WE: Work Experience

Responses
200

The operation returned successfully.

Schema OPTIONAL
pauseDate date

Pause Date

The date on which the Training Agreement is paused.

Type: Date

Guidance: 2024-04-08

You must use ISO-8601 for your dates.

Status Change Date must be before or equal to today. Status Change Date must be after the Training Agreement Signed Date.

Status can be backdated a maximum of three months from the current date. Completions are excluded from this limitation and any backdated events stemming from the receipt of a completion from NZQA can be applied beyond the three-month limit.

onHoldReasonCode string

Possible values: 1 ≤ length ≤ 2

On Hold Reason Code

Identifies why a Training Agreement has moved into either a HOLD or GRACE

Length: 2

Type: Character

Guidance: A reason code must be provided if status code is HOLD. Please select one of the reason codes below.

Reason Code: Description

SW: Seasonal work

PL: Parental leave

OV: Overseas travel

MD: Medical/ACC

CI: Attending correctional institution

OT: Other

ST: Stop training (still with employer)

WE: Work Experience

400

Bad request. Check errors and codes for more detail.

Schema OPTIONAL
type string OPTIONAL
title string OPTIONAL
status int32 OPTIONAL
detail string OPTIONAL
instance string OPTIONAL
errors object OPTIONAL
401

Unauthorized

Schema OPTIONAL
type string OPTIONAL
title string OPTIONAL
status int32 OPTIONAL
detail string OPTIONAL
instance string OPTIONAL
errors object OPTIONAL
429

Rate Limiting may apply. Refer to Retry-After header

Schema OPTIONAL
type string OPTIONAL
title string OPTIONAL
status int32 OPTIONAL
detail string OPTIONAL
instance string OPTIONAL