signals

Run a private scout variant

Run a prompt, model, or effort variant against live data with private memory and report capture.

post/api/projects/{project_id}/signals/scout/configs/{id}/trial/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/signals/scout/configs/{id}/trial/
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

A UUID string identifying this Signal scout config.

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

launch_idstring uuid required

Unique launch ID. Reuse it only when retrying this exact request.

context_idstring uuid

Saved starting context from a previous launch in this comparison.

variantstring

Operator label for this variant.

skill_bodystring

Replacement skill body for this run. Supporting files and tool permissions stay pinned.

modelstring

Model identifier for this run.

reasoning_effortstring

Reasoning effort supported by the selected model. Required when the saved source has no pinned effort.

notestring

Common investigation note, saved before applying any variant overrides.

Response

launch_idstring uuid required

Retry-stable launch identity.

context_idstring uuid required

Starting context to reuse across variants and repetitions.

workflow_idstring required

Workflow dispatch identity.

modelstring required

Resolved model identifier.

reasoning_effortstring required

Resolved reasoning effort.

variantstring required

Operator label for this variant.

Changes

No recorded changes to this operation across all 1 revision of this API.