---
title: "Update Pack"
method: PATCH
path: "/packs/{packId}"
tags: ["Packs"]
---

# Update Pack

`PATCH /packs/{packId}`

Update an existing Pack for non-versioned fields.

## Path parameters

- `packId` integer, required

## Request body

- UpdatePackRequest — Payload for updating a Pack.
  - `overallRateLimit` object, nullable — Rate limit in Pack settings.
    - `intervalSeconds` integer, required — The rate limit interval in seconds.
    - `operationsPerInterval` integer, required — The maximum number of Pack operations that can be performed in a given interval.
  - `perConnectionRateLimit` object, nullable — Rate limit in Pack settings.
    - `intervalSeconds` integer, required — The rate limit interval in seconds.
    - `operationsPerInterval` integer, required — The maximum number of Pack operations that can be performed in a given interval.
  - `logo` object, nullable — Information about an image file for an update Pack request.
    - `assetId` string, required — The asset id of the Pack's image, returned by [`#PackAssetUploadComplete`](#operation/packAssetUploadComplete) endpoint.
    - `filename` string, required — The filename for the image.
    - `mimeType` string — The media type of the image being sent.
  - `cover` object, nullable — Information about an image file for an update Pack request.
    - `assetId` string, required — The asset id of the Pack's image, returned by [`#PackAssetUploadComplete`](#operation/packAssetUploadComplete) endpoint.
    - `filename` string, required — The filename for the image.
    - `mimeType` string — The media type of the image being sent.
  - `exampleImages` ImageFileForUpdatePackRequest[], nullable — The example images for the Pack.
    - `assetId` string, required — The asset id of the Pack's image, returned by [`#PackAssetUploadComplete`](#operation/packAssetUploadComplete) endpoint.
    - `filename` string, required — The filename for the image.
    - `mimeType` string — The media type of the image being sent.
  - `agentImages` ImageFileForUpdatePackRequest[], nullable — The agent images for the Pack.
    - `assetId` string, required — The asset id of the Pack's image, returned by [`#PackAssetUploadComplete`](#operation/packAssetUploadComplete) endpoint.
    - `filename` string, required — The filename for the image.
    - `mimeType` string — The media type of the image being sent.
  - `sourceCodeVisibility` 'private' | 'shared' — Visibility of a Pack's source code.
  - `packEntrypoints` PackEntrypoint[], nullable — Pack entrypoints where this Pack is available
  - `name` string — The name of the Pack.
  - `description` string — The full description of the Pack.
  - `shortDescription` string — A short version of the description of the Pack.
  - `agentShortDescription` string — A short description for the Pack as an agent.
  - `agentDescription` string — A full description for the Pack as an agent.
  - `supportEmail` string — A contact email for the Pack.
  - `termsOfServiceUrl` string, url — A Terms of Service URL for the Pack.
  - `privacyPolicyUrl` string, url — A Privacy Policy URL for the Pack.

## Response `200`

Info about the Pack that was just updated.

- Pack — Details about a Pack.
  - `id` number, required — ID of the Pack.
  - `logoUrl` string, url — The link to the logo of the Pack.
  - `coverUrl` string, url — The link to the cover photo of the Pack.
  - `exampleImages` PackImageFile[] — The example images for the Pack.
    - `filename` string, required — The name of the image file.
    - `imageUrl` string, url, required — The URL to the image file.
    - `assetId` string, required — The asset id of the Pack's image.
    - `altText` string — The alt text for the image.
    - `mimeType` string — The media type of the image.
  - `agentImages` PackImageFile[] — The agent images for the Pack.
    - `filename` string, required — The name of the image file.
    - `imageUrl` string, url, required — The URL to the image file.
    - `assetId` string, required — The asset id of the Pack's image.
    - `altText` string — The alt text for the image.
    - `mimeType` string — The media type of the image.
  - `workspaceId` string, required — The parent workspace for the Pack.
  - `categories` PublishingCategory[], required — Publishing categories associated with this Pack.
    - `categoryId` string, required — The ID for this category.
    - `categoryName` string, required — The name of the category.
    - `categorySlug` string — The URL identifier of the category.
  - `certified` boolean — Denotes if the Pack is certified by Superhuman.
  - `certifiedAgent` boolean — Denotes if the Pack is certified by Grammarly to be optimized for agent usage.
  - `sourceCodeVisibility` 'private' | 'shared' — Visibility of a Pack's source code.
  - `packEntrypoints` PackEntrypoint[] — Pack entrypoints where this Pack is available
  - `verifiedVersion` string — The latest released Pack version that has been verified (approved) for use. For agent Packs, this is the most recent release that passed review. For non-agent Packs or legacy releases, this is the most recent release.
  - `name` string, required — The name of the Pack.
  - `description` string, required — The full description of the Pack.
  - `shortDescription` string, required — A short version of the description of the Pack.
  - `agentShortDescription` string — A short description for the Pack as an agent.
  - `agentDescription` string — A full description for the Pack as an agent.
  - `supportEmail` string — A contact email for the Pack.
  - `termsOfServiceUrl` string, url — A Terms of Service URL for the Pack.
  - `privacyPolicyUrl` string, url — A Privacy Policy URL for the Pack.
  - `overallRateLimit` PackRateLimit — Rate limit in Pack settings.
    - `intervalSeconds` integer, required — The rate limit interval in seconds.
    - `operationsPerInterval` integer, required — The maximum number of Pack operations that can be performed in a given interval.
  - `perConnectionRateLimit` PackRateLimit — Rate limit in Pack settings.
    - `intervalSeconds` integer, required — The rate limit interval in seconds.
    - `operationsPerInterval` integer, required — The maximum number of Pack operations that can be performed in a given interval.
  - `featuredDocStatus` 'docInaccessibleOrDoesNotExist' | 'invalidPublishedDocUrl' — Status of featured doc in Pack listing.
  - `additionalInformation` PackListingAdditionalInformation — Additional information saved with the Pack listing draft
    - `privacyCollectsPersonalInfo` boolean, nullable — Whether the agent or third-party partners collect personal information.
    - `privacyPersonalInfoCategories` string[], nullable — Categories of personal information collected by the agent.
    - `privacyDataUsagePurposes` string[], nullable — Purposes for which collected data is used by the agent or third-party partners.
    - `privacyDataCollectedBy` string[], nullable — Whether data is collected by the developer, a third party, or both.

## Other responses

- `400` — The request parameters did not conform to expectations.
- `401` — The API token is invalid or has expired.
- `403` — The API token does not grant access to this resource.
- `404` — The resource could not be located with the current API token.
- `429` — The client has sent too many requests.

---

[API](https://skmtc.net/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.net/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coda/superhuman-docs-api/versions/c65a8418f3c8/schema)
