Pull full product (reconstruct the whole FPO from the live graph)

GET

/v1/products/pull-fpo

GET

/v1/products/pull-fpo

$ curl -G https://api.runtype.com/v1/products/pull-fpo \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      --data-urlencode "name=EcoSmart Thermostat"

1 {
2   "contentHash": "a3f5c9d8e7b4f1a2c6d3e8b9f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9",
3   "fpo": {
4     "id": "fpo-ec0sm4rt-001",
5     "name": "EcoSmart Thermostat",
6     "description": "A smart thermostat that learns your schedule and helps save energy.",
7     "version": "2.1.0",
8     "components": {
9       "flows": [
10         {
11           "id": "flow-001",
12           "name": "Temperature Control Flow",
13           "type": "automation",
14           "enabled": true
15         }
16       ],
17       "agents": [
18         {
19           "id": "agent-thermo-01",
20           "type": "sensor",
21           "model": "TS-1000",
22           "status": "active"
23         }
24       ],
25       "surfaces": [
26         {
27           "id": "surface-01",
28           "type": "mobile-app",
29           "platform": "iOS",
30           "version": "5.3.2"
31         }
32       ],
33       "tools": []
34     }
35   },
36   "productId": "prod-ec0sm4rt-12345",
37   "warnings": [
38     "Records and schedules are not included in this reconstruction.",
39     "Secrets are omitted for security reasons."
40   ]
41 }

Reconstruct a self-contained Full Product Object from the live product graph — the absorb-drift direction of ensure-fpo. Composes the per-entity pulls (product, backing flows/agents, surfaces) and mints deterministic FPO-local ids, so feeding the result back into POST /products/ensure-fpo converges to unchanged. records/schedules/secrets are NOT reconstructed and tools is emitted empty (tool refs are portable tool:<name>); see warnings for per-pull caveats. The contentHash is recomputed from the live graph, so it is accurate immediately after a dashboard edit.

Reconstruct a self-contained Full Product Object from the live product graph — the absorb-drift direction of ensure-fpo. Composes the per-entity pulls (product, backing flows/agents, surfaces) and mints deterministic FPO-local ids, so feeding the result back into POST /products/ensure-fpo converges to `unchanged`. records/schedules/secrets are NOT reconstructed and `tools` is emitted empty (tool refs are portable `tool:<name>`); see `warnings` for per-pull caveats. The contentHash is recomputed from the live graph, so it is accurate immediately after a dashboard edit.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

namestringRequired>=1 character

Response

Reconstructed FPO + canonical content hash

contentHashstring

Server-computed canonical whole-FPO content hash.

fpomap from strings to any

A self-contained Full Product Object reconstructed from the live graph. Feeding it back into POST /products/ensure-fpo converges to unchanged. records/schedules/secrets are not reconstructed (see warnings); tool refs are emitted as portable tool:<name>.

productIdstring

warningslist of strings

Reconstruction caveats (omitted entities, unrepresentable rows).

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error