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
}