Orders

Ask for a finished order to be edited again

Creates a new order that re-edits the original recording with these instructions and returns its id. It is edited by the AI and uses the original's minutes from the allowance, like any order, unless it ends failed: a revision that is not delivered (for one, because it would have sounded worse than the original edit) uses none. The original order and its files are not changed. A revision cannot itself be revised: send the next change to the original order. It returns the edited audio; show notes, transcript and clips are made again only when the instructions ask for them. Only an order placed through the API can be revised through it.

post/orders/{id}/revision

Request

  • Base URL: https://barevalue.com/api/v1
  • URL: https://barevalue.com/api/v1/orders/{id}/revision
  • Auth: HTTP bearer

Path parameters

idinteger required

Order ID

Request body

instructionsstring required

What to change, in plain language. Say everything that should be different in one request

Example request

{
  "instructions": "Keep the story about the dog, it was cut. The intro music is too loud."
}

Response

The same revision as a moment ago (duplicate: true)

order_idinteger

The revision, a new order. Poll its status

original_order_idinteger
statusstring
minutes_usedinteger

Taken from the allowance: the length of the original recording

messagestring
duplicateboolean

Present and true when the same instructions were sent for this order in the last 10 minutes: this is that revision, nothing new was ordered

Example response

{
  "status": "submitted",
  "allowance": {
    "reason": "email_not_verified",
    "rate": {
      "orders_at_once": 1,
      "minutes_per_window": 120,
      "window_hours": 5
    }
  }
}

Changes

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