---
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

---

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