---
title: "Update an artifact"
method: PATCH
path: "/v1/artifacts/{id}"
---

# Update an artifact

`PATCH /v1/artifacts/{id}`

## Request

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

Update values of existing information fields for this artifact's type. Field names are matched ignoring case and surrounding whitespace. Unknown fields and mismatched field types return 400. Fields omitted from the request remain unchanged. This endpoint does not create field definitions or update artifact content.

## Path parameters

- `id` string, required

## Request body

- UpdateArtifact
  - `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

## Response `200`

Updated artifact

- ArtifactListItem
  - `id` string, required
  - `name` string, required
  - `coverImageUrl` string, uri, nullable, required
  - `projectId` string, required
  - `workspaceId` string, required
  - `summary` string, required
  - `isPublished` boolean, required
  - `type` 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
  - `updatedAt` string, date-time, required: ISO-8601 timestamp of last update

## 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)