---
title: "Restart a failed plugin by installation ID"
method: POST
path: "/v1/partners/plugins/{pluginId}/restart"
tags: ["Plugin system"]
---

# Restart a failed plugin by installation ID

`POST /v1/partners/plugins/{pluginId}/restart`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/partners/plugins/{pluginId}/restart`
- Auth: HTTP bearer

Attempt to restart a plugin that is in a failed state.

## Path parameters

- `pluginId` string, required

## Response `200`

OK

- RestartResponseschema: Response to the plugin installation details by ID request.
  - `plugin` union, required
    - GetResponseschema13: Plugin installation details by ID request. Also contains Datacake specific fields.
      - `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
      - `workspaceId` string, required: Datacake workspace ID of the plugin
    - GetResponseschema15: Plugin installation details by ID request. Also contains Tartabit specific fields.
      - `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.
  - `restartStatus` 'SUCCESS' | 'FAILURE', required: Restart action status
  - `message` string, required: Restart action detail message

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `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)