---
title: "Update a plugin."
method: PUT
path: "/api/v1/projects/{projectId}/plugins"
tags: ["Agent Plugins"]
---

# Update a plugin.

`PUT /api/v1/projects/{projectId}/plugins`

Update the plugin configuration for a specific agent (formerly known as project) identified by its unique projectId. This endpoint allows you to update the associated attributes of the plugin.

## Path parameters

- `projectId` integer, required

## Request body

- object
  - `model_name` string — Model Name
  - `human_name` string — Name For Human
  - `keywords` string — Keywords For Model
  - `description` string — Description For Human
  - `is_active` boolean — Whether the agent plugin is active or not

## Response `200`

Agent plugin have been updated

- object
  - `status` 'error' | 'success' — The status of the response
  - `data` ProjectPlugin
    - `model_name` string — Model Name
    - `human_name` string — Name For Human
    - `keywords` string — Keywords For Model
    - `description` string — Description For Human
    - `logo` string — Agent plugin logo
    - `is_active` boolean — Whether the agent plugin is active or not

## Other responses

- `400` — Bad Argument
- `401` — API Token is either missing or invalid
- `404` — Agent plugin not found
- `500` — Internal Server Error

## Changes

- **2026-07-17** `b80e6dfcf78d` — 3 warning, 5 info
  - added the new `Agent plugin id is required` enum value to the `data/message` response property for the response status `404`
  - added the new `Agent plugin with id {pluginId} not found` enum value to the `data/message` response property for the response status `404`
  - added the new `Plugin for agent with id {projectId} not found` enum value to the `data/message` response property for the response status `404`
  - api tag `Agent Plugins` added
  - …4 more
- **2023-07-27** `2cd2d58839d0` — 1 info
  - added the non-success response with the status `400`
- **2023-07-12** `1675fc6aa16a` — 1 warning, 6 info
  - removed the optional property `data/ProjectPlugin` from the response with the `200` status
  - added the optional property `data/description` to the response with the `200` status
  - added the optional property `data/human_name` to the response with the `200` status
  - added the optional property `data/is_active` to the response with the `200` status
  - …3 more
- **2023-07-05** `3033527b3d74` — 1 info
  - endpoint added
- **2023-06-02** `1842d7fd0430` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/plugins/put.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) · [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/poll-the-people/customgpt-ai/revisions/b80e6dfcf78d/schema)