Create Bulk Agent Response Logs

POST

/api/v2/agents/{agent_id}/responses/log/bulk_create

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

Request

Path Params

Header Params

Body Params

application/json

Required

Examples

Responses

🟢200OK

application/json

Success (partial success supported)

Bodyapplication/json

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Fork Shared ThreadFork With Attachment

curl --location --globoff 'https:///api/v2/agents//responses/log/bulk_create' \
--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
}'

Response Example

200 - Success Response

{
    "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": []
        }
    }
}

Stop an in-flight streaming response

Agent Response Steps