---
title: "Creates a new widget in the system by accepting widget data in the request body"
method: POST
path: "/widget"
tags: ["Widget"]
---

# Creates a new widget in the system by accepting widget data in the request body

`POST /widget`

## Request body

- WidgetResource
  - `widgetId` integer
  - `i` string
  - `icon` string
  - `tooltipTranslationKey` string

## Response `200`

Widget is successfully created. The 'widgetId' property will include newly created widget's 'id'

- WidgetResource
  - `widgetId` integer
  - `i` string
  - `icon` string
  - `tooltipTranslationKey` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Error
- `502` — Bad Gateway

## Changes

> 3 revisions in range; 1 not diffed.

- **2026-07-30** `82ed767ffb65` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/opencelium/apis/opencelium-api/changes/widget/post.md)

---

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