Data Sync - Stackone

Data Sync writes an action’s result to a StackOne-managed index, then serves reads from that index instead of calling the provider. Use it for data an agent reads often — fast, repeatable reads without re-fetching from the source each time.

How it works

Write a run to the index

Add ?sync=true to a normal RPC call. StackOne runs the action against the provider and stores the result.

curl -X POST "https://api.stackone.com/actions/rpc?sync=true" \
  -u "$STACKONE_API_KEY:" \
  -H "x-account-id: customer-bamboohr" \
  -H "Content-Type: application/json" \
  -d '{ "action": "bamboohr_list_employees", "query": { "page_size": 25 } }'

The response includes a datasync block with synced_at, sync_expires_at, and a params_hash.

Read synced data back

Call /actions/rpc/synced with the same action and params. StackOne returns the stored records without touching the provider.

curl -X POST "https://api.stackone.com/actions/rpc/synced" \
  -u "$STACKONE_API_KEY:" \
  -H "x-account-id: customer-bamboohr" \
  -H "Content-Type: application/json" \
  -d '{ "action": "bamboohr_list_employees", "query": { "page_size": 25 } }'

A synced read resolves by params_hash. The action, query, body, and headers must match what was used on the write, or it won’t find the run. Pagination keys are stripped before hashing.

Sync metadata

The datasync block tells you the state of the stored data:

Field	Meaning
`synced_at`	When the data was written
`sync_expires_at`	When the stored data expires
`last_full_run_id`	The run that produced the readable data
`params_hash`	Hash of the canonical params that identifies this run

When to use it

The same provider data is read repeatedly and tolerates being slightly stale.
You want predictable read latency that doesn’t depend on the provider.

For data that must be live on every call, use a normal Actions API call without sync.

Reference

Make an RPC call

The sync=true write parameter.

Read synced data

The /actions/rpc/synced read endpoint.

​How it works

​Sync metadata

​When to use it

​Reference

Make an RPC call

Read synced data

How it works

Sync metadata

When to use it

Reference