Start a run
Queues a pull of the source now, outside its schedule. A source has one active run at a time: while one is queued or running, or while the source is paused or disabled, this answers 409. Sources whose kind cannot be fetched yet, and a stock pull of a source whose connector does not read stock apart, answer 422. The body is optional.
- Scopes
runs:write - Rate classexpensive
- Idempotency-Key required
/v1/sources/{id}/runsQueues a pull of the source now, outside its schedule. A source has one active run at a time: while one is queued or running, or while the source is paused or disabled, this answers 409. Sources whose kind cannot be fetched yet, and a stock pull of a source whose connector does not read stock apart, answer 422. The body is optional.
Authorization
apiKey An API key (fo_live_… / fo_test_…) as a bearer token
In: header
Path Parameters
Source (a vendor connection) ID
^src_[0-9A-Za-z]{22}$Header Parameters
Dated API version; pinned per organisation on first use and overridable per request
Value in
- "2026-10-01"
- "2026-10-04"
The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused
Value in
- "live"
- "test"
Unique key for this operation, reused on retries (24 h)
1 <= length <= 257Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)
Value in
- "true"
- "explain"
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
What to pull
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/sources/string/runs" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{}'{ "object": "run", "id": "string", "source": "string", "trigger": "schedule", "stream": "catalogue", "status": "queued", "stage": "fetch", "served_by": null, "stats": { "property1": 0, "property2": 0 }, "error": { "code": "fetch_refused", "message": "string" }, "waiting": { "reason": "rate_limited", "until": "2019-08-24T14:15:22Z", "attempt": 1, "detail": "string" }, "problems": [ { "sheet": "string", "line": 1, "column": "string", "field": "string", "problem": "missing", "detail": "string" } ], "created_at": "2019-08-24T14:15:22Z", "started_at": "2019-08-24T14:15:22Z", "finished_at": "2019-08-24T14:15:22Z"}