---
title: "Update Plugin"
method: PUT
path: "/claude-code/plugins/{plugin_name}"
tags: ["claude_code_marketplace"]
---

# Update Plugin

`PUT /claude-code/plugins/{plugin_name}`

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/claude-code/plugins/{plugin_name}`
- Auth: API key in header `x-litellm-api-key`

Update an existing plugin in the LiteLLM marketplace.

The plugin is identified by its name in the path, which is the resource
identity and cannot be changed here. This is a full replace, not a merge:
the manifest is rebuilt from the request body, so any optional field left
out is reset to its default (e.g. an omitted version is cleared, not kept).
Send the full desired state.

Returns 404 if no plugin with the given name exists; use
POST /claude-code/plugins to create a new plugin.

Requires a proxy admin API key.

Parameters:
    - plugin_name: Name of the plugin to update (path parameter)
    - source: Plugin source reference (github, url, git-subdir, or archive format)
    - version: Semantic version (optional)
    - description: Plugin description (optional)
    - author: Author information (optional)
    - homepage: Plugin homepage URL (optional)
    - keywords: Search keywords (optional)
    - category: Plugin category (optional)

Returns:
    Update status (action is always "updated") and plugin information.

Example:
    ```bash
    curl -X PUT http://localhost:4000/claude-code/plugins/my-plugin \
      -H "Authorization: Bearer sk-..." \
      -H "Content-Type: application/json" \
      -d '{
        "source": {"source": "github", "repo": "org/my-plugin"},
        "version": "2.0.0",
        "description": "My awesome plugin"
      }'
    ```

## Path parameters

- `plugin_name` string, required

## Request body

- UpdatePluginRequest: Request body for replacing an existing plugin. The plugin name is the resource identity and is supplied as the path parameter, so it cannot be changed here. This is a full replace: omitted fields reset to their defaults, so version is cleared rather than defaulting to the create-time "1.0.0".
  - `author` PluginAuthor: Plugin author information.
    - `email` string, nullable: Author email
    - `name` string, required: Author name
  - `category` string, nullable: Plugin category
  - `description` string, nullable: Plugin description
  - `domain` string, nullable: Skill domain (e.g., 'Productivity')
  - `homepage` string, nullable: Plugin homepage URL
  - `keywords` string[], nullable: Search keywords
  - `namespace` string, nullable: Skill namespace within domain (e.g., 'workflows')
  - `source` object, required: Plugin source reference. Supported formats: - GitHub: {'source': 'github', 'repo': 'org/repo'} - Git URL: {'source': 'url', 'url': 'https://github.com/org/repo.git'} - Git Subdir: {'source': 'git-subdir', 'url': 'https://github.com/org/repo.git', 'path': 'plugins/plugin-name'} - Zip archive on any https host (e.g. S3): {'source': 'archive', 'url': 'https://bucket.s3.amazonaws.com/plugin.zip', 'sha256': '<optional hex digest>'}
  - `version` string, nullable: Semantic version; cleared if omitted

## Response `200`

Successful Response

- RegisterPluginResponse: Response from plugin registration.
  - `action` string, required: Action taken (created/updated)
  - `plugin` PluginResponse, required: Plugin information in API responses.
    - `description` string, nullable: Plugin description
    - `enabled` boolean, required: Whether plugin is enabled
    - `id` string, required: Plugin unique ID
    - `name` string, required: Plugin name
    - `source` object, required: Plugin source reference
    - `version` string, nullable: Plugin version
  - `status` string, required: Operation status

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sea-lion/apis/litellm-api/changes/claude-code/plugins/:plugin_name/put.md)

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)