---
title: "POST /transitions"
method: POST
path: "/transitions"
---

# POST /transitions

`POST /transitions`

## Headers

- `Content-Type` string, required

## Request body

- PostTransitions
  - `description` string, nullable
  - `name` string, nullable
  - `parameters` union
    - object
      - `cpu` 256 | 512 | 1024
      - `environment` object
      - `environmentSecrets` string[]
      - `imageUrl` string, required
      - `memory` 512 | 1024 | 2048 | 4096 | 8192
      - `secretId` string
    - object
      - `environment` object
      - `environmentSecrets` string[]
      - `lambdaId` string, required
    - object
      - `assets` object
        - `jsRemoteComponent` string
  - `timeoutInSeconds` integer
  - `transitionType` 'docker' | 'manual' | 'lambda', required

## Response `200`

200 response

- Transition
  - `assets` object
    - `jsRemoteComponent` string
  - `createdBy` string, nullable, required
  - `createdTime` string, nullable, required
  - `description` string, nullable, required
  - `name` string, nullable, required
  - `parameters` object, required
  - `timeoutInSeconds` integer, required
  - `transitionId` union, required
    - string
    - string
  - `transitionType` 'docker' | 'manual' | 'lambda', required
  - `updatedBy` string, nullable, required
  - `updatedTime` string, nullable, required

## Other responses

- `400` — 400 response
- `403` — 403 response
- `404` — 404 response
- `415` — 415 response
- `500` — 500 response

## Changes

- **2026-07-13** `d5fe190026be` — 1 breaking, 5 warning, 3 info
  - the `timeoutInSeconds` response property's max was increased from `3600.00` to `10800.00` for the response status `200`
  - removed the request property `inputJsonSchema`
  - removed the request property `outputJsonSchema`
  - removed the optional property `inputJsonSchema` from the response with the `200` status
  - …5 more
- **2024-02-05** `c371d93c085f` — 1 breaking, 1 info
  - the `timeoutInSeconds` response property's max was increased from `1800.00` to `3600.00` for the response status `200`
  - the `timeoutInSeconds` request property's max was increased from `1800.00` to `3600.00`
- **2022-09-27** `bdb2f40e38bf` — 4 info
  - added the new `1024.00` enum value to the request property `parameters/anyOf[subschema #1]/cpu`
  - added the new `4096.00` enum value to the request property `parameters/anyOf[subschema #1]/memory`
  - added the new `512.00` enum value to the request property `parameters/anyOf[subschema #1]/cpu`
  - added the new `8192.00` enum value to the request property `parameters/anyOf[subschema #1]/memory`
- **2021-11-05** `9788e6bfa925` — 3 breaking, 6 info
  - removed `subschema #1, subschema #2` from the `parameters` request property `anyOf` list
  - removed the enum value `lambda` of the request property `transitionType`
  - the `timeoutInSeconds` request property's max was decreased to `1800.00`
  - added the new optional request property `inputJsonSchema`
  - …5 more

[Change history](https://skmtc.dev/lucidtechai/apis/lucidtech-api/changes/transitions/post.md)

---

[API](https://skmtc.dev/lucidtechai/apis/lucidtech-api.md) · [All operations](https://skmtc.dev/lucidtechai/apis/lucidtech-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lucidtechai/lucidtech-api/revisions/d5fe190026be/schema)