v1

latestOpenAPI 3.0.0Superhuman Developer Terms2026-08-06124404444.0 KB
Packs

Get detailed listing information for a Pack.

Get detailed listing information for a Pack.

get/packs/{packId}/listing

Path parameters

packIdinteger required

ID of a Pack

Query parameters

workspaceIdstring

ID of the target workspace (if applicable) for checking installation privileges.

docIdstring

ID of the target document for checking installation privileges

ingestionIdstring

ID of the target ingestion for checking limit settings

installContext'workspace' | 'doc'

Type of context in which a Pack is being installed.

Type of installation context for which Pack information is being requested.

releaseChannel'LIVE' | 'LATEST'

Live or Latest version of Pack

Release channel for which Pack information is being requested.

Response

The Pack listing detail.

packIdnumber required

ID of the Pack.

packVersionstring required

The version of the Pack.

releaseIdnumber

The current release number of the Pack if released, otherwise undefined.

lastReleasedAtstring date-time

The timestamp of the latest release of this Pack.

logoUrlstring url required

The link to the logo of the Pack.

coverUrlstring url

The link to the cover photo of the Pack.

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.

certifiedboolean

Denotes if the Pack is certified by Superhuman.

certifiedAgentboolean

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

minimumFeatureSet'Basic' | 'Pro' | 'Team' | 'Enterprise'

Only relevant for original Superhuman Packs.

unrestrictedFeatureSet'Basic' | 'Pro' | 'Team' | 'Enterprise'

Only relevant for original Superhuman Packs.

externalMetadataUrlstring required

The URL where complete metadata about the contents of the Pack version can be downloaded.

sourceCodeVisibility'private' | 'shared'

Visibility of a Pack's source code.

sdkVersionstring required

What Packs SDK version was this version built on.

packCategoryType'connector' | 'agent' | 'customAgent' required

The category of a Pack.

discoverability'public' | 'nomosOrganization' | 'group' | 'grammarlyInstitution' | 'workspace' | 'private' required

Widest principal a Pack is available to.

codaHelpCenterUrlstring

The URL of a Superhuman Docs Help Center article with documentation about the Pack. This will only exist for select Superhuman Docs-authored Packs.

Example response

{
  "packId": 1003,
  "packVersion": "1.0.3",
  "releaseId": 2,
  "lastReleasedAt": "2018-04-11T00:18:57.946Z",
  "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",
  "categories": [
    {
      "categoryId": "aBCdEFg",
      "categoryName": "Project management",
      "categorySlug": "project-management"
    }
  ],
  "makers": [
    {
      "name": "John Doe",
      "pictureLink": "https://cdn.coda.io/avatars/default_avatar.png"
    }
  ],
  "externalMetadataUrl": "https://codahosted.io/packs/12345/1.2.3/metadata/0c892064aa5cb.json",
  "standardPackPlan": {
    "createdAt": "2018-04-11T00:18:57.946Z"
  },
  "bundledPackPlan": {
    "createdAt": "2018-04-11T00:18:57.946Z"
  },
  "sdkVersion": "1.5.1",
  "userAccess": {
    "organization": {
      "incompatibleDocPermissions": [
        {
          "principal": {
            "email": "example@domain.com"
          }
        }
      ],
      "incompatibleDocOwner": {
        "name": "John Doe",
        "loginId": "user@example.com",
        "pictureLink": "https://cdn.coda.io/avatars/default_avatar.png"
      },
      "incompatibleDocFolder": {
        "id": "fl-1Ab234",
        "browserLink": "https://docs.superhuman.com/folders/fl-1Ab234",
        "name": "My docs"
      }
    }
  }
}