---
title: "Replace quantifier in period"
method: PATCH
path: "/api/periods/{id}/replaceQuantifier"
tags: ["Periods"]
---

# Replace quantifier in period

`PATCH /api/periods/{id}/replaceQuantifier`

## Path parameters

- `id` string, required

## Request body

- ReplaceQuantifierInputDto
  - `currentQuantifierId` string, required
  - `newQuantifierId` string, required

## Response `200`

Period

- ReplaceQuantifierResponseDto
  - `praises` Praise[], required
    - `_id` string, required
    - `reasonRaw` string, required
    - `reason` string, required
    - `sourceId` string, required
    - `sourceName` string, required
    - `score` number, required
    - `receiver` UserAccount, required
      - `_id` string, required
      - `user` UserNoUserAccountsDto
        - `_id` string, required
        - `identityEthAddress` string, required
        - `rewardsEthAddress` string, required
        - `username` string, required
        - `roles` string[], required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
      - `accountId` string, required
      - `name` string, required
      - `avatarId` string
      - `platform` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `giver` UserAccount, required
      - `_id` string, required
      - `user` UserNoUserAccountsDto
        - `_id` string, required
        - `identityEthAddress` string, required
        - `rewardsEthAddress` string, required
        - `username` string, required
        - `roles` string[], required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
      - `accountId` string, required
      - `name` string, required
      - `avatarId` string
      - `platform` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `forwarder` UserAccount
      - `_id` string, required
      - `user` UserNoUserAccountsDto
        - `_id` string, required
        - `identityEthAddress` string, required
        - `rewardsEthAddress` string, required
        - `username` string, required
        - `roles` string[], required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
      - `accountId` string, required
      - `name` string, required
      - `avatarId` string
      - `platform` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `quantifications` Quantification[], required
      - `_id` string, required
      - `score` number, required
      - `scoreRealized` number, required
      - `dismissed` boolean, required
      - `duplicatePraise` string, required
      - `quantifier` string, required
      - `praise` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `period` PeriodDetailsDto, required
    - `_id` string, required
    - `name` string, required
    - `status` 'OPEN' | 'QUANTIFY' | 'CLOSED', required
    - `endDate` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `quantifiers` PeriodDetailsQuantifierDto[]
      - `_id` string, required
      - `identityEthAddress` string, required
      - `username` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `finishedCount` number, required
      - `praiseCount` number, required
      - `quantifications` Quantification[], required
        - `_id` string, required
        - `score` number, required
        - `scoreRealized` number, required
        - `dismissed` boolean, required
        - `duplicatePraise` string, required
        - `quantifier` string, required
        - `praise` string, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
    - `givers` PeriodDetailsGiverReceiverDto[]
      - `_id` string, required
      - `accountId` string, required
      - `name` string, required
      - `avatarId` string
      - `platform` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `user` string, required
      - `praiseCount` number, required
      - `score` number, required
    - `receivers` PeriodDetailsGiverReceiverDto[]
      - `_id` string, required
      - `accountId` string, required
      - `name` string, required
      - `avatarId` string
      - `platform` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `user` string, required
      - `praiseCount` number, required
      - `score` number, required
    - `numberOfPraise` number, required

## Changes

- **2023-05-12** `78c48cd67184` — 5 breaking
  - the `period/allOf[#/components/schemas/PeriodDetailsDto]/givers/items/name` response property's maxLength was increased from `20` to `32` for the response status `200`
  - the `period/allOf[#/components/schemas/PeriodDetailsDto]/receivers/items/name` response property's maxLength was increased from `20` to `32` for the response status `200`
  - the `praises/items/forwarder/name` response property's maxLength was increased from `20` to `32` for the response status `200`
  - the `praises/items/giver/allOf[#/components/schemas/UserAccount]/name` response property's maxLength was increased from `20` to `32` for the response status `200`
  - …1 more
- **2023-04-27** `e14b4c818c53` — 1 info
  - endpoint added
- **2023-04-27** `e8ffc3233d9e` — 1 breaking
  - api path removed without deprecation
- **2023-04-24** `9096b31a006d` — 2 breaking, 10 info
  - the response property `praises/items/forwarder` became optional for the status `200`
  - the `praises/items/forwarder` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `praises/items/forwarder/user` to the response with the `200` status
  - removed `#/components/schemas/UserAccount` from the `praises/items/forwarder` response property `allOf` list for the response status `200`
  - …8 more
- **2023-04-04** `aa4804c758aa` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/givepraise/apis/praise-api/changes/api/periods/:id/replaceQuantifier/patch.md)

---

[API](https://skmtc.dev/givepraise/apis/praise-api.md) · [All operations](https://skmtc.dev/givepraise/apis/praise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/givepraise/praise-api/revisions/35689df7019c/schema)