Create Bulk Agent Response Logs

This endpoint is used to save multiple chat interactions in bulk by fetching logs from a shared thread.
Supports partial success - some logs may succeed while others fail.

Staging behaviour:

Pass agent_version=staging as a query parameter to bulk-log responses against the staging version instead of the published agent's.

Path Parameters:

agent_id: ID of the agent for which the responses are to be created.

Request Body:

share_token: The share's unique UUID token — the same one the recipient already has from the share link they were given access through (the identical value used to view the shared thread). Used to resolve write permission and the source thread/snapshot to fork from.

thread_id: ID of the destination ChatThread where new logs will be created (must belong to the requesting user)

attachment_corpus_id (optional): The ID of an existing indexing Corpus — the one already created for a file the recipient attached to their first query on the forked thread. When set, source documents are cloned INTO this corpus instead of creating a new one.

Request Headers:

X-Authorization-Consistency-Token (string, optional): Authorization consistency token for read-after-write consistency. Pass the token received from a previous write operation so the write-permission check on the share sees the latest state.

Returns:

JsonResponse: A JSON response containing the result of bulk log creation with
created_count, failed_count, a logs array, an errors array, a corpus object
(corpus_id, documents_copied, documents_failed, cloned_chunks), and an
artifacts object (copied count and any failed URLs).

Current Version:

2.0.0

curl --location --globoff 'https:///api/v2/agents//responses/log/bulk_create' \ --header 'Organization-Id;' \ --header 'Ocp-Apim-Subscription-Key: ' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "share_token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "thread_id": 99, "attachment_corpus_id": null }'

{ "success": true, "message": "Successfully created bulk response logs", "data": { "created_count": 3, "failed_count": 0, "logs": [ { "id": 501, "chat_thread_id": 99, "question": "What is AI?", "created_at": "2026-01-06T12:30:00Z" } ], "errors": [], "corpus": { "corpus_id": 555, "documents_copied": 2, "documents_failed": 0, "cloned_chunks": 40 }, "artifacts": { "copied": 1, "failed": [] } } }

Create Bulk Agent Response Logs

Request

Responses