--- title: "List the Pack listings accessible to a user." method: GET path: "/packs/listings" tags: ["Packs"] --- # List the Pack listings accessible to a user. `GET /packs/listings` Get listings of public Packs and Packs created by you. ## Query parameters - `packAccessTypes` PackAccessType[] — Access types for a Pack. - `packIds` integer[] - `onlyWorkspaceId` string - `parentWorkspaceIds` string[] - `excludePublicPacks` boolean - `packEntrypoint` 'go' | 'docs' - `certifiedAgentsOnly` boolean - `packCategories` PackCategoryType[] - `sortBy` 'packId' | 'name' | 'packVersion' | 'packVersionModifiedAt' | 'agentDirectorySort' — Determines how the Pack listings returned are sorted. - `orderBy` 'packId' | 'name' | 'packVersion' | 'packVersionModifiedAt' | 'agentDirectorySort' — Determines how the Pack listings returned are sorted. - `direction` 'ascending' | 'descending' — Direction of a sort for a table or view. - `limit` integer - `pageToken` string - `installContext` 'workspace' | 'doc' — Type of context in which a Pack is being installed. ## Response `200` Public Pack listings and Pack listings created by you. - PackListingList — A list of Pack listings. - `items` PackListing[], required - `packId` number, required — ID of the Pack. - `packVersion` string, required — The version of the Pack. - `releaseId` number — The current release number of the Pack if released, otherwise undefined. - `lastReleasedAt` string, date-time — The timestamp of the latest release of this Pack. - `logoUrl` string, url, required — The link to the logo of the Pack. - `logo` PackImageFile, required — A Pack image file. - `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. - `coverUrl` string, url — The link to the cover photo of the Pack. - `cover` PackImageFile — A Pack image file. - `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. - `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. - `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. - `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. - `makers` MakerSummary[], required — Makers associated with this Pack. - `name` string, required — Name of the maker. - `pictureLink` string, url — Browser-friendly link to the maker's avatar image. - `slug` string — Maker profile identifier for the maker. - `jobTitle` string — Job title for maker. - `employer` string — Employer for maker. - `description` string — Description for the maker. - `certified` boolean — Denotes if the Pack is certified by Superhuman. - `certifiedAgent` boolean — 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. - `externalMetadataUrl` string, required — The URL where complete metadata about the contents of the Pack version can be downloaded. - `standardPackPlan` StandardPackPlan — The Pack plan to show the Pack can be subscribed to at a monthly cost per Doc Maker or for free. - `packPlanId` string, required - `packId` number, required - `pricing` union, required — Pricing to show how workspaces can subscribe to the Pack. - FreePackPlanPricing — Pricing used when workspaces can subscribe to the Pack for free. - `type` 'Free', required - MonthlyDocMakerPackPlanPricing — Pricing used when workspaces can subscribe to the Pack for a monthly cost per Doc Maker. - `type` 'MonthlyDocMaker', required - `amount` number, required — The monthly cost of the Pack per Doc Maker. - `currency` 'USD', required — Currency needed to subscribe to the Pack. - `createdAt` string, date-time, required — Timestamp for when the Pack plan was created. - `bundledPackPlan` BundledPackPlan — The Pack plan to show the Pack can be accessed if the workspace is at least the given tier. - `packPlanId` string, required - `packId` number, required - `pricing` BundledPackPlanPricing, required — Pricing used when workspaces have access to the Pack for free if their workspace is at least the given tier. - `type` 'BundledWithTier', required - `minimumFeatureSet` 'Pro' | 'Team' | 'Enterprise', required — Workspace feature set excluding free. - `createdAt` string, date-time, required — Timestamp for when the Pack plan was created. - `sourceCodeVisibility` 'private' | 'shared' — Visibility of a Pack's source code. - `sdkVersion` string, required — What Packs SDK version was this version built on. - `packCategoryType` 'connector' | 'agent' | 'customAgent', required — The category of a Pack. - `nextPageToken` string — If specified, an opaque token used to fetch the next page of results. - `nextPageLink` string, url — If specified, a link that can be used to fetch the next page of results. ## 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/revisions/c65a8418f3c8/schema)