Update Assessment Order | Paylocity | Recruiting Documentation

curl -X PATCH https://api.paylocity.com/apiHub/performanceManagement/v1/companies/companyId/assessmentOrders/orderId \
     -H "testMode: <boolean>" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "partnerTrackingId": "<string>",
  "overallScore": "<string>",
  "overallScoreDescription": "<string>",
  "overallReports": [
    {
      "name": "<string>",
      "url": "<string>",
      "key_0": {}
    },
    {
      "name": "<string>",
      "url": "<string>",
      "key_0": {}
    }
  ],
  "assessments": [
    {
      "assessmentId": "<string>",
      "assessmentStatus": {
        "updatedAt": "<dateTime>",
        "value": "Complete",
        "key_0": {},
        "key_1": {}
      },
      "assessmentResults": {
        "tests": [
          {
            "id": "<string>",
            "score": {
              "value": "<string>",
              "description": "<string>",
              "attempt": "<integer>",
              "reports": [
                {
                  "name": "<string>",
                  "url": "<string>",
                  "key_0": {}
                },
                {
                  "name": "<string>",
                  "url": "<string>"
                }
              ],
              "key_0": {},
              "key_1": {}
            },
            "testStatus": {
              "updatedAt": "<dateTime>",
              "value": "Expired"
            }
          },
          {
            "id": "<string>",
            "score": {
              "value": "<string>",
              "description": "<string>",
              "attempt": "<integer>",
              "reports": [
                {
                  "name": "<string>",
                  "url": "<string>",
                  "key_0": {},
                  "key_1": {}
                },
                {
                  "name": "<string>",
                  "url": "<string>",
                  "key_0": {}
                }
              ],
              "key_0": {},
              "key_1": {}
            },
            "testStatus": {
              "updatedAt": "<dateTime>",
              "value": "Hold"
            },
            "key_0": {},
            "key_1": {}
          }
        ],
        "score": "<string>",
        "scoreDescription": "<string>",
        "reports": [
          {
            "name": "<string>",
            "url": "<string>"
          },
          {
            "name": "<string>",
            "url": "<string>"
          }
        ],
        "key_0": {},
        "key_1": {},
        "key_2": {}
      }
    },
    {
      "assessmentId": "<string>",
      "assessmentStatus": {
        "updatedAt": "<dateTime>",
        "value": "Expired"
      },
      "assessmentResults": {
        "tests": [
          {
            "id": "<string>",
            "score": {
              "value": "<string>",
              "description": "<string>",
              "attempt": "<integer>",
              "reports": [
                {
                  "name": "<string>",
                  "url": "<string>"
                },
                {
                  "name": "<string>",
                  "url": "<string>",
                  "key_0": {},
                  "key_1": {}
                }
              ]
            },
            "testStatus": {
              "updatedAt": "<dateTime>",
              "value": "Complete",
              "key_0": {},
              "key_1": {}
            }
          },
          {
            "id": "<string>",
            "score": {
              "value": "<string>",
              "description": "<string>",
              "attempt": "<integer>",
              "reports": [
                {
                  "name": "<string>",
                  "url": "<string>"
                },
                {
                  "name": "<string>",
                  "url": "<string>"
                }
              ]
            },
            "testStatus": {
              "updatedAt": "<dateTime>",
              "value": "Expired"
            },
            "key_0": {}
          }
        ],
        "score": "<string>",
        "scoreDescription": "<string>",
        "reports": [
          {
            "name": "<string>",
            "url": "<string>"
          },
          {
            "name": "<string>",
            "url": "<string>",
            "key_0": {},
            "key_1": {}
          }
        ],
        "key_0": {},
        "key_1": {}
      }
    }
  ]
}'

Partner Restricted

All assessment API endpoints are restricted to assessment providers that have signed a Paylocity technology partnership agreement. Please reach out to Techpartnerships@paylocity.com 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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

companyIdstringRequired

orderIdstringRequired

Request

This endpoint expects an object.

Response

Successful response

Authentication

Path parameters

Headers

Request

Response