Skip to main content

List Chat Sessions

List all chat sessions for your organization.

Endpoint

Required Scopes

  • chat:read - List chat sessions

Query Parameters

Response

Examples

List Recent Sessions

With Custom Limit

Iterate Through All Sessions

Use Cases

Session Management Dashboard

Build a dashboard to track conversations:

Find Recent Session for User

Clean Up Old Sessions

Error Responses

401 Unauthorized

429 Too Many Requests

Pricing

Listing sessions is free - no token usage.

Rate Limits

Best Practices

1. Use Pagination

Limit results to avoid timeouts:

2. Cache Session List

Cache the list to reduce API calls:

3. Filter Client-Side

Use client-side filtering for better performance:

Next Steps

Retrieve Session

Get details for a specific session

Create Completion

Create a new chat completion

Rate Limiting

Understand rate limits

Error Handling

Handle errors gracefully