---
title: "Run a Transfer node (Field Registry)"
method: POST
path: "/v1/nodes/transfer"
tags: ["Nodes"]
---

# Run a Transfer node (Field Registry)

`POST /v1/nodes/transfer`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/nodes/transfer`
- Auth: HTTP bearer

Fill a schema's cells from the Field Registry over the given documents (no LLM extraction), creating a new record set. The documents must already have been ingested + registry-extracted. Returns 202 with the node run and its `record_set_id` — chain later nodes (extract/resolve/validate/assemble) by passing that id. Node-jobs are the primitive tier: no review/blocking holds (that stays on POST /v1/pipelines).

## Request body

- object
  - `schema_id` string, uuid, required
  - `document_ids` string[], required

## Response `202`

Node job created and queued

- NodeRun: A standalone run of one One Engine phase over a record set.
  - `id` string, uuid
  - `node_type` 'transfer' | 'extraction' | 'resolution' | 'validation' | 'assembly'
  - `status` 'queued' | 'running' | 'completed' | 'partial' | 'error'
  - `record_set_id` string, uuid, nullable
  - `product_record_set_id` string, uuid, nullable
  - `total` integer
  - `completed` integer
  - `errors` integer
  - `error_message` string, nullable
  - `created_at` string, date-time
  - `links` object

## Other responses

- `400`: Invalid request
- `404`: Schema or a document not found

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)