Drops

Answer the decision a drop is waiting on

Answer the decision a drop is waiting on. This is the ONLY endpoint that lets a drop charge credits: pass the task_id and quote_id exactly as the drop gives them in pending_approval, with decision approve to let that one step run or decline to cancel it. The quote fixes the credit ceiling, credits are charged only if the step succeeds, and approving the same quote twice does nothing the second time. A quote that is not the one on the step is refused, and so is one whose price has lapsed — in that case nothing is released and the engine prices the step again by itself, so read the drop for the new quote_id.

post/v1/engine/runs/{id}/approve

Request

  • Base URL: https://aicontentdrop.com
  • URL: https://aicontentdrop.com/v1/engine/runs/{id}/approve
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The drop's id, from POST /v1/engine/runs or GET /v1/engine/runs.

Request body

task_idstring uuid required

The step waiting on a decision.

quote_idstring required

The priced quote for that exact step. Refused if it is not the one on the step or its price has lapsed.

decision'approve' | 'decline'
revisioninteger

Optional. When given it must be the drop's current revision.

Response

The decision was recorded. On approve the step runs in the background; on decline it is cancelled and nothing is charged.

Changes

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