org-discovery-runs

Start a private discovery run

Changed on

Start a private discovery run for the org (record only, no pipeline execution).

Use this organization discovery operation for private workspace research records. Keep private run state separate from public directory entries until publication is explicit.

post/api/orgs/{org_id}/discovery-runs

Request

  • Base URL: https://atlas.rebuildingus.org
  • URL: https://atlas.rebuildingus.org/api/orgs/{org_id}/discovery-runs
  • Auth: none declared

Path parameters

org_idstring required

Headers

x-api-keystring nullable

Request body

issue_areasstring[] required

List of issue area slugs to query

location_querystring required

Location query (e.g., 'Kansas City, MO')

research_goal'landscape_scan' | 'interview_leads' | 'partner_scan' | 'ecosystem_map'

Research job this run supports

statestring required

2-letter state code

Response

Successful Response

completed_atstring nullable

Completion timestamp

created_atstring required

Creation timestamp

entries_after_dedupinteger required

Entries after deduplication

entries_confirmedinteger required

Entries confirmed

entries_extractedinteger required

Entries extracted

error_messagestring nullable

Error message if failed

idstring required

Discovery run ID

issue_areasstring[] required

Issue areas queried

location_querystring required

Location query

org_idstring required

Owning organization ID

queries_generatedinteger required

Search queries generated

research_goal'landscape_scan' | 'interview_leads' | 'partner_scan' | 'ecosystem_map' required

Research job this run supports

sources_fetchedinteger required

Sources fetched

sources_processedinteger required

Sources processed

started_atstring required

Start timestamp

statestring required

State code

statusstring required

Status (running, completed, failed)

Changes

  • 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