discovery-runs

Sync a local discovery run bundle

Changed on

Sync reviewed local Scout results into Atlas using an authenticated, idempotent workflow.

Use this discovery operation to create, synchronize, lease, inspect, or cancel research work. Treat discovered actors as reviewable leads until their source evidence and visibility state are checked.

Sync is for reviewed local Scout results. Preserve local-to-remote entry links and visibility receipts so a team can tell what stayed private, what was skipped, and what became public.

post/api/discovery-runs/syncs

Request

  • Base URL: https://atlas.rebuildingus.org
  • URL: https://atlas.rebuildingus.org/api/discovery-runs/syncs
  • Auth: none declared

Headers

x-atlas-upload-targetstring nullable
x-atlas-workspace-idstring nullable
x-api-keystring nullable

Request body

Response

The result of syncing the local run bundle.

duplicateboolean

Whether this sync was treated as an idempotent replay of an existing bundle.

entries_persistedinteger required

Number of entries persisted into Atlas.

run_idstring required

Atlas discovery run identifier.

sources_persistedinteger required

Number of sources persisted into Atlas.

status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required

Lifecycle status for a discovery run tracked by Atlas.

sync_statusstring required

Outcome of the sync attempt.

Changes

  • c604ae765814Revision changes
    • info

      the /// request property's minLength was decreased from 1 to 0

    • info

      the /// request property's minLength was decreased from 2 to 0

  • 6ea72ce93d40Revision changes
    • warning

      deleted the header request parameter x-atlas-actor-email

    • warning

      deleted the header request parameter x-atlas-actor-id

    • warning

      deleted the header request parameter x-atlas-internal-secret

    • warning

      deleted the header request parameter x-atlas-organization-id