---
title: "Assign designations to a designation group"
method: POST
path: "/v1/designation_groups/{id}/designations/assign"
tags: ["Designation groups"]
---

# Assign designations to a designation group

`POST /v1/designation_groups/{id}/designations/assign`

Use this request to attach one or more designations to a designation group. Each item is processed independently; the response reports the per-item outcome.

## Path parameters

- `id` string, required

## Request body

- BatchAssignDesignationsRequest — Contains the designations to attach to a designation group.
  - `items` BatchAssignDesignationItem[], required — An array of designations to assign to the designation group.
    - `id` string, required — Unique identifier of the designation, formatted as E[A-Z\d]{7}.
  - `livemode` boolean — Specifies whether the request is executed in live or test mode. Required for API keys created after 30th January 2026. Designation groups only exist in live mode — set this to `true`.

## Response `200`

On success, the API returns the overall status and a per-item result array describing which designations were attached.

- BatchAssignDesignationsResponse — Per-item result of attaching designations to a designation group.
  - `results` BatchAssignResultItem[], required — An array containing the result for each item in the request, in the same order.
    - `error` DesignationGroupAssignDesignationError, required — Error describing why a single batch item could not be processed.
      - `code` 'designation_not_found' | 'designation_already_attached', required — Error code.
      - `message` string, required — Error message.
    - `id` string, required — Unique identifier of the designation, formatted as E[A-Z\d]{7}.
  - `status` 'complete' | 'partial' | 'failed', required — Status of the bulk operation.

## Other responses

- `403` — Forbidden. The API key does not have permission to manage designation groups.
- `404` — Resource not found.
- `422` — The request contains duplicated ids.

---

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