--- 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` ## Request - Base URL: `https://docs.superhuman.com/apis/v1` - URL: `https://docs.superhuman.com/apis/v1/packs/{packId}/tenantId/{tenantId}/rootIngestionId/{rootIngestionId}/groupedLogs` - Auth: HTTP bearer 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.dev/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.dev/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coda/apis/superhuman-docs-api/revisions/0d58bd44abbf?raw)