---
title: "Add, rename or remove your own fields on a collection"
method: PUT
path: "/v1/workspace/collections/{collection_id}/fields"
---

# Add, rename or remove your own fields on a collection

`PUT /v1/workspace/collections/{collection_id}/fields`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/workspace/collections/{collection_id}/fields`
- Auth: API key in header `Authorization`

## Path parameters

- `collection_id` string, required

## Request body

- YourFieldsSave
  - `expected_version` integer, required
  - `fields` YourField[], required
    - `key` string, required
    - `label` string, required
    - `type` 'choice' | 'check' | 'text', required
    - `options` string[], nullable

## Response `200`

Add, rename or remove your own fields on a collection

- object
  - `data` YourFields, required
    - `collection_id` string, required
    - `version` integer, required
    - `fields` YourField[], required
      - `key` string, required
      - `label` string, required
      - `type` 'choice' | 'check' | 'text', required
      - `options` string[], nullable
    - `values` object, required

## Other responses

- `default`: Error envelope

---

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