---
title: "Create a system"
method: POST
path: "/systems"
tags: ["Catalog"]
---

# Create a system

`POST /systems`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/systems`
- Auth: HTTP bearer

## Request body

- SystemInput
  - `name` string
  - `description` string, nullable
  - `ownerTeamId` string, nullable
  - `domainId` string, nullable
  - `lifecycle` 'experimental' | 'production' | 'deprecated' | 'retired'
  - `componentIds` string[]
  - `apiIds` string[]
  - `resourceIds` string[]
  - `tags` string[]

## Response `201`

Created

- object
  - `system` System: A logical grouping of components, APIs, and resources. Sibling to Domain (a System's parent) and to leaf-entity kinds.
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `ownerTeamId` string, nullable
    - `domainId` string, nullable: Parent domain id, or null for top-level systems.
    - `lifecycle` 'experimental' | 'production' | 'deprecated' | 'retired', required
    - `componentIds` string[], required
    - `apiIds` string[], required
    - `resourceIds` string[], required
    - `tags` string[], required
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)

---

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