Keep a voice conversation's transcript on the order or quote it built

POST /orders/{orderId}/transcripts

Keep a voice conversation's transcript on the order or quote it built: the voice service hands it over when the conversation ends.

The body is the raw file — not multipart, not JSON — text/plain, an utterance a line, at most 5 MiB (413 TranscriptTooLarge; 400 TranscriptUnreadable when empty or not plain text — the body is read whole and held to that before a byte is written), kept in the private bucket under the order. The query string carries the voice session's id as reference and what the conversation came to (utterances, audioSeconds, startedAt). Appends fulfillment.transcript-attached. Idempotent on reference: an order keeps one transcript per conversation, so a retry is acknowledged with the order as it stands and stores nothing — an erased transcript stays erased. 410 TranscriptErased when the order's customer was erased — on the order (fulfillment.customer-erased) or in the CRM, asked as it is handed over: a conversation with them is not kept; a retry for a transcript erased since deletes its file again before it answers (503 TranscriptStoreUnavailable when the bucket or the CRM cannot be reached). 404 FulfillmentOrderNotFound.

Access

Requires orders:write.

How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.

Retries

Idempotent on reference: an order keeps one transcript per conversation, so a retry is acknowledged with the order as it stands and stores nothing — an erased transcript stays erased.

A retry with the same key answers 201, with what the first call recorded.

Why every write carries a key: Idempotency and retries.

Facts appended

fulfillment.transcript-attached
fulfillment.customer-erased

What a fact is: Facts and the journal.

AI agent tool

No agent tool. The voice service hands a conversation's transcript to the quote it built when the session ends, under its own credential, as a raw text body a JSON tool call cannot carry; an agent reads one with fulfillment_link_transcript.

Connecting an agent: AI agents.

Example

Send the transcript as the raw request body, with Content-Type: text/plain; charset=utf-8.

curl

curl -X POST 'https://fulfillment.getmanifold.io/orders/ord_01a15652-63f7-7a81-9b92-d8e9f0a1b2c3/transcripts?reference=vcs_01a15652-6a10-7c2e-8f41-0b2c3d4e5f60&utterances=42&audioSeconds=754&startedAt=2026-10-19T22%3A45%3A30.000Z' \
  -H "Authorization: Bearer $MANIFOLD_TOKEN" \
  -H 'Content-Type: text/plain' \
  --data-binary 'Voice session … 
[00:04] Speaker 1: Forty-eight of the stoneware mugs, please.' \
  -o answer.txt

JavaScript (fetch)

const response = await fetch("https://fulfillment.getmanifold.io/orders/ord_01a15652-63f7-7a81-9b92-d8e9f0a1b2c3/transcripts?reference=vcs_01a15652-6a10-7c2e-8f41-0b2c3d4e5f60&utterances=42&audioSeconds=754&startedAt=2026-10-19T22%3A45%3A30.000Z", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}`, "Content-Type": "text/plain" },
  body: "Voice session … \n[00:04] Speaker 1: Forty-eight of the stoneware mugs, please.",
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const text = await response.text();

Request body · text/plain

Voice session … 
[00:04] Speaker 1: Forty-eight of the stoneware mugs, please.

Response · 201 · text/plain

{
  "id": "ord_01a15652-63f7-7a81-9b92-d8e9f0a1b2c3",
  "reference": "QUOTE-HARBOUR-OCT",
  "source": {
    "kind": "api"
  },
  "customer": {
    "companyId": "cmp_01a1588a-1f02-7a3b-8c4d-5e6f7a8b9c0d",
    "shippingAddressId": "cloc_01a1588a-1f02-7a3b-8c4d-6f7a8b9c0d1e",
    "billingAddressId": "cloc_01a1588a-1f02-7a3b-8c4d-6f7a8b9c0d1e"
  },
  "party": {
    "companyId": "cmp_01a1588a-1f02-7a3b-8c4d-5e6f7a8b9c0d",
    "name": "Harbour Ceramics Pty Ltd",
    "paymentTermsDays": 30,
    "shipTo": {
      "id": "cloc_01a1588a-1f02-7a3b-8c4d-6f7a8b9c0d1e",
      "label": "Fremantle warehouse",
      "address": {
        "firstName": "Receiving",
        "lastName": "Dock",
        "company": "Harbour Ceramics",
        "address1": "14 Kiln Street",
        "city": "Fremantle",
        "province": "Western Australia",
        "provinceCode": "WA",
        "country": "Australia",
        "countryCode": "AU",
        "zip": "6160"
      }
    },
    "billTo": {
      "id": "cloc_01a1588a-1f02-7a3b-8c4d-6f7a8b9c0d1e",
      "label": "Fremantle warehouse",
      "address": {
        "company": "Harbour Ceramics Pty Ltd",
        "address1": "PO Box 412",
        "city": "Fremantle",
        "provinceCode": "WA",
        "countryCode": "AU",
        "zip": "6959"
      }
    }
  },
  "catalogIds": [
    "cat_01a15880-2a10-7b2c-8d3e-4f5a6b7c8d9e"
  ],
  "currency": "AUD",
  "convention": "exclusive",
  "shippingTaxBasis": {
    "_tag": "calculated",
    "treatment": "domestic",
    "country": "AU",
    "class": "follows-goods",
    "rateBps": 1000
  },
  "shippingMethod": {
    "title": "Standard",
    "code": "STD"
  },
  "number": "SO-01041",
  "serial": 1041,
  "status": "draft-quote",
  "quote": {
    "createdAt": "2026-10-19T22:40:02.551Z"
  },
  "lines": [
    {
      "id": "lin_01a15652-63f7-7a81-9b92-e9f0a1b2c3d4",
      "sku": "MUG-SPECKLE",
      "name": "Speckled stoneware mug",
      "ordered": 48,
      "removed": false,
      "catalogId": "cat_01a15880-2a10-7b2c-8d3e-4f5a6b7c8d9e",
      "discountCents": 0,
      "allocated": 0,
      "picked": 0,
      "packed": 0,
      "dispatched": 0,
      "invoiced": 0,
      "returned": 0,
      "unitPriceCents": 2100,
      "listPriceCents": 2400,
      "priceOverride": {
        "fromCents": 2400,
        "by": {
          "_tag": "user",
          "id": "usr_01a15889-fa80-7b11-8c22-3d4e5f6a7b8c"
        },
        "at": "2026-10-19T22:41:15.090Z",
        "reason": "Trade price for 24 or more"
      },
      "inclusive": false,
      "taxBasis": {
        "_tag": "calculated",
        "treatment": "domestic",
        "country": "AU",
        "parts": [
          {
            "class": "standard",
            "rateBps": 1000,
            "weight": 1
          }
        ]
      },
      "orderDiscountCents": 0,
      "tax": {
        "inclusive": false,
        "amountCents": 100800,
        "entries": [
          {
            "class": "standard",
            "treatment": "domestic",
            "country": "AU",
            "rateBps": 1000,
            "netCents": 100800,
            "taxCents": 10080,
            "source": "manifold"
          }
        ],
        "netCents": 100800,
        "taxCents": 10080,
        "grossCents": 110880
      }
    },
    {
      "id": "lin_01a15652-63f7-7a81-9b92-f0a1b2c3d4e5",
      "sku": "BOWL-SALT-L",
      "name": "Salt-glaze serving bowl, large",
      "ordered": 6,
      "removed": false,
      "catalogId": "cat_01a15880-2a10-7b2c-8d3e-4f5a6b7c8d9e",
      "discountCents": 0,
      "allocated": 0,
      "picked": 0,
      "packed": 0,
      "dispatched": 0,
      "invoiced": 0,
      "returned": 0,
      "unitPriceCents": 3800,
      "listPriceCents": 3800,
      "inclusive": false,
      "taxBasis": {
        "_tag": "calculated",
        "treatment": "domestic",
        "country": "AU",
        "parts": [
          {
            "class": "standard",
            "rateBps": 1000,
            "weight": 1
          }
        ]
      },
      "orderDiscountCents": 0,
      "tax": {
        "inclusive": false,
        "amountCents": 22800,
        "entries": [
          {
            "class": "standard",
            "treatment": "domestic",
            "country": "AU",
            "rateBps": 1000,
            "netCents": 22800,
            "taxCents": 2280,
            "source": "manifold"
          }
        ],
        "netCents": 22800,
        "taxCents": 2280,
        "grossCents": 25080
      }
    }
  ],
  "workflow": {
    "paymentTerms": "on-account",
    "pick": "manual",
    "pack": "manual",
    "ship": "manual",
    "invoice": "manual",
    "shortfall": "wait",
    "allocation": "single-site-preferred",
    "routing": {
      "order": "rank",
      "decider": "manifold",
      "priority": []
    },
    "routingByCatalog": {}
  },
  "paymentTermsBy": "customer",
  "createdSequence": 4071,
  "shipments": [],
  "invoices": [],
  "refunds": [],
  "payments": [],
  "notes": [],
  "transcripts": [
    {
      "sessionId": "vcs_01a15652-6a10-7c2e-8f41-0b2c3d4e5f60",
      "utterances": 42,
      "audioSeconds": 754,
      "bytes": 4180,
      "startedAt": "2026-10-19T22:45:30.000Z",
      "by": {
        "_tag": "system",
        "id": "voice-manager:transcripts"
      },
      "attachedAt": "2026-10-19T22:58:12.204Z"
    }
  ],
  "edits": [],
  "consignments": [],
  "money": {
    "subtotalCents": 123600,
    "charges": {
      "shippingCents": 2500,
      "shippingDiscountCents": 0,
      "discountCents": 0
    },
    "discountCents": 0,
    "tax": {
      "netCents": 126100,
      "taxCents": 12610,
      "grossCents": 138710,
      "breakdown": [
        {
          "class": "standard",
          "treatment": "domestic",
          "country": "AU",
          "rateBps": 1000,
          "exempt": false,
          "taxableCents": 126100,
          "taxCents": 12610
        }
      ]
    },
    "shippingTax": {
      "inclusive": false,
      "amountCents": 2500,
      "entries": [
        {
          "class": "standard",
          "treatment": "domestic",
          "country": "AU",
          "rateBps": 1000,
          "netCents": 2500,
          "taxCents": 250,
          "source": "manifold"
        }
      ],
      "netCents": 2500,
      "taxCents": 250,
      "grossCents": 2750
    },
    "totalCents": 138710,
    "paidCents": 0,
    "refundedCents": 0,
    "balanceCents": 138710,
    "refundOwedCents": 0,
    "status": "unpaid"
  },
  "discounts": [],
  "shortfalls": [],
  "createdAt": "2026-10-19T22:40:02.551Z",
  "updatedAt": "2026-10-19T22:58:12.204Z"
}

The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: fulfillment-manager.openapi.json. Base URL https://fulfillment.getmanifold.io.

Errors

Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.

`400`

Refusal	What it means	What to do
`TranscriptUnreadable` reason	Empty or not plain text — the body is read whole and held to that before a byte is written, kept in the private bucket under the order.	Fix the request. Sending it again unchanged gets the same answer.

`401`

Refusal	What it means	What to do
`Unauthorized` reason	The token is missing, expired or not one Manifold issued.	Get a fresh token and send the call again.
`TokenAlreadyUsed` tokenId	A single-use app token was already spent.	Mint a new token for this call.

`402`

Refusal	What it means	What to do
`SubscriptionRequired` status	The organization's subscription has lapsed, so writes are refused.	An owner settles billing. Reads still work meanwhile.

`403`

Refusal	What it means	What to do
`TenantRequired` userId	The token names no organization.	Choose the organization, then get a new token.
`ScopeRequired` required	The token's roles do not grant the scope this call needs.	Ask an owner or admin for a role that grants it.

`404`

Refusal	What it means	What to do
`FulfillmentOrderNotFound` orderId	No such record in this organization.	Check the id in the path or the body.

`409`

Refusal	What it means	What to do
`MirroredFromSource` source	This area is fed by your source system until the organization goes live.	Make the change in the source system, or go live first.

`410`

Refusal	What it means	What to do
`TranscriptErased` orderId, sessionId, erasedAt	The order's customer was erased — on the order (`fulfillment.customer-erased`) or in the CRM, asked as it is handed over: a conversation with them is not kept.	Nothing changed.

`413`

Refusal	What it means	What to do
`TranscriptTooLarge` limit, size	The request was refused, and nothing changed.	Nothing changed.

`503`

Refusal	What it means	What to do
`TranscriptStoreUnavailable` reason	A service this call needs did not answer, so nothing changed.	Send the same request again, with the same key.
`RequestLogUnavailable` tokenId, reason	The service could not record the request, so it did nothing.	Send the same request again, with the same key.

How refusals work everywhere: Errors.

Used in

Share a quote your customer can accept, step 6: Keep the call it was quoted over