Skip to main content
POST /api/v2/provider/registration/capabilities/{capabilityUid}/certification-fixture-setups Use this request to nominate a separate, non-production inventory Source for review before a protected certification test can use it. Submitting a request does not create a fixture, run a test, dispatch an evaluation, or certify an Agent.

Who can submit

Sign in to Interchange as a direct human Account Admin for the seller that owns the capability, then make the request with that browser session. API keys, service principals, simulated sessions, delegated support, and indirect account access cannot submit it.

Request

Use the exact current revision and its attested endpoint. The nominated Source and its active account must belong to the same seller, be separate from live customer inventory, and have current evidence that the test cannot deliver, bill, or report against customer inventory. Never nominate a live customer Source. The spec must contain at least one supported product route. Its isolation guarantees must all be true; nonDeliverableMode is PAUSED or FUTURE_DATED; and cleanupTtlSeconds is from 60 through 86,400.

Response and review state

A successful submission returns 200 OK with the standard response envelope and a durable receipt in data:
PENDING_REVIEW means Interchange must review the evidence and the nominated Source. It does not mean a test has started. If review approves the request, Interchange registers and parks that exact separate Source for protected test preparation. Approval still does not launch validation or grant certification. If the revision, evidence, account, or Source is no longer current or safe, the request is rejected and you must correct the underlying setup before submitting a new truthful request.

Idempotency

Choose one 8 to 128 character idempotencyKey for one request body. Repeating the same request with that key returns the original receipt with replayed: true; it does not create another review request. Reusing the key with different request details returns a conflict instead of changing the original request.

Errors

  • 400 VALIDATION_ERROR - malformed IDs, an invalid fixture specification, or expired isolation evidence.
  • 403 ACCESS_DENIED - the caller is not a current direct human Account Admin for the capability owner.
  • 404 NOT_FOUND - the capability, current revision, endpoint, Source, or source account is not available for this seller.
  • 409 CONFLICT - the nominated setup is stale, unsafe, already incompatible, or the idempotency key was used with different details.
  • 503 SERVICE_UNAVAILABLE - the guarded setup write is busy. Read the current state before retrying.

Inventory sources overview

Source lifecycle and certification setup context

Inventory source tasks

All inventory-source operations