---
title: "Upsert issue tracker schemas"
method: PUT
path: "/integrations/{id}/issueTracker/schemas"
tags: ["WorkspaceIntegration"]
---

# Upsert issue tracker schemas

`PUT /integrations/{id}/issueTracker/schemas`

Creates/updates one or more schemas associated with this issue tracker integration

## Path parameters

- `id` string, required

## Request body

- IssueSchema[]
  - `id` string, required — ID for this schema; guaranteed to be unique within the associated integration
  - `key` IssueSchemaKey[], required — Composite key for the schema, expressed as a list of field ids and values (must be a subset of fields)
    - `field_id` string, required
    - `field_value` unknown, required
  - `fields` IssueSchemaField[], required — All fields in the schema
    - `id` string, required — Field identifier
    - `name` string, required — Human-friendly field descriptor
    - `type` 'project' | 'issuetype' | 'user' | 'priority' | 'text' | 'textarea' | 'labels' | 'number' | 'date' | 'datetime' | 'checkboxes' | 'radiobuttons', required — Field type
    - `allowed_values` unknown[] — Allowed values for the field if applicable
      - unknown
    - `is_required` boolean, required — Whether the field is required

## Response `204`

Schemas upserted

## Other responses

- `400` — Required field missing, or specified integration is not an issue tracker type
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Integration not found
- `default` — Unknown error

---

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