--- title: "Get detailed listing information for a Pack." method: GET path: "/packs/{packId}/listing" tags: ["Packs"] --- # Get detailed listing information for a Pack. `GET /packs/{packId}/listing` Get detailed listing information for a Pack. ## Path parameters - `packId` integer, required ## Query parameters - `workspaceId` string - `docId` string - `ingestionId` string - `installContext` 'workspace' | 'doc' — Type of context in which a Pack is being installed. - `releaseChannel` 'LIVE' | 'LATEST' — Live or Latest version of Pack ## Response `200` The Pack listing detail. - PackListingDetail — A detailed Pack listing. - `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. - `discoverability` 'public' | 'nomosOrganization' | 'group' | 'grammarlyInstitution' | 'workspace' | 'private', required — Widest principal a Pack is available to. - `userAccess` PackUserAccess, required — The access capabilities the current user has for this Pack. - `canEdit` boolean, required - `canTest` boolean, required - `canView` boolean, required - `canInstall` boolean, required - `canPurchase` boolean, required - `requiresTrial` boolean, required - `canConnectAccount` boolean, required - `organization` union - PackOrganizationAccessForDocs — Describes restrictions that a user's organization has placed on a Pack - `canRequestAccess` boolean, required - `hasRequestedAccess` boolean, required - `requiresConfiguration` boolean, required - `allowedConfigurations` PackConfigurationEntry[] - `configurationId` string, required - `name` string, required — Name of the configuration - `policy` object — Policy associated with the configuration - `hasSharedConnection` boolean — Whether an org-wide shared connection (client-credentials auth configured once per org) already exists for this configuration. Only meaningful for Packs that support a shared connection; absent/false otherwise. Lets clients determine whether a member can skip the personal-connection step for this configuration. - `allowedPackIds` number[] - `incompatibleDocPermissions` Permission[] - `principal` union, required — Metadata about a principal. - object - … - object - … - object - … - object - … - object - … - object - … - `id` string, required — Id for the Permission - `access` 'readonly' | 'write' | 'comment' | 'none', required — Type of access. - `incompatibleDocOwner` UserSummary — Summary about the user. - `name` string, required — Name of the user. - `loginId` string, required — Email address of the user. - `type` 'user', required — The type of this resource. - `pictureLink` string, url — Browser-friendly link to the user's avatar image. - `incompatibleDocFolder` FolderReference — Reference to a Superhuman Docs folder. - `id` string, required — ID of the Superhuman Docs folder. - `type` 'folder', required — The type of this resource. - `browserLink` string, url, required — Browser-friendly link to the folder. - `name` string — Name of the folder; included if the user has access to the folder. - `isDocOwner` boolean - PackOrganizationAccessForCodaBrain — Describes restrictions that a user's organization has placed on a Pack for Coda Brain ingestions - `canRequestAccess` boolean, required - `hasRequestedAccess` boolean, required - `requiresConfiguration` boolean, required - `allowedConfigurations` PackConfigurationEntry[] - `configurationId` string, required - `name` string, required — Name of the configuration - `policy` object — Policy associated with the configuration - `hasSharedConnection` boolean — Whether an org-wide shared connection (client-credentials auth configured once per org) already exists for this configuration. Only meaningful for Packs that support a shared connection; absent/false otherwise. Lets clients determine whether a member can skip the personal-connection step for this configuration. - `allowedPackIds` number[] - `ingestionLimitSettings` IngestionLimitSettings — Limits for a Pack-driven ingestion - `tableSettings` object — Map from table name to per table settings. This may not include every table in the Pack. Each setting per table will include an optional maxBytesPerSyncTableOverride that will override the default, an optional excludeIngestionByDefault flag, and an optional parameterLimits dictionary of allowed parameter values. - `maxBytesPerSyncTableDefault` number, nullable, required — The default bytes limit when ingesting data for a table in the Pack. null means no limit. - `allowedTablesCount` number, required — The maximum number of tables that can be included. -1 means no limit. - `codaHelpCenterUrl` string — The URL of a Superhuman Docs Help Center article with documentation about the Pack. This will only exist for select Superhuman Docs-authored Packs. - `configuration` PackConfigurationEntry — Basic details about a configuration that can be used in conjunction with a Pack - `configurationId` string, required - `name` string, required — Name of the configuration - `policy` object — Policy associated with the configuration - `hasSharedConnection` boolean — Whether an org-wide shared connection (client-credentials auth configured once per org) already exists for this configuration. Only meaningful for Packs that support a shared connection; absent/false otherwise. Lets clients determine whether a member can skip the personal-connection step for this configuration. ## 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/versions/c65a8418f3c8/schema)