FruxonDocs
Agent NetworkTriggers

Confirms a sampled cohort's estimate, and lets the rest of it run.

A sampled cohort ran its first items for real and admits nothing more until someone confirms what the rest is projected to cost. Confirming resumes admission, raises the budgets of the platform-managed agents it runs on to cover the projection (put back when the cohort settles), lets a paused automation work through it, and starts a pass now. Pass the `estimate.hash` you were shown; 409 if the estimate has changed since, or the cohort is not awaiting confirmation.

POST
/v1/tenants/{tenant}/triggers/{trigger}/ledger/cohorts/{cohort}:confirm
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

trigger*string

The trigger identifier.

Formatuuid
cohort*string

The cohort identifier.

Formatuuid
tenant*string

The tenant identifier

The estimate hash.

estimateHash?string|null

The hash of the estimate the person read.

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/triggers/497f6eca-6276-4993-bfeb-53cbbbba6f08/ledger/cohorts/497f6eca-6276-4993-bfeb-53cbbbba6f08:confirm" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "key": "string",
  "source": "DOOR",
  "name": "string",
  "status": "OPEN",
  "openedBy": "string",
  "createdAt": 0,
  "sealedAt": 0,
  "settleBy": 0,
  "settledAt": 0,
  "completedAt": 0,
  "partial": false,
  "sampleSize": 0,
  "confirmedAt": 0,
  "confirmedBy": "string",
  "detail": "string",
  "progress": {
    "members": 0,
    "live": 0,
    "done": 0,
    "ignored": 0,
    "dead": 0,
    "alreadyHeld": 0,
    "cells": [
      {
        "stageId": "string",
        "status": "UNSPECIFIED",
        "count": 0
      }
    ],
    "held": [
      {
        "stageId": "string",
        "until": 0,
        "reason": "string"
      }
    ],
    "cost": 0,
    "credits": 0,
    "runs": 0
  },
  "snapshot": {
    "takenAt": 0,
    "members": 0,
    "done": 0,
    "setAside": 0,
    "setAsideByHand": 0,
    "dead": 0,
    "live": 0,
    "partial": false,
    "cells": [
      {
        "stageId": "string",
        "status": "UNSPECIFIED",
        "count": 0
      }
    ],
    "reasons": [
      {
        "reason": "string",
        "count": 0
      }
    ],
    "stuckItemIds": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "alreadyHeld": 0,
    "cost": 0,
    "credits": 0,
    "runs": 0
  },
  "estimate": {
    "computedAt": 0,
    "sampleSize": 0,
    "remainingCount": 0,
    "countIsFloor": false,
    "perItemP50": 0,
    "perItemP90": 0,
    "perItemMax": 0,
    "creditsPerItemP90": 0,
    "totalP50": 0,
    "totalP90": 0,
    "creditsP90": 0,
    "sampleByStatus": {},
    "budgetImpact": [
      {
        "agentId": "string",
        "managed": false,
        "projectedP90": 0,
        "windows": null
      }
    ],
    "hash": "string",
    "insufficient": false
  },
  "budgetGrants": [
    {
      "agentId": "string",
      "period": "string",
      "environmentSlug": "string",
      "before": 0,
      "after": 0,
      "restored": false,
      "note": "string"
    }
  ],
  "followUpGeneration": 0,
  "followUps": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "generation": 0,
      "stepIndex": 0,
      "kind": "NOTIFY",
      "step": {
        "kind": "UNSPECIFIED",
        "audience": null,
        "hook": "string",
        "agentId": "string",
        "instruction": "string",
        "actionCeiling": null,
        "after": null,
        "effectiveActionCeiling": "READ_ONLY",
        "isSafeToRepeat": false
      },
      "status": "PENDING",
      "attempts": 0,
      "nextAttemptAt": 0,
      "detail": "string",
      "externalRef": "string",
      "executionRecordId": "00000000-0000-0000-0000-000000000000",
      "resolvedAt": 0
    }
  ]
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}