--- title: "Retrieve the grouped logs of a Pack for a specific ingestionExecutionId." method: GET path: "/packs/{packId}/tenantId/{tenantId}/rootIngestionId/{rootIngestionId}/groupedLogs" tags: ["Packs"] --- # Retrieve the grouped logs of a Pack for a specific ingestionExecutionId. `GET /packs/{packId}/tenantId/{tenantId}/rootIngestionId/{rootIngestionId}/groupedLogs` Retrieve the grouped logs of a Pack for debugging purpose. ## Path parameters - `packId` integer, required - `tenantId` string, required - `rootIngestionId` string, uuid, required ## Query parameters - `limit` integer - `pageToken` string - `ingestionExecutionId` string, uuid - `beforeTimestamp` string, date-time - `afterTimestamp` string, date-time - `order` 'asc' | 'desc' - `q` string ## Response `200` Grouped Pack logs. - GroupedPackLogsList — List of grouped Pack logs. - `items` GroupedPackLog[], required - union — A record of grouped Pack log. - object — Grouped logs of the invocations of the Pack. - `type` 'invocation', required - `invocationLog` PackInvocationLog, required — System logs of the invocations of the Pack. - `type` 'invocation', required - `context` PackLogContext, required — Logging context that comes with a Pack log. - `docId` string, required - `packId` string, required - `packVersion` string, required - `formulaName` string, required - `userId` string, required - `connectionId` string, required - `connectionName` string - `requestId` string, required — A unique identifier of the Pack invocation that can be used to associate all log types generated in one call of a Pack formula. - `requestType` 'unknown' | 'connectionNameMetadataRequest' | 'parameterAutocompleteMetadataRequest' | 'postAuthSetupMetadataRequest' | 'propertyOptionsMetadataRequest' | 'getSyncTableSchemaMetadataRequest' | 'getDynamicSyncTableNameMetadataRequest' | 'listSyncTableDynamicUrlsMetadataRequest' | 'searchSyncTableDynamicUrlsMetadataRequest' | 'getDynamicSyncTableDisplayUrlMetadataRequest' | 'getIdentifiersForConnectionRequest' | 'invokeFormulaRequest' | 'invokeSyncFormulaRequest' | 'invokeSyncUpdateFormulaRequest' | 'invokeExecuteGetPermissionsRequest' | 'validateParametersMetadataRequest' | 'mcp', required — The context request type where a Pack log is generated. - `createdAt` string, date-time, required — Creation time of the log. - `logId` string, required — Unique identifier of this log record. - `docObjectId` string — Doc canvas object id where the formula was fired from. - `docRowId` string — Doc canvas row id where the formula was fired from. - `docColumnId` string — Doc canvas column id where the formula was fired from. - `isSyncTable` boolean — True if this is a formula invocation loading a page of a sync table, or metadata for a sync table (like creating a dynamic schema). - `isContinuedSyncTable` boolean — True if this is an execution of a sync table which received a pagination parameter. - `autocompleteParameterName` string — If this formula invocation was for a parameter auto-complete, this names the parameter. - `invocationSource` string — If this formula was invoked by something other than a user action, this should say what that was. - `detailsKey` string, required — Key to be used in fetching log details. - `ingestionChildExecutionIndex` number — Child execution id for this ingestion log. - `ingestionId` string — Unique identifier of the ingestion that triggered this log. - `rootIngestionId` string — Unique identifier of the root ingestion that triggered this log. - `ingestionExecutionId` string — Unique identifier of the ingestion execution that triggered this log. - `ingestionStage` string — Stage along the ingestion lifecycle that this log was created in. - `ingestionParentStage` string — An ingestion lifecycle stage that this ingestion log is bundled under. - `ingestionExecutionAttempt` integer — Execution attempt for this ingestion log. - `ingestionParentItemId` string — Parent item id for this ingestion log. - `ingestionProcessId` string — Unique identifier of the ingestion processing call that triggered this log. - `additionalMetadata` object — Additional metadata for the ingestion log. - `agentSessionId` string — Agent chat session id. - `agentInstanceId` string — Agent instance id. - `executingAgentInstanceId` string — Executing agent instance id. - `cacheHit` boolean — True if the formula returned a prior result without executing. - `duration` number — Duration of the formula exeuction in miliseconds. - `error` object — Error info if this invocation resulted in an error. - `message` string, required - `stack` string - `relatedLogs` PackLog[], required - union — A record of Pack log. - object — Pack log generated by developer's custom logging with context.logger. - … - object — System logs of the invocations of the Pack. - … - object — System logs of Pack calls to context.fetcher. - … - object — Superhuman Docs internal logs from the Packs infrastructure. Only visible to Superhuman employees. - … - object — System logs of Pack authentication requests. - … - object — Pack log generated by an executing ingestion. - … - object — Pack log generated by an executing ingestion. Contains metadata helpful for debugging - … - object — Pack log generated by an executing agent runtime. - … - object — Pack log generated by an MCP (Model Context Protocol) operation. - … - object — Grouped logs of the Pack's auth requests. - `type` 'auth', required - `authLog` PackAuthLog, required — System logs of Pack authentication requests. - `type` 'auth', required - `context` PackLogContext, required — Logging context that comes with a Pack log. - `docId` string, required - `packId` string, required - `packVersion` string, required - `formulaName` string, required - `userId` string, required - `connectionId` string, required - `connectionName` string - `requestId` string, required — A unique identifier of the Pack invocation that can be used to associate all log types generated in one call of a Pack formula. - `requestType` 'unknown' | 'connectionNameMetadataRequest' | 'parameterAutocompleteMetadataRequest' | 'postAuthSetupMetadataRequest' | 'propertyOptionsMetadataRequest' | 'getSyncTableSchemaMetadataRequest' | 'getDynamicSyncTableNameMetadataRequest' | 'listSyncTableDynamicUrlsMetadataRequest' | 'searchSyncTableDynamicUrlsMetadataRequest' | 'getDynamicSyncTableDisplayUrlMetadataRequest' | 'getIdentifiersForConnectionRequest' | 'invokeFormulaRequest' | 'invokeSyncFormulaRequest' | 'invokeSyncUpdateFormulaRequest' | 'invokeExecuteGetPermissionsRequest' | 'validateParametersMetadataRequest' | 'mcp', required — The context request type where a Pack log is generated. - `createdAt` string, date-time, required — Creation time of the log. - `logId` string, required — Unique identifier of this log record. - `docObjectId` string — Doc canvas object id where the formula was fired from. - `docRowId` string — Doc canvas row id where the formula was fired from. - `docColumnId` string — Doc canvas column id where the formula was fired from. - `isSyncTable` boolean — True if this is a formula invocation loading a page of a sync table, or metadata for a sync table (like creating a dynamic schema). - `isContinuedSyncTable` boolean — True if this is an execution of a sync table which received a pagination parameter. - `autocompleteParameterName` string — If this formula invocation was for a parameter auto-complete, this names the parameter. - `invocationSource` string — If this formula was invoked by something other than a user action, this should say what that was. - `detailsKey` string, required — Key to be used in fetching log details. - `ingestionChildExecutionIndex` number — Child execution id for this ingestion log. - `ingestionId` string — Unique identifier of the ingestion that triggered this log. - `rootIngestionId` string — Unique identifier of the root ingestion that triggered this log. - `ingestionExecutionId` string — Unique identifier of the ingestion execution that triggered this log. - `ingestionStage` string — Stage along the ingestion lifecycle that this log was created in. - `ingestionParentStage` string — An ingestion lifecycle stage that this ingestion log is bundled under. - `ingestionExecutionAttempt` integer — Execution attempt for this ingestion log. - `ingestionParentItemId` string — Parent item id for this ingestion log. - `ingestionProcessId` string — Unique identifier of the ingestion processing call that triggered this log. - `additionalMetadata` object — Additional metadata for the ingestion log. - `agentSessionId` string — Agent chat session id. - `agentInstanceId` string — Agent instance id. - `executingAgentInstanceId` string — Executing agent instance id. - `path` string, required — The request path. - `errorMessage` string — The error message. - `errorStack` string — The error stacktrace (internal only). - `relatedLogs` PackLog[], required - union — A record of Pack log. - object — Pack log generated by developer's custom logging with context.logger. - … - object — System logs of the invocations of the Pack. - … - object — System logs of Pack calls to context.fetcher. - … - object — Superhuman Docs internal logs from the Packs infrastructure. Only visible to Superhuman employees. - … - object — System logs of Pack authentication requests. - … - object — Pack log generated by an executing ingestion. - … - object — Pack log generated by an executing ingestion. Contains metadata helpful for debugging - … - object — Pack log generated by an executing agent runtime. - … - object — Pack log generated by an MCP (Model Context Protocol) operation. - … - `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. - `incompleteRelatedLogs` boolean, required — This flag will be set to true if the result doens't include all the related logs. ## 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)