> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Dlq Entries > List Dead Letter Queue entries for a sync configuration. Returns objects that failed to sync after all retry attempts. Each entry includes the source object ID, error details, retry count, and timestamps. Use this to diagnose and resolve sync failures. ## OpenAPI ````yaml post /v1/buckets/{bucket_id}/syncs/{sync_config_id}/dlq openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: - BearerAuth: [] paths: /v1/buckets/{bucket_id}/syncs/{sync_config_id}/dlq: post: tags: - Bucket Syncs summary: List Dlq Entries description: |- List Dead Letter Queue entries for a sync configuration. Returns objects that failed to sync after all retry attempts. Each entry includes the source object ID, error details, retry count, and timestamps. Use this to diagnose and resolve sync failures. operationId: list_dlq_entries_v1_buckets__bucket_id__syncs__sync_config_id__dlq_post parameters: - name: bucket_id in: path required: true schema: type: string title: Bucket Id - name: sync_config_id in: path required: true schema: type: string title: Sync Config Id requestBody: content: application/json: schema: $ref: '#/components/schemas/ListDLQRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/DLQListResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] NamespaceHeader: [] components: schemas: ListDLQRequest: properties: only_max_retries: anyOf: - type: boolean - type: 'null' title: Only Max Retries description: If True, only return entries that exhausted all retries. default: false error_types: anyOf: - items: type: string type: array - type: 'null' title: Error Types description: >- Filter by error type names, e.g. ['NotFoundError', 'ValidationError']. type: object title: ListDLQRequest description: Request to list Dead Letter Queue entries for a sync configuration. DLQListResponse: properties: results: items: $ref: '#/components/schemas/SyncDeadLetterObjectModel' type: array title: Results total: type: integer title: Total type: object required: - results - total title: DLQListResponse description: List of DLQ entries for a sync configuration. ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SyncDeadLetterObjectModel: properties: dlq_id: type: string title: Dlq Id description: Unique identifier for the DLQ entry sync_config_id: type: string title: Sync Config Id description: ID of the sync configuration that failed sync_job_id: anyOf: - type: string - type: 'null' title: Sync Job Id description: ID of the sync job where failure occurred source_object_id: type: string title: Source Object Id description: Provider's native ID for the failed object source_path: anyOf: - type: string - type: 'null' title: Source Path description: Path to the object in the source system error_type: type: string title: Error Type description: Type of error (validation_error, download_failed, schema_mismatch) error_message: type: string title: Error Message description: Human-readable error message error_stack_trace: anyOf: - type: string - type: 'null' title: Error Stack Trace description: Full stack trace for debugging first_seen_at: type: string format: date-time title: First Seen At description: When object first failed last_seen_at: type: string format: date-time title: Last Seen At description: When object last failed retry_count: type: integer minimum: 0 title: Retry Count description: Number of retry attempts default: 0 max_retries_reached: type: boolean title: Max Retries Reached description: Whether max retries have been exhausted default: false requeued_at: anyOf: - type: string format: date-time - type: 'null' title: Requeued At description: When user manually requeued this object resolved_at: anyOf: - type: string format: date-time - type: 'null' title: Resolved At description: When object was successfully processed after requeue disposal_reason: anyOf: - type: string - type: 'null' title: Disposal Reason description: >- BACKE-2979: why the retry task permanently retired this entry (sync_config_not_found, sync_config_deactivated, connection_not_found) — set alongside max_retries_reached so stale entries stop being re-walked every run internal_id: type: string title: Internal Id description: Organization internal identifier (multi-tenancy scope) namespace_id: type: string title: Namespace Id description: Namespace identifier bucket_id: type: string title: Bucket Id description: Target bucket identifier type: object required: - sync_config_id - source_object_id - error_type - error_message - internal_id - namespace_id - bucket_id title: SyncDeadLetterObjectModel description: >- Objects that failed sync after all retries. This model tracks objects that permanently failed during sync operations. After MAX_RETRIES attempts, objects are placed here for manual review/requeue. ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: >- Mixpeek API key, sent as `Authorization: Bearer mxp_sk_...`. Create one in Studio under Settings → API Keys, or with an admin key via `POST /v1/organizations/users/{user_email}/api-keys`. A missing header returns 403; an invalid or revoked key returns 401. NamespaceHeader: type: apiKey in: header name: X-Namespace description: >- Namespace id (`ns_...`), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked `x-mixpeek-namespace-scoped`. ````