---
title: "Assign Ticket Reviewer"
method: POST
path: "/tickets/{ticket_id}/assign"
tags: ["Ticket Management"]
---

# Assign Ticket Reviewer

`POST /tickets/{ticket_id}/assign`

## Request

- Base URL: `https://api-sandbox.aiprise.com/api/v1`
- URL: `https://api-sandbox.aiprise.com/api/v1/tickets/{ticket_id}/assign`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/aiprise/apis/aiprise-apis/docs/tickets/:ticket_id/assign/post.ts> (a function with typed inputs; its response is checked against the schema)

Assign a ticket to a reviewer in your company by email, or remove the current reviewer.

Only the reviewer changes. The ticket keeps its status and review queue, and resolved tickets can be reassigned too. When the reviewer changes, AiPrise records the change in the activity trail and sends a `TICKET_REVIEWER_UPDATE` event to the events callback URL, if one is set.

If the ticket already has that reviewer, nothing changes and the response has `updated: false`.

Requires ticket management to be enabled for your company. Limited to 60 requests per minute per API key.

## Path parameters

- `ticket_id` string, required

## Request body

- AssignTicketReviewerRequest
  - `assignee_email` string, nullable, required: Email of the reviewer to assign. It must belong to an active user in your company. Matching ignores case. Send `null` to remove the current reviewer. The field is required, so leaving it out returns 400 instead of removing the reviewer.

## Response `200`

The ticket after the request. `updated` is `false` when the ticket already had this reviewer.

- AssignTicketReviewerResponse: A review ticket on a verification session, user profile or business profile.
  - `ticket_id` string: Unique ID of the ticket.
  - `target_id` string: ID of the record the ticket belongs to: a verification session ID, user profile ID or business profile ID, depending on `target_id_type`.
  - `target_id_type` 'USER' | 'USER_PROFILE' | 'BUSINESS' | 'null', nullable: What `target_id` points to. `USER` is a KYC verification session that is not linked to a user profile. `null` on some older tickets created before this field existed.
  - `ticket_status` 'OPEN' | 'RESOLVED'
  - `trigger` string, nullable: The alert trigger that created the ticket. One of CASE_GOES_TO_REVIEW, AML_MONITORING_UPDATE, ID_EXPIRES, DOCUMENT_EXPIRES, WEBSITE_MONITORING_UPDATE or PERIODIC_REVIEW. `null` when the ticket was not created by an alert, for example when a reviewer created it by hand in the dashboard.
  - `review_queue` object, nullable: The review queue the ticket is in, or `null` if it is not in a queue.
    - `review_queue_id` string
    - `name` string
  - `assignee` object, nullable: The reviewer assigned to the ticket, or `null` if nobody is.
    - `email` string
  - `created_at` integer: When the ticket was created, as a Unix timestamp in milliseconds.
  - `resolved_at` integer, nullable: When the ticket was resolved, as a Unix timestamp in milliseconds. `null` while the ticket is open.
  - `updated` boolean: `true` if the reviewer changed. `false` if the ticket already had this reviewer, in which case nothing changed.

## Other responses

- `400`: Bad Request. The body is not a JSON object, `assignee_email` is missing, `assignee_email` is not a non-empty string or `null`, or the email does not belong to an active user in your company. An email that does not exist, belongs to an inactive user or belongs to another company gets the same message.
- `401`: Unauthorized. The API key is missing or invalid.
- `403`: Forbidden. Ticket management is not enabled for your company, the company's trial period has expired, or the API key is not associated with a company.
- `404`: Not Found. No ticket with this ID exists in your company. A ticket that belongs to another company gets the same response.

## Changes

- **2026-11-03** `74fc7a5199fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aiprise/apis/aiprise-apis/changes/tickets/:ticket_id/assign/post.md)

---

[API](https://skmtc.dev/aiprise/apis/aiprise-apis.md) - [All operations](https://skmtc.dev/aiprise/apis/aiprise-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/aiprise/apis/aiprise-apis/revisions/74fc7a5199fb?raw)