---
title: "Update Assessment Order"
method: PATCH
path: "/apiHub/performanceManagement/v1/companies/{companyId}/assessmentOrders/{orderId}"
tags: ["Order"]
---

# Update Assessment Order

`PATCH /apiHub/performanceManagement/v1/companies/{companyId}/assessmentOrders/{orderId}`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/performanceManagement/v1/companies/{companyId}/assessmentOrders/{orderId}`
- Auth: none declared. Required headers: `Authorization`

> 🚧 Partner Restricted
> All assessment API endpoints are restricted to assessment providers that have signed a Paylocity technology partnership agreement. 
[Please reach out to our team](https://www.paylocity.com/contact/partner-form/) if you would like to discuss partnership opportunities.

**Summary Description**

This endpoint updates the Assessment Order status for the given companyId and OrderId. The patch operation on the candidate status endpoint allows you to update the status of the overall assessment order (package) and the related tests. You can also send the URL where the PCTY user can view the complete assessment result.

**Use Cases**

- Customizable Endpoints: The Partner would use this to provide a general endpoint for all Paylocity clients by specifying b6001
- Notification Management: The Partner would use this endpoint to receive notifications about new orders, errors, and job creation events
- Please note: When using the ‘Complete’ statuses (Complete, Complete- Review, Expired) on Assessment level, all tests statuses must be in a ‘Complete’ status as well (Complete, Retest Recommended, Expired). See the Order Overview page for more information

## Path parameters

- `companyId` string, required
- `orderId` string, required

## Headers

- `testMode` boolean
- `Authorization` string, required

## Request body

- PatchOrderRequest: Assessment order patch payload.
  - `partnerTrackingId` string, nullable: Partner tracking id used for troubleshooting. Optional.
  - `overallScore` string, nullable: An indication of whether the assessee met all necessary predetermined ranges set for the job. Max length = 30. Optional.
  - `overallScoreDescription` string, nullable: Description of the overall score. Max length = 250. Optional.
  - `overallReports` OverallReportDto[], nullable: Reports of the assessment order. Optional.
    - `name` string, nullable: The name of the report. Max length = 250. Optional.
    - `url` string, nullable: The URL of the report that can be viewed on the partners web application. Max length = 2048. Required.
  - `assessments` PatchAssessmentDto[], nullable: Collection of assessment results. Required.
    - `assessmentId` string, nullable: ID of the assessment. Required.
    - `assessmentStatus` AssessmentStatusDto: Assessment order status payload.
      - `updatedAt` string, date-time: The date and time when the assessment order was updated. Required.
      - `value` 'Ordered' | 'WaitingOnAssessee' | 'InProgress' | 'Hold' | 'Complete' | 'CompleteReview' | 'RetestRecommended' | 'Expired', nullable: The new status of the assessment order. Required.
    - `assessmentResults` AssessmentResultsDto
      - `tests` TestDto[], nullable: Collection of tests associated with the assessment order. Optional.
        - `id` string, nullable: Assessment order test id. Max length = 150. Required.
        - `score` ScoreDto: Score payload.
          - `value` string, nullable: The value of the score. Max length = 50. Optional.
          - `description` string, nullable: The description of the score. This is an optional field where you can add description of what the score means for the assessee relative to the job posting. Max length = 250. Optional.
          - `attempt` integer: The attempt of the test. Required.
          - `reports` ReportDto[], nullable: Score reports. Optional.
            - `name` string, nullable: The name of the report. Max length = 250. Optional.
            - `url` string, nullable: The URL of the report that can be viewed on the partners web application. Max length = 2048. Required.
        - `testStatus` TestStatusDto: Assessment order test status payload.
          - `updatedAt` string, date-time: The date and time when the assessment test was updated. Required.
          - `value` 'Ordered' | 'Pending' | 'InProgress' | 'Hold' | 'Complete' | 'RetestRecommended' | 'Expired', nullable: The new status of the assessment test. Required.
      - `score` string, nullable: An indication of whether the assessee met all necessary predetermined ranges set for the assessment. Optional.
      - `scoreDescription` string, nullable: Description of the assessment score. Optional.
      - `reports` OverallReportDto[], nullable: Reports of the assessment. Optional.
        - `name` string, nullable: The name of the report. Max length = 250. Optional.
        - `url` string, nullable: The URL of the report that can be viewed on the partners web application. Max length = 2048. Required.

## Response `204`

No Content - Resource has been updated.

## Other responses

- `400`: Bad Request - Returns the details of the error.
- `401`: Unauthorized
- `404`: Not Found - Returns the details of the error.
- `415`: Unsupported Media Type - Returns the details of the error.

## Changes

- **2026-11-03** `bf323b2134ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paylocity/apis/assessments-api/changes/apiHub/performanceManagement/v1/companies/:companyId/assessmentOrders/:orderId/patch.md)

---

[API](https://skmtc.dev/paylocity/apis/assessments-api.md) - [All operations](https://skmtc.dev/paylocity/apis/assessments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/assessments-api/revisions/bf323b2134ff?raw)