Sign in

v1

latestOpenAPI 3.0.0Superhuman Developer Terms2026-08-06124404444.0 KB
Packs

Update Pack

Update an existing Pack for non-versioned fields.

patch/packs/{packId}

Path parameters

packIdinteger required

ID of a Pack

Request body

sourceCodeVisibility'private' | 'shared'

Visibility of a Pack's source code.

packEntrypointsPackEntrypoint[] nullable

Pack entrypoints where this Pack is available

namestring

The name of the Pack.

descriptionstring

The full description of the Pack.

shortDescriptionstring

A short version of the description of the Pack.

agentShortDescriptionstring

A short description for the Pack as an agent.

agentDescriptionstring

A full description for the Pack as an agent.

supportEmailstring

A contact email for the Pack.

termsOfServiceUrlstring url

A Terms of Service URL for the Pack.

privacyPolicyUrlstring url

A Privacy Policy URL for the Pack.

Example request

{
  "overallRateLimit": {
    "intervalSeconds": 3600,
    "operationsPerInterval": 20
  },
  "perConnectionRateLimit": {
    "intervalSeconds": 3600,
    "operationsPerInterval": 20
  },
  "logo": {
    "mimeType": "image/jpeg"
  },
  "cover": {
    "mimeType": "image/jpeg"
  },
  "exampleImages": [
    {
      "mimeType": "image/jpeg"
    }
  ],
  "agentImages": [
    {
      "mimeType": "image/jpeg"
    }
  ],
  "name": "Cool Geometry Formulas",
  "description": "This Pack allows users to calculate the surface area and volume of a few common 3D shapes, like cubes and pyramids.",
  "shortDescription": "Calculate cool geometric formulas like surface area.",
  "agentShortDescription": "Chat with a tool that can calculate cool geometric formulas like surface area.",
  "agentDescription": "Chat with a comprehensive tool that can calculate cool geometric formulas like surface area, volume, and other mathematical operations. This agent can help with complex calculations and provide detailed explanations.",
  "supportEmail": "user@email.com"
}

Response

Info about the Pack that was just updated.

idnumber required

ID of the Pack.

logoUrlstring url

The link to the logo of the Pack.

coverUrlstring url

The link to the cover photo of the Pack.

workspaceIdstring required

The parent workspace for the Pack.

certifiedboolean

Denotes if the Pack is certified by Superhuman.

certifiedAgentboolean

Denotes if the Pack is certified by Grammarly to be optimized for agent usage.

sourceCodeVisibility'private' | 'shared'

Visibility of a Pack's source code.

packEntrypointsPackEntrypoint[]

Pack entrypoints where this Pack is available

verifiedVersionstring

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.

namestring required

The name of the Pack.

descriptionstring required

The full description of the Pack.

shortDescriptionstring required

A short version of the description of the Pack.

agentShortDescriptionstring

A short description for the Pack as an agent.

agentDescriptionstring

A full description for the Pack as an agent.

supportEmailstring

A contact email for the Pack.

termsOfServiceUrlstring url

A Terms of Service URL for the Pack.

privacyPolicyUrlstring url

A Privacy Policy URL for the Pack.

featuredDocStatus'docInaccessibleOrDoesNotExist' | 'invalidPublishedDocUrl'

Status of featured doc in Pack listing.

Example response

{
  "id": 1003,
  "exampleImages": [
    {
      "mimeType": "image/jpeg"
    }
  ],
  "agentImages": [
    {
      "mimeType": "image/jpeg"
    }
  ],
  "workspaceId": "ws-asdf",
  "categories": [
    {
      "categoryId": "aBCdEFg",
      "categoryName": "Project management",
      "categorySlug": "project-management"
    }
  ],
  "verifiedVersion": "1.0.0",
  "name": "Cool Geometry Formulas",
  "description": "This Pack allows users to calculate the surface area and volume of a few common 3D shapes, like cubes and pyramids.",
  "shortDescription": "Calculate cool geometric formulas like surface area.",
  "agentShortDescription": "Chat with a tool that can calculate cool geometric formulas like surface area.",
  "agentDescription": "Chat with a comprehensive tool that can calculate cool geometric formulas like surface area, volume, and other mathematical operations. This agent can help with complex calculations and provide detailed explanations.",
  "supportEmail": "user@email.com",
  "overallRateLimit": {
    "intervalSeconds": 3600,
    "operationsPerInterval": 20
  },
  "perConnectionRateLimit": {
    "intervalSeconds": 3600,
    "operationsPerInterval": 20
  }
}