---
title: "create or update a config"
method: POST
path: "/api/v1/configs"
tags: ["config"]
---

# create or update a config

`POST /api/v1/configs`

## Request body

- V1CreateConfigRequest
  - `alias` string, required
  - `description` string, required
  - `name` string, required
  - `properties` string
  - `template` V1NamespacedName, required
    - `name` string, required
    - `namespace` string

## Response `200`

OK

- V1Config
  - `ArgsEscaped` boolean
  - `AttachStderr` boolean
  - `AttachStdin` boolean
  - `AttachStdout` boolean
  - `Cmd` string[]
  - `Domainname` string
  - `Entrypoint` string[]
  - `Env` string[]
  - `ExposedPorts` object
  - `Healthcheck` V1HealthConfig
    - `Interval` integer
    - `Retries` integer
    - `StartPeriod` integer
    - `Test` string[]
    - `Timeout` integer
  - `Hostname` string
  - `Image` string
  - `Labels` object
  - `MacAddress` string
  - `NetworkDisabled` boolean
  - `OnBuild` string[]
  - `OpenStdin` boolean
  - `Shell` string[]
  - `StdinOnce` boolean
  - `StopSignal` string
  - `Tty` boolean
  - `User` string
  - `Volumes` object
  - `WorkingDir` string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/kubevela/apis/kubevela-api-doc.md) · [All operations](https://skmtc.net/kubevela/apis/kubevela-api-doc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kubevela/kubevela-api-doc/versions/8e41615b25d5/schema)