HYBRID-CHAINDEVELOPERS
DOCUMENTATIONv2

OPERATE · MODULE 04

Business Network

Exchange permission-filtered business context between trusted partners and agents through signed, topic-scoped Context Exchanges.

BUSINESS CASES

Where this module fits

  • partner-safe context sharing
  • federated context delivery
  • clarifications and structured proposals

PRIMARY CONSUMERS

Who integrates it

  • partner integration teams
  • enterprise agents
  • data governance operators

PREREQUISITES

What must exist first

  • a registered workload signing key
  • workspace, exchange, topic, and residency permission

RECOMMENDED WORKFLOW

Compose the module safely.

  1. 01

    discover an admitted exchange and directional topic grant

  2. 02

    read or query filtered context

  3. 03

    publish, deliver, or respond with signed commitment evidence

MODULE CONTRACTS

Every mapped endpoint

Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.

GETList agent action evidence/api/v2/context/agent-actionsList only commitment evidence for this workload's Context Mesh actions.›GETList delivery jobs/api/v2/context/delivery/jobsList commitment-only durable delivery state for the workload workspace.›GETList delivery subscriptions/api/v2/context/delivery/subscriptionsList workspace-owned Context Exchange delivery subscriptions.›PUTRevise delivery subscription/api/v2/context/delivery/subscriptionsCreate an idempotent immutable revision of a workspace-owned delivery subscription.›POSTRevoke delivery subscription/api/v2/context/delivery/subscriptions/{subscription_id}/revocationsRevoke one workspace-owned delivery subscription with idempotent evidence.›GETList exchanges/api/v2/context/exchangesList active and pending private Context Exchanges visible to the authenticated workload.›POSTCreate clarification/api/v2/context/exchanges/{exchange_id}/clarificationsSubmit an explicit structured clarification without forwarding private prompt history.›GETRead partner feed/api/v2/context/exchanges/{exchange_id}/feedRead relationship- and topic-filtered partner context before any ranking or model processing.›POSTCreate proposal/api/v2/context/exchanges/{exchange_id}/proposalsSubmit a non-publishing structured partner proposal with retained provenance.›GETQuery partner context/api/v2/context/exchanges/{exchange_id}/queryQuery only context admitted by the exchange's directional topic grant.›GETList exchanges/api/v2/context/federation/exchangesList independently operated federated exchanges visible to the authenticated workload.›GETGet exchange/api/v2/context/federation/exchanges/{exchange_id}Read one relationship-scoped federation projection with schema, manifest, and receipt evidence.›POSTImport manifest/api/v2/context/federation/exchanges/{exchange_id}/importsVerify and record a signed inbound manifest after schema, direction, topic, and chain validation.›POSTPublish manifest/api/v2/context/federation/exchanges/{exchange_id}/manifestsPublish an approved, signed, hash-linked outbound manifest under directional topic and residency policy.›POSTRecord receipt/api/v2/context/federation/exchanges/{exchange_id}/receiptsVerify and record a signed, residency-bound delivery receipt for a retained manifest.›GETList nodes/api/v2/context/federation/nodesList public verification and commitment projections for this workspace's Context Mesh federation nodes.›GETRetrieve reviewed answer/api/v2/context/memory-collection-requests/{request_id}Retrieve your durable request using context:read plus the original action scope and permission. Current audience, publication and binding remain mandatory. Back off while OPEN; stop on ANSWERED, DISMISSED or access denial.›GETRead approved collection/api/v2/context/memory-collections/{collection_id}Read reviewed knowledge after current publication, audience, workload scope and collection binding checks.›GETRead signed manifest/api/v2/context/memory-collections/{collection_id}/manifestDiscover the authenticated V2 asynchronous protocol and effective capabilities. Verify the commitment and signature against a trusted publisher key.›POSTSubmit durable question or proposal/api/v2/context/memory-collections/{collection_id}/requestsSubmit QUERY or CLARIFY with context:query, or PROPOSE with context:propose. Requires a matching collection binding and audience capability. Reuse Idempotency-Key only with the same body. No immediate model response or financial authority.›GETList isolation evidence/api/v2/context/platform/isolation-evidenceList tenant-isolation suite results and commitments for the workload workspace.›POSTRecord isolation evidence/api/v2/context/platform/isolation-evidenceRecord signed, idempotent, commitment-only tenant-isolation test evidence.›GETList service evidence/api/v2/context/platform/objectivesList configured service objectives separately from observed evidence windows.›POSTRecord service evidence/api/v2/context/platform/objectives/{objective_id}/evidenceRecord signed, idempotent observations for one active service objective without inferring attainment.›GETList schemas/api/v2/context/platform/schemasList workspace-scoped immutable Context Mesh schema commitments and lifecycle state.›GETRead readiness summary/api/v2/context/platform/summaryRead workspace onboarding, plan, region, retention, schema, hold, objective, and isolation readiness without implying certification.›GETRead usage/api/v2/context/platform/usageRead content-free workspace usage totals produced by idempotent meter evidence.›POSTRecord usage/api/v2/context/platform/usageRecord one signed, idempotent, content-free usage event under metering scope.›POSTPublish commit/api/v2/context/repositories/{repository_id}/commitsPublish an explicitly approved immutable context commit under repository, topic, review, and budget policy.›POSTEnroll workspace knowledge agent/api/v2/workspaces/{workspace_id}/knowledge-agentsCurrent human workspace OWNER enrolls an Ed25519 agent using fresh WORKLOAD_CLIENT_REGISTRATION approval and proof of key possession. Only context:read/query/feedback/propose/subscribe; no financial authority. tenant_uuid must match workspace_id.›POSTRevoke workspace knowledge agent/api/v2/workspaces/{workspace_id}/knowledge-agents/{client_id}/revocationsCurrent human workspace OWNER revokes a knowledge-only credential using fresh WORKLOAD_CLIENT_REVOCATION approval. Rejects credentials belonging to another workspace or carrying non-knowledge permissions.›
RELATED MODULESReturn to the complete V2 directory ↗