---
title: "Update a participant"
method: PATCH
path: "/v1/participants/{id}"
---

# Update a participant

`PATCH /v1/participants/{id}`

## Request

- Base URL: `https://api.condens.io`
- URL: `https://api.condens.io/v1/participants/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateParticipant
  - `name` string
  - `informationFields` InformationField[]
    - union
      - TextInformationField
        - `fieldName` string, required
        - `fieldType` 'text', required
        - `value` string, required
      - NumberInformationField
        - `fieldName` string, required
        - `fieldType` 'number', required
        - `value` integer, required
      - DateInformationField
        - `fieldName` string, required
        - `fieldType` 'date', required
        - `value` string, date, required
      - CheckboxInformationField
        - `fieldName` string, required
        - `fieldType` 'checkbox', required
        - `value` boolean, required
      - SingleSelectInformationField
        - `fieldName` string, required
        - `fieldType` 'single_select', required
        - `value` string, required
      - MultiSelectInformationField
        - `fieldName` string, required
        - `fieldType` 'multi_select', required
        - `value` string[], required
      - ParticipantsInformationField
        - `fieldName` string, required
        - `fieldType` 'participant', required
        - `value` union[], required
          - union
            - object
              - …
            - object
              - …
      - UserInformationField
        - `fieldName` string, required
        - `fieldType` 'user', required
        - `value` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - UrlInformationField
        - `fieldName` string, required
        - `fieldType` 'url', required
        - `value` string, uri, required
      - EmailInformationField
        - `fieldName` string, required
        - `fieldType` 'email', required
        - `value` string, email, required
      - NpsInformationField
        - `fieldName` string, required
        - `fieldType` 'nps', required
        - `value` integer, required
  - `attachments` object[]
    - `sourceUrl` string, uri, required: URL of the source to be fetched. Must be accessible from the internet.
    - `sourceAuth` union
      - object
        - `type` 'bearer', required
        - `token` string, required: Bearer token to be sent as 'Authorization: Bearer <token>'
      - object
        - `type` 'apiKey', required
        - `key` string, required: API key to be sent as 'x-api-key: <key>'
    - `name` string

## Response `200`

Updated participant

- ParticipantItem
  - `id` string, required
  - `name` string, required
  - `workspaceId` string, required
  - `informationFields` InformationField[], required
    - union
      - TextInformationField
        - `fieldName` string, required
        - `fieldType` 'text', required
        - `value` string, required
      - NumberInformationField
        - `fieldName` string, required
        - `fieldType` 'number', required
        - `value` integer, required
      - DateInformationField
        - `fieldName` string, required
        - `fieldType` 'date', required
        - `value` string, date, required
      - CheckboxInformationField
        - `fieldName` string, required
        - `fieldType` 'checkbox', required
        - `value` boolean, required
      - SingleSelectInformationField
        - `fieldName` string, required
        - `fieldType` 'single_select', required
        - `value` string, required
      - MultiSelectInformationField
        - `fieldName` string, required
        - `fieldType` 'multi_select', required
        - `value` string[], required
      - ParticipantsInformationField
        - `fieldName` string, required
        - `fieldType` 'participant', required
        - `value` union[], required
          - union
            - object
              - …
            - object
              - …
      - UserInformationField
        - `fieldName` string, required
        - `fieldType` 'user', required
        - `value` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
      - UrlInformationField
        - `fieldName` string, required
        - `fieldType` 'url', required
        - `value` string, uri, required
      - EmailInformationField
        - `fieldName` string, required
        - `fieldType` 'email', required
        - `value` string, email, required
      - NpsInformationField
        - `fieldName` string, required
        - `fieldType` 'nps', required
        - `value` integer, required
  - `attachments` object[], required
    - `name` string, required
  - `updatedAt` string, date-time, required: ISO-8601 timestamp of last update
  - `failedUploadUrls` string[]: URLs of files that failed to upload. Only present if one or more uploads failed.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/condens/apis/condens-api.md) · [All operations](https://skmtc.dev/condens/apis/condens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/condens/apis/condens-api/revisions/7b93612e150f?raw)