---
title: "Batch assign requests to an assignee"
method: POST
path: "/v1/internal/requests/batch_assign"
tags: ["Capability Requests"]
---

# Batch assign requests to an assignee

`POST /v1/internal/requests/batch_assign`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/v1/internal/requests/batch_assign`
- Auth: none required

Assigns multiple requests to a single assignee with audit logging

## Request body

- BatchAssignRequestsReqDTO
  - `assignee_email` string, required: AssigneeEmail is the email of the user to assign to the requests
  - `note` string: Note is an optional human-readable note explaining the assignment
  - `request_ids` string[], required: RequestIDs is the list of request IDs to assign

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` BatchAssignRequestsResDTO
    - `failed_count` integer: FailedCount is the number of requests that failed to be assigned
    - `results` BatchAssignResultDTO[]: Results contains the detailed result for each request
      - `assigned_at` string
      - `error` string
      - `request_id` string
      - `status` string: Status is the request's resulting status after the (un)assignment, so clients can update their view without re-fetching. Mirrors the status transition applied by BatchUpdateAssignee.
      - `success` boolean
    - `success_count` integer: SuccessCount is the number of requests successfully assigned
  - `has_more` boolean

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/paymongo/apis/onboarding-api.md) - [All operations](https://skmtc.dev/paymongo/apis/onboarding-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/onboarding-api/revisions/36885f98768f?raw)