v1

latestOpenAPI 3.0.0Superhuman Developer Terms2026-08-06124404444.0 KB

Packs

List the Pack listings accessible to a user.

Get listings of public Packs and Packs created by you.

get/packs/listings

Query parameters

packAccessTypesPackAccessType[]

Access types for a Pack.

Pack access types.

packIdsinteger[]

Which Pack IDs to fetch.

onlyWorkspaceIdstring

Use only this workspace (not all of a user's workspaces) to check for Packs shared via workspace ACL.

parentWorkspaceIdsstring[]

Filter to only Packs whose parent workspace is one of the given IDs.

excludePublicPacksboolean

Only get Packs shared with users/workspaces, not publicly.

packEntrypoint'go' | 'docs'

Entrypoint for which this Pack call is being made. Used to filter non relevant Packs

certifiedAgentsOnlyboolean

Only include Packs that are certified for agent use. Depending on server configuration, may also include Packs that the user is an admin of.

packCategoriesPackCategoryType[]

Filter Packs by one or more category types.

sortBy'packId' | 'name' | 'packVersion' | 'packVersionModifiedAt' | 'agentDirectorySort'

Determines how the Pack listings returned are sorted.

Specify a sort order for the returned Pack listings returned.

orderBy'packId' | 'name' | 'packVersion' | 'packVersionModifiedAt' | 'agentDirectorySort'

Determines how the Pack listings returned are sorted.

Deprecated: use sortBy instead.

direction'ascending' | 'descending'

Direction of a sort for a table or view.

Direction to sort results in.

limitinteger

Maximum number of results to return in this query.

pageTokenstring

An opaque token used to fetch the next page of results.

installContext'workspace' | 'doc'

Type of context in which a Pack is being installed.

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

Response

Public Pack listings and Pack listings created by you.

nextPageTokenstring

If specified, an opaque token used to fetch the next page of results.

nextPageLinkstring url

If specified, a link that can be used to fetch the next page of results.

Example response

{
  "items": [
    {
      "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"
    }
  ],
  "nextPageToken": "eyJsaW1pd",
  "nextPageLink": "https://docs.superhuman.com/apis/v1/packs/listings?pageToken=xyz"
}