POST
/
v1
/
citation_schemas
/
backfill
Backfill Citation Schema
curl --request POST \
  --url https://api.bland.ai/v1/citation_schemas/backfill \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "schema_id": "<string>",
  "call_id": "<string>"
}'
{
  "data": {
    "status": "success",
    "call_id": "8f2c4a1b-7d9e-4f6a-b3c8-2e5d7a9f1c4b",
    "schema_id": "4e7b2f8a-6c1d-4a9e-8f3b-7c2e9a4f6d1b",
    "variables_extracted": 3
  },
  "errors": null
}

​
Overview

The backfill endpoint allows you to apply a citation schema to a call that has already been completed. This is useful when you create a new schema and want to extract data from historical calls, or when you need to re-analyze a call with an updated schema.
This is an Enterprise-only feature. Contact your Bland representative or reach out to sales to enable this functionality.
Backfilling will overwrite any existing citation data for the specified call and schema combination. This operation cannot be undone.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
schema_id
string
required
The unique identifier of the citation schema to apply to the call.
​
call_id
string
required
The unique identifier of the completed call to analyze with the citation schema.

​
Response

​
data
object
The backfill operation result data.
​
status
string
The status of the backfill operation (“success” or “error”).
​
call_id
string
The call ID that was processed.
​
schema_id
string
The schema ID that was applied.
​
variables_extracted
integer
The number of variables that were successfully extracted from the call.
​
errors
null
Will be null for successful requests.

​
Error Responses

​
400 Bad Request
Returned when:
  • Required parameters (schema_id or call_id) are missing
  • The call has already been processed with this schema
  • The call does not have a transcript available
​
403 Forbidden
Returned when the account does not have enterprise features enabled.
​
404 Not Found
Returned when:
  • The specified call ID is not found
  • The specified schema ID is not found
  • Either resource doesn’t belong to your organization
{
  "data": {
    "status": "success",
    "call_id": "8f2c4a1b-7d9e-4f6a-b3c8-2e5d7a9f1c4b",
    "schema_id": "4e7b2f8a-6c1d-4a9e-8f3b-7c2e9a4f6d1b",
    "variables_extracted": 3
  },
  "errors": null
}