integrations

Fetch For Bronze

Fetch + shape integration data for a single source. Returns the payload dict the corresponding digital-twin-api Bronze adapter's shape_payload() accepts, plus the adapter slug + doc_type so the caller can route into run_bronze_ingest_sources() directly.

A plain def endpoint: FastAPI runs it in its threadpool, so the synchronous Composio SDK calls (and HubSpot's bounded parallel reads) never block the event loop.

post/v1/integrations/fetch-for-bronze

Request

  • Base URL
    https://api.evidenso.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Headers

authorizationstring

Request body

society_idstring required

Composite 'market/name' identifier (digital-twin-api convention).

source_slugstring required

Composio toolkit slug, e.g. 'granola_mcp' or 'slack'.

user_idstring required

Firebase uid of the user the society is being created for. Used to resolve the Composio user_id scope.

product_namestring

Optional product scope. Empty for org-level connections (the default for society-creation flows).

internal_domainsstring[]

Host org email domains, used by adapters to exclude internal participants from CLIENT-domain inference.

scopeobject

Per-source scope filter. Per-source shape: Slack {mode, channel_ids?}, Google {mode, folder_ids?, file_ids?}, Granola {mode, meeting_ids?}, Notion {mode, page_ids?}, HubSpot {mode: 'selected', contact_ids: ['portalId:contactId']} where mode is 'all' or 'selected' (HubSpot: 'selected' only).

agent_payload_idstring

Id of an mcp_agent_document_payloads row holding documents the user's agent pre-extracted via its own integrations. Required when source_slug='agent_documents'; ignored for Composio-backed sources.

Response

Successful Response

adapter_slugstring required

Slug used by digital-twin-api/src/market_intelligence/bronze/connectors/__init__.py:get_adapter().

doc_typestring required
payloadobject required

Changes

No recorded changes to this operation across all 1 revision of this API.