---
title: "Update a pool item"
method: PUT
path: "/participant-pools/{participantPoolId}/items/{id}"
tags: ["Items"]
---

# Update a pool item

`PUT /participant-pools/{participantPoolId}/items/{id}`

Update an existing item in the participant pool

## Request body

- object
  - `scheduling` ParticipantPoolItemScheduling — Scheduling configuration for a participant pool item
    - `dateType` 'FIXED' | 'DATE_RANGE', required — Type time preference for the participant pool item
    - `schedulingMode` 'PRE_SCHEDULED' | 'ON_DEMAND', required — Matching mechanism for scheduling participants
    - `startDate` string, date-time — Earliest date of availability
    - `endDate` string, date-time — Latest possible date for the item
    - `timezone` string — Timezone for scheduling (e.g. 'America/New_York')
    - `duration` integer — Duration of the meeting in minutes
    - `scheduleSetterParticipantId` string — ID of the participant who sets the schedule
    - `queueForTagging` boolean — Whether the item should be queued for tagging
    - `bid` ParticipantPoolItemSchedulingBid — Bidding configuration for participant pool item scheduling
      - `maxPrice` number — Maximum price willing to pay for the scheduling slot
      - `currency` string — Currency code for the price (e.g., USD, EUR)
    - `counterBids` ParticipantPoolItemSchedulingCounterBid[] — Counter bids for this scheduling item
      - `id` string — Unique identifier for the counter bid
      - `counter` ParticipantPoolItemSchedulingBid, required — Bidding configuration for participant pool item scheduling
        - `maxPrice` number — Maximum price willing to pay for the scheduling slot
        - `currency` string — Currency code for the price (e.g., USD, EUR)
      - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED', required — Status of a counter bid for participant pool item scheduling
      - `publicId` string — Public identifier of the counter bidder
      - `name` string — Name of the counter bidder
      - `email` string — Email of the counter bidder
      - `createdAt` string, date-time — Timestamp when the counter bid was created
      - `updatedAt` string, date-time — Timestamp when the counter bid was last updated
      - `respondedAt` string, date-time — Timestamp when the counter bid was accepted or rejected
  - `assignmentRules` ParticipantPoolItemAssignmentRule[]
    - `ruleId` string
    - `metadata` unknown

## Response `200`

Item updated successfully

- ParticipantPoolItem — An item in a participant pool representing a specific request or assignment
  - `id` string — Unique identifier for the participant pool item
  - `participantPoolId` string, required — ID of the participant pool this item belongs to
  - `status` 'DRAFT' | 'AWAITING_TAGGING' | 'AWAITING_PARTICIPANT_PREFERENCE' | 'REQUEST_SENT_TO_ENROLLEES' | 'MATCHED' | 'STALE' | 'CANCELLED' | 'COMPLETED', required — Current status of a participant pool item
  - `linkedObject` ParticipantPoolItemLinkedObject — Object linked to a participant pool item
    - `objectId` string, required — Identifier of the linked object
    - `kind` 'E_SIGNATURE_PACKAGE', required — Type of object linked to the participant pool item
    - `linkedParticipantId` string — ID of the linked participant in the object (e.g. signer id)
  - `scheduling` ParticipantPoolItemScheduling — Scheduling configuration for a participant pool item
    - `dateType` 'FIXED' | 'DATE_RANGE', required — Type time preference for the participant pool item
    - `schedulingMode` 'PRE_SCHEDULED' | 'ON_DEMAND', required — Matching mechanism for scheduling participants
    - `startDate` string, date-time — Earliest date of availability
    - `endDate` string, date-time — Latest possible date for the item
    - `timezone` string — Timezone for scheduling (e.g. 'America/New_York')
    - `duration` integer — Duration of the meeting in minutes
    - `scheduleSetterParticipantId` string — ID of the participant who sets the schedule
    - `queueForTagging` boolean — Whether the item should be queued for tagging
    - `bid` ParticipantPoolItemSchedulingBid — Bidding configuration for participant pool item scheduling
      - `maxPrice` number — Maximum price willing to pay for the scheduling slot
      - `currency` string — Currency code for the price (e.g., USD, EUR)
    - `counterBids` ParticipantPoolItemSchedulingCounterBid[] — Counter bids for this scheduling item
      - `id` string — Unique identifier for the counter bid
      - `counter` ParticipantPoolItemSchedulingBid, required — Bidding configuration for participant pool item scheduling
        - `maxPrice` number — Maximum price willing to pay for the scheduling slot
        - `currency` string — Currency code for the price (e.g., USD, EUR)
      - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED', required — Status of a counter bid for participant pool item scheduling
      - `publicId` string — Public identifier of the counter bidder
      - `name` string — Name of the counter bidder
      - `email` string — Email of the counter bidder
      - `createdAt` string, date-time — Timestamp when the counter bid was created
      - `updatedAt` string, date-time — Timestamp when the counter bid was last updated
      - `respondedAt` string, date-time — Timestamp when the counter bid was accepted or rejected
  - `ownershipRegistry` ParticipantPoolItemOwnershipRegistryItem[] — Registry of owners for this item
    - `role` 'OWNER' | 'ADMIN' | 'ENROLLEE' | 'ASSIGNER' | 'TAGGER', required — Role of a member within the participant pool
    - `publicId` string, required — Public identifier of the owner
    - `timestamp` string, date-time — When this ownership change occurred
    - `reason` string — Optional reason for the ownership change
  - `assignmentRules` ParticipantPoolItemAssignmentRule[]
    - `ruleId` string
    - `metadata` unknown

---

[API](https://skmtc.net/pactima/apis/esignature-packages-api.md) · [All operations](https://skmtc.net/pactima/apis/esignature-packages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pactima/esignature-packages-api/revisions/1570128383ef/schema)