---
title: "Set packages"
method: PUT
path: "/assessment/packages"
tags: ["Unified ATS (Assessment & Background Check) API"]
---

# Set packages

`PUT /assessment/packages`

Set packages

Replaces the list of available assessment and or background check packages.

Packages that have been previously submitted through this endpoint but aren't included again will be marked as deleted.

### Example Request Body

```json
{
  "packages": [
    {
      "id": "1001",
      "type": "SKILLS_TEST",
      "name": "TypeScript",
      "description": "TypeScript coding skills assessments"
    },
    {
      "id": "1002",
      "type": "VIDEO_INTERVIEW",
      "name": "Video Interview",
      "description": "Video interview to assess communication skills"
    }
  ]
}
```

## Headers

- `X-Integration-Id` string, required

## Request body

- PutAssessmentPackagesRequestBody
  - `packages` object[], required
    - `id` string, required — A unique identifier for the assessment package.
    - `type` 'BEHAVIORAL' | 'VIDEO_INTERVIEW' | 'SKILLS_TEST' | 'BACKGROUND_CHECK' | 'REFERENCE_CHECK', required
    - `name` string, required — The name of the assessment package.
    - `description` string, required — Description about the package. Some ATSs will display this in their UI.

## Response `200`

PUT /assessment/packages Positive response

- PutAssessmentPackagesPositiveResponse
  - `status` 'success', required
  - `data` object, required
  - `warnings` object[], required — These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.
    - `message` string, required

## Other responses

- `default` — The standard error response with the error codes for the ATS use case.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/149bf44faf1a/schema)