---
title: "✨ Append saved interface versions"
method: POST
path: "/api/interfaces/{id}/append_versions/"
tags: ["Interfaces"]
---

# ✨ Append saved interface versions

`POST /api/interfaces/{id}/append_versions/`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Append one or more versions to a saved interface with server-assigned stable version IDs.

## Path parameters

- `id` integer, required

## Request body

- LseInterfaceAppendVersionsRequest
  - `artifacts` unknown
  - `code` string
  - `compiled` string
  - `data_sample` unknown
  - `input_schema` unknown
  - `messages` unknown
  - `metadata` unknown
  - `output_schema` unknown
  - `title` string
  - `versions` LseInterfaceAppendVersionRequest[], required
    - `artifactId` string
    - `changeRanges` unknown
    - `code` string, required
    - `compiled` string, required
    - `description` string
    - `inputSchema` unknown
    - `messageId` string
    - `op` string
    - `outputSchema` unknown
    - `paramsSchema` unknown
    - `screenParams` unknown
    - `unpublished` boolean

## Response `200`

- LseInterface
  - `artifacts` unknown
  - `code` string, required — JSX source code for the interface screen module
  - `compiled` string, required
  - `created_at` string, date-time, required
  - `created_by` UserSimple, required — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
    - `avatar` string, nullable, required
    - `email` string, email
    - `first_name` string
    - `id` integer, required
    - `last_name` string
    - `username` string, required
  - `data_sample` unknown
  - `description` string
  - `id` integer, required
  - `input_schema` unknown
  - `is_system` boolean, required — HumanSignal-provided system template visible to all organizations
  - `messages` unknown
  - `metadata` unknown
  - `output_schema` unknown
  - `projects_count` integer, required
  - `title` string, required
  - `updated_at` string, date-time, required
  - `versions` unknown
  - `workspace` integer, nullable

## Changes

- **2026-07-08** `b5f055b9d45b` — 1 breaking
  - the response property `created_by/allOf[#/components/schemas/UserSimple]/avatar` became nullable for the status `200`
- **2026-07-06** `c2893748a8d3` — 1 breaking
  - for the `path` request parameter `id`, the type/format was changed from `string`/`` to `integer`/``
- **2026-05-18** `c7f74f79b529` — 3 info
  - added the new optional request property `versions/items/screenParams` (media type: application/json)
  - added the new optional request property `versions/items/screenParams` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `versions/items/screenParams` (media type: multipart/form-data)
- **2026-05-08** `1679e894ea40` — 9 info
  - added the new optional request property `metadata` (media type: application/json)
  - added the new optional request property `metadata` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `metadata` (media type: multipart/form-data)
  - added the new optional request property `title` (media type: application/json)
  - …5 more
- **2026-05-07** `4d2f235ae6c4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/interfaces/:id/append_versions/post.md)

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/89caa2dca86f/schema)