Artifacts

Remake one location plate (metered — TWO CALLS, price first).

The writer's escape hatch for a bad accepted plate, not a review step. METERED: one still image per attempt, at most 3 attempts. Sent WITHOUT confirmed it PRICES the remake and makes nothing (quotedOnly: true, credits, balanceAfter, sufficient, and a note to show the writer; when sufficient is false the caller must not confirm); sent again with confirmed: true it holds one credit line per attempt and queues ONE capped round — the same cap and judge as every plate — which keeps the least defective attempt and replaces the stored plate as soon as the round ends. The writer pays only for the attempts made; there is no approval step and nothing waits on the writer. Preconditions run above the price: an unknown key is 404 location_plate_not_found; a plate not made yet, a remake already running, a missing source plate, or no image model bound is 409 location_plate_precondition_failed, with nothing priced. A confirmed call answers with a chatToolJobId; read the location plates until the plate's remake leaves pending. Scope: artifact:publish. Idempotency-Key is required.

post/artifacts/{artifactId}/location-plates/{plateKey}/remake

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/artifacts/{artifactId}/location-plates/{plateKey}/remake
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Request body

confirmedboolean

Omit (or false) to PRICE the remake and make nothing. True only after the writer has seen that price and said go.

Response

The price (no confirmed) or the queued remake.

quotedOnlyboolean required

true when this call only PRICED the remake: nothing reserved, nothing queued.

artifactIdstring
scriptUploadIdstring required
plateKeystring required
maxAttemptsinteger required

The most attempts the capped round can take.

creditsPerAttemptinteger

Quote only.

creditsinteger required

The most the remake can cost: every attempt the cap allows. Only the attempts made are charged.

costLabelstring nullable

Quote only.

balanceAfterinteger

Quote only. Studio Credits the writer would have left once this is spent: the balance available now (as Billing shows it) minus the price. Negative means they are that many short.

sufficientboolean

Quote only. True when the available balance covers the price. False means the writer must top up first (the note names the Billing link) — do not confirm; the reserve would refuse.

notestring

Quote only — the price, what it would leave (or how short the writer is, with the top-up link), and that only the attempts made are charged. Show it to the writer.

caveatstring

Quote only — the remake's own sentence: the price covers every attempt the cap allows, only the attempts made are charged, the new plate replaces the old one with no approval step, and which plates cropped from this one it leaves as they are.

croppedIntostring[]

Quote only — the ready plates made from crops of this one. A remake leaves them as they are, so they can differ from the new plate until they are remade too.

queuedboolean

Confirmed calls only.

chatToolJobIdstring

Confirmed calls only. Read the location plates until this plate's remake leaves pending.

messagestring

Confirmed calls only.

Changes

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