v1

latestOpenAPI 3.0.0Superhuman Developer Terms2026-08-06124404444.0 KB
Packs

List Packs

Get the list of accessible Packs.

get/packs

Query parameters

accessType'none' | 'view' | 'test' | 'edit' | 'admin'

Deprecated, use accessTypes instead. Filter to only return the Packs for which the current user has this access type

accessTypesPackAccessType[]

Filter to only return the Packs for which the current user has these access types.

sortBy'title' | 'createdAt' | 'updatedAt'

Determines how the Packs returned are sorted.

The sort order of the Packs returned.

limitinteger

Maximum number of results to return in this query.

direction'ascending' | 'descending'

Direction of a sort for a table or view.

Direction to sort results in.

pageTokenstring

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

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

excludePackCategoriesPackCategoryType[]

Exclude Packs of one or more category types. Categories not listed stay visible.

Response

List of Pack summaries.

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