---
title: "Install Tartabit plugin for 1NCE OS"
method: POST
path: "/v1/partners/TARTABIT/plugins"
tags: ["Plugin system"]
---

# Install Tartabit plugin for 1NCE OS

`POST /v1/partners/TARTABIT/plugins`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/partners/TARTABIT/plugins`
- Auth: HTTP bearer

Allows setting up an integration with Tartabit to integrate with Azure, Oracle Cloud Infrastructure, Google Cloud and other cloud services via 1NCE OS.

## Request body

- Postschema11: A request to install the Tartabit plugin for 1NCE OS.
  - `serverDomain` string, required: Tartabit IoT Bridge host domain. Must be a valid hostname.
  - `webhookKey` string, required: Webhook Secret from service specification in Tartabit IoT Bridge. Must contain valid uri characters.

## Response `201`

Successful Tartabit plugin installation response details.

- PostResponseschema11: Response to the Tartabit plugin installation request.
  - `id` string, required: Plugin installation identifier
  - `partner` string, required: Partner name
  - `created` string, date-time, required: Plugin installation timestamp
  - `updated` string, date-time, required: Plugin installation update timestamp
  - `status` string, required: Status of the plugin installation
  - `serverDomain` string, required: Tartabit IoT Bridge host domain
  - `webhookKey` string, required: Webhook Secret from service specification in Tartabit IoT Bridge.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)