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

# Create a plugin.

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

Create a new plugin for a specific agent (formerly known as project) identified by its unique projectId. This endpoint enables you to create a custom plugin for the project. Which allows you to share the custom agent as openai plugin to be shared globally.

## 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 `201`

Agent plugin has been created

- 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 not found
- `500` — Internal Server Error

## Changes

- **2026-07-17** `b80e6dfcf78d` — 2 warning, 4 info
  - added the new `Agent id is required` enum value to the `data/message` response property for the response status `404`
  - added the new `Agent with id {projectId} not found` enum value to the `data/message` response property for the response status `404`
  - api tag `Agent Plugins` added
  - api tag `Project Plugins` removed
  - …2 more
- **2023-07-27** `2cd2d58839d0` — 1 info
  - added the non-success response with the status `400`
- **2023-07-12** `1675fc6aa16a` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **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/post.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)