Start an artifact deep dive

Admit a bounded deep-dive run over one owned artifact from the authenticated workspace.

POST/api/research/threads/{encrypted_id}/artifacts/{artifact_encrypted_id}/deep

Browser sessionAuthenticated browser session

Required boundary headers

Cookie: authenticated browser sessionIdempotency-Key

Overview

What this route does

Use this product-session mutation when an existing source artifact needs a focused follow-up. The request can select a preset and explicit run cap.

Contract

Request parameters

Request body

Only fields in this contract are accepted.

presetOptionalenum

Optional configured deep-dive preset.

max_run_cost_centsOptionalinteger

Optional cap from 1 through 100,000 cents.

Examples

Request and response

Example request

curl -X POST "https://vidbyte-backend.onrender.com/api/research/threads/rth_public_token/artifacts/rart_public_token/deep" \
  -H "Cookie: authenticated-session" \
  -H "Content-Type: application/json" \
  -d '{"preset":"complete","max_run_cost_cents":500}'

Example response

{
  "encrypted_id": "rth_public_token",
  "artifact_encrypted_id": "rart_public_token",
  "status": "accepted"
}

Response

Response and errors

Returns 202 Accepted with encrypted thread and artifact tokens plus status.
Deep-dive execution remains bounded by the accepted cap and preset policy.