Get Async Chat Stream Status | PrivateGPT

Get the current status and metadata of an asynchronous chat stream.

This endpoint returns comprehensive information about a chat stream’s current state, including processing status, timestamps, error information, and additional metadata collected during processing.

Status Values:

pending: Stream created but processing not yet started
processing: Active processing with events being generated
completed: Stream finished successfully
cancelled: Stream was cancelled by user request
error: Stream encountered an error and stopped

Use Cases:

Monitor stream progress without consuming events
Check completion status before attempting to observe
Debugging failed streams via error messages
Performance monitoring through metadata

Get the current status and metadata of an asynchronous chat stream. This endpoint returns comprehensive information about a chat stream's current state, including processing status, timestamps, error information, and additional metadata collected during processing. Status Values: * pending: Stream created but processing not yet started * processing: Active processing with events being generated * completed: Stream finished successfully * cancelled: Stream was cancelled by user request * error: Stream encountered an error and stopped Use Cases: * Monitor stream progress without consuming events * Check completion status before attempting to observe * Debugging failed streams via error messages * Performance monitoring through metadata

Path parameters

message_idstringRequired

Message ID of the asynchronous chat stream to check status for.

Response

Stream status and metadata information

message_idstring

Unique identifier for the stream

statusenum

Current status of the stream

created_atdatetime

Timestamp when the stream was created

updated_atdatetime

Timestamp when the stream was last updated

completed_atdatetime or null

Timestamp when the stream was completed, if applicable

error_messagestring or null

Error message if the stream encountered an error

stream_typestringDefaults to default

Type of the stream, used for categorization

metadatamap from strings to any

Additional metadata associated with the stream

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

Get the current status and metadata of an asynchronous chat stream.

This endpoint returns comprehensive information about a chat stream’s current state, including processing status, timestamps, error information, and additional metadata collected during processing.

Status Values:

pending: Stream created but processing not yet started
processing: Active processing with events being generated
completed: Stream finished successfully
cancelled: Stream was cancelled by user request
error: Stream encountered an error and stopped

Use Cases:

Monitor stream progress without consuming events
Check completion status before attempting to observe
Debugging failed streams via error messages
Performance monitoring through metadata

1	{
2	"message_id": "msg_async_12345",
3	"status": "pending",
4	"created_at": "2025-07-10T09:11:16.003615Z",
5	"updated_at": "2025-07-10T09:11:16.003615Z",
6	"stream_type": "default",
7	"metadata": {}
8	}