list_messages
Retrieve and filter messages from Carbon Voice using date ranges, user IDs, conversation IDs, or folders. Access presigned URLs directly for seamless usage, with options to sort and paginate results.
Instructions
List Messages. By default returns latest 20 messages. The maximum allowed range between dates is 183 days (6 months). All presigned URLs returned by this tool are ready to use. Do not parse, modify, or re-encode them—always present or use the URLs exactly as received.If you want to get messages from a specific date range, you can use the "start_date" and "end_date" parameters. If you want to get messages from a specific date, you can use the "date" parameter. If you want to get messages from a specific user, you can use the "user_ids" parameter. If you want to get messages from a specific conversation, you can use the "conversation_id" parameter. If you want to get messages from a specific folder, you can use the "folder_id" parameter. If you want to get messages from a specific workspace, you can use the "workspace_id" parameter. If you want to get messages for a particular language, you can use the "language" parameter.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| conversation_id | No | Conversation ID (optional) | |
| end_date | No | End Date range | |
| folder_id | No | Folder ID (optional) | |
| language | No | Language (optional) | |
| page | No | ||
| size | No | Max number of results per page is: **50** | |
| sort_direction | No | The field used to sort results is **Creation Date** | DESC |
| start_date | No | Start Date range | |
| type | No | Type (optional) | |
| user_ids | No | User IDs (optional). List of user IDs to filter messages by. If not provided, all users will be included. | |
| workspace_id | No | Workspace ID (optional) |