overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Assertible Sync API
  version: 1.0.0
x-generated: '2026-09-04'
x-method: derived
x-source: openapi/assertible-sync-api-openapi.yml
x-extends: openapi/assertible-sync-api-openapi.yml
x-note: >-
  Records the deterministic-key behaviour Assertible documents for sync, which is
  what makes a repeated sync safe to run from CI.
actions:
- target: $.paths['/imports/{importId}/sync'].post
  description: Record the documented deterministic key used to match spec operations to existing tests.
  update:
    x-idempotency:
      mechanism: deterministic-key-upsert
      documented: https://assertible.com/docs/guide/sync
      note: >-
        For OpenAPI/Swagger imports each unique METHOD/ENDPOINT combination (or
        operationId, when present) identifies one Assertible test; for Postman
        imports each collection Item id does. A repeated sync updates the same
        tests rather than duplicating them.