ColomboAIDOCS
API ReferenceCookbook
Docs/MC-1 Forward/Forward quickstart
PublishedDeployment controlledLAST REVIEWED · 30 AUG 2026

Forward quickstart

Inspect Forward readiness and begin a governed discovery workflow.

Current implementation

Check the Forward surface

curl $MC1_BASE_URL/forward/overview \
  -H "Authorization: Bearer $MC1_API_KEY"

Current workflow

  • Confirm your organization and administrator access.
  • Create a named assessment. With operator-enabled execution, select 1–10 approved source references and run read-only discovery from the console.
  • API clients may reference only connected, organization-owned READ_ONLY connectors configured by operators.
  • Reuse the same Idempotency-Key and payload after a network error; changed payload reuse returns 409.
  • Inspect recent assessment status in the Forward console. Production-changing execution remains unavailable.

Create an assessment safely

Use a new key for each new assessment. First creation returns 201; an identical retry returns 200 and replayed=true. Keys remain effective while the assessment record is retained. Requests are limited to 16 KiB and 100 source references.

curl "$MC1_BASE_URL/forward/discovery" -X POST -H "Authorization: Bearer $MC1_API_KEY" -H "Content-Type: application/json" -H "Idempotency-Key: assessment-unique-001" -d '{"name":"Customer discovery","sources":[]}'

Release boundary

End of guide
Was this page helpful?
Forward quickstart | MC-1 Docs