{"openapi":"3.1.0","info":{"title":"Eranative BFF","version":"4.1.0","description":"Registry'den üretilmiştir (packages/contracts/src/operations.ts). 58 operasyon."},"servers":[{"url":"/"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ApiError":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION","UNAUTHENTICATED","FORBIDDEN","NOT_FOUND","CONFLICT","VERSION_CONFLICT","IDEMPOTENCY_MISMATCH","SCOPE_CHANGED","MERCHANT_UNKNOWN","HYPOTHESIS_NOT_PUBLIC","OWNER_NOT_BOUND","BUDGET_EXHAUSTED","STATE_TRANSITION","GONE","RATE_OR_BUDGET","OWNER_UNAVAILABLE","INTERNAL"]},"message":{"type":"string"},"trace_id":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object","additionalProperties":{}}},"required":["code","message","trace_id","retryable"],"additionalProperties":false}}},"paths":{"/v1/transformation/preview":{"post":{"operationId":"transformation.preview","tags":["W-22"],"summary":"transformation.preview (PUBLIC; owner Eranative)","x-capability":"PUBLIC","x-owner":"Eranative","x-workset":"W-22","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"catalog_version":{"type":"string"},"segment":{"type":"string","enum":["micro","small","medium","large"]},"currency":{"type":"string","enum":["EUR"]},"once":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"first_period_subtotal":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly_groups":{"type":"array","items":{"type":"object","properties":{"billable_from":{"type":"string","enum":["go_live_acceptance","service_start"]},"amount":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"service_ids":{"type":"array","items":{"type":"string"}}},"required":["billable_from","amount","service_ids"],"additionalProperties":false}},"binding":{"type":"boolean","enum":[false]},"eligible_base":{"type":"boolean"},"checkout_eligible":{"type":"boolean"},"quote_reasons":{"type":"array","items":{"type":"string","enum":["EMPTY_SELECTION","ORGANISATION_SCOPE","MULTI_UNIT_SCOPE","CUSTOM_BUILD","PLATFORM_TARIFF_AND_INTEGRATION_REVIEW","MINIAPP_REQUIRES_WEB","LANGUAGE_SCOPE_REVIEW","GROWTH_SETUP_REVIEW","SOCIAL_CARE_REQUIRES_GROWTH"]}},"excluded_platform_ids":{"type":"array","items":{"type":"string"}},"agents":{"type":"object","properties":{"marketing":{"type":"integer"},"care":{"type":"integer"}},"required":["marketing","care"],"additionalProperties":false},"ai_call_quota_month":{"type":"integer"}},"required":["catalog_version","segment","currency","once","monthly","first_period_subtotal","monthly_groups","binding","eligible_base","checkout_eligible","quote_reasons","excluded_platform_ids","agents","ai_call_quota_month"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"service_ids":{"type":"array","items":{"type":"string"},"maxItems":8},"platform_ids":{"type":"array","items":{"type":"string"},"maxItems":16}},"required":["catalog_version","profile","service_ids","platform_ids"],"additionalProperties":false}}}}}},"/v1/transformation/requests":{"post":{"operationId":"transformation.request","tags":["W-23"],"summary":"transformation.request (brief.write; owner Eranative)","x-capability":"brief.write","x-owner":"Eranative","x-workset":"W-23","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"brief_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["REQUESTED"]},"version":{"type":"integer"},"preview":{"type":"object","properties":{"catalog_version":{"type":"string"},"segment":{"type":"string","enum":["micro","small","medium","large"]},"currency":{"type":"string","enum":["EUR"]},"once":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"first_period_subtotal":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly_groups":{"type":"array","items":{"type":"object","properties":{"billable_from":{"type":"string","enum":["go_live_acceptance","service_start"]},"amount":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"service_ids":{"type":"array","items":{"type":"string"}}},"required":["billable_from","amount","service_ids"],"additionalProperties":false}},"binding":{"type":"boolean","enum":[false]},"eligible_base":{"type":"boolean"},"checkout_eligible":{"type":"boolean"},"quote_reasons":{"type":"array","items":{"type":"string","enum":["EMPTY_SELECTION","ORGANISATION_SCOPE","MULTI_UNIT_SCOPE","CUSTOM_BUILD","PLATFORM_TARIFF_AND_INTEGRATION_REVIEW","MINIAPP_REQUIRES_WEB","LANGUAGE_SCOPE_REVIEW","GROWTH_SETUP_REVIEW","SOCIAL_CARE_REQUIRES_GROWTH"]}},"excluded_platform_ids":{"type":"array","items":{"type":"string"}},"agents":{"type":"object","properties":{"marketing":{"type":"integer"},"care":{"type":"integer"}},"required":["marketing","care"],"additionalProperties":false},"ai_call_quota_month":{"type":"integer"}},"required":["catalog_version","segment","currency","once","monthly","first_period_subtotal","monthly_groups","binding","eligible_base","checkout_eligible","quote_reasons","excluded_platform_ids","agents","ai_call_quota_month"],"additionalProperties":false},"brief_reused":{"type":"boolean"},"joinn_bound":{"type":"boolean"}},"required":["id","brief_id","state","version","preview"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"service_ids":{"type":"array","items":{"type":"string"},"maxItems":8},"platform_ids":{"type":"array","items":{"type":"string"},"maxItems":16},"notes":{"type":"string","maxLength":4000,"default":""},"draft_token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"},"existing_brief_id":{"type":"string","format":"uuid"},"expected_brief_version":{"type":"integer","minimum":1},"solution_interests":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string","minLength":1,"maxLength":80},"intent":{"type":"string","enum":["INTERESTED","ALREADY_USING","NOT_NOW"]}},"required":["platform_id","intent"],"additionalProperties":false},"maxItems":40,"default":[]},"joinn_ref":{"type":"string","format":"uuid"}},"required":["catalog_version","profile","service_ids","platform_ids"],"additionalProperties":false}}}}},"get":{"operationId":"transformation.requests","tags":["W-23"],"summary":"transformation.requests (brief.read; owner Eranative)","x-capability":"brief.read","x-owner":"Eranative","x-workset":"W-23","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"brief_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["REQUESTED","SCOPING","QUOTED","ACCEPTED","CLOSED"]},"version":{"type":"integer"},"quote_ref":{"type":"string","nullable":true},"state_reason":{"type":"string"},"selection":{"type":"object","properties":{"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"service_ids":{"type":"array","items":{"type":"string"},"maxItems":8},"platform_ids":{"type":"array","items":{"type":"string"},"maxItems":16}},"required":["catalog_version","profile","service_ids","platform_ids"],"additionalProperties":false},"preview":{"type":"object","properties":{"catalog_version":{"type":"string"},"segment":{"type":"string","enum":["micro","small","medium","large"]},"currency":{"type":"string","enum":["EUR"]},"once":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"first_period_subtotal":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"monthly_groups":{"type":"array","items":{"type":"object","properties":{"billable_from":{"type":"string","enum":["go_live_acceptance","service_start"]},"amount":{"type":"string","pattern":"^\\d+\\.\\d{2}$"},"service_ids":{"type":"array","items":{"type":"string"}}},"required":["billable_from","amount","service_ids"],"additionalProperties":false}},"binding":{"type":"boolean","enum":[false]},"eligible_base":{"type":"boolean"},"checkout_eligible":{"type":"boolean"},"quote_reasons":{"type":"array","items":{"type":"string","enum":["EMPTY_SELECTION","ORGANISATION_SCOPE","MULTI_UNIT_SCOPE","CUSTOM_BUILD","PLATFORM_TARIFF_AND_INTEGRATION_REVIEW","MINIAPP_REQUIRES_WEB","LANGUAGE_SCOPE_REVIEW","GROWTH_SETUP_REVIEW","SOCIAL_CARE_REQUIRES_GROWTH"]}},"excluded_platform_ids":{"type":"array","items":{"type":"string"}},"agents":{"type":"object","properties":{"marketing":{"type":"integer"},"care":{"type":"integer"}},"required":["marketing","care"],"additionalProperties":false},"ai_call_quota_month":{"type":"integer"}},"required":["catalog_version","segment","currency","once","monthly","first_period_subtotal","monthly_groups","binding","eligible_base","checkout_eligible","quote_reasons","excluded_platform_ids","agents","ai_call_quota_month"],"additionalProperties":false},"solution_interests":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string","minLength":1,"maxLength":80},"intent":{"type":"string","enum":["INTERESTED","ALREADY_USING","NOT_NOW"]}},"required":["platform_id","intent"],"additionalProperties":false}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","brief_id","state","version","quote_ref","state_reason","selection","preview","created_at","updated_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/transformation/recommendations":{"post":{"operationId":"transformation.recommendations","tags":["W-22"],"summary":"transformation.recommendations (PUBLIC; owner Eranative)","x-capability":"PUBLIC","x-owner":"Eranative","x-workset":"W-22","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"catalog_version":{"type":"string"},"brief_version":{"type":"integer","nullable":true},"recommended":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string"},"name":{"type":"string"},"priority":{"type":"integer"},"lifecycle":{"type":"string","enum":["LIVE","BETA","COMING","RETIRED"]},"integration_readiness":{"type":"string","enum":["UNVERIFIED","DISCOVERY","SANDBOX_VERIFIED","PRODUCTION_VERIFIED"]},"stage":{"type":"string","enum":["Discover","Diagnose","Recommend","Scope","Proposal","Approval","Implementation","CustomerSuccess"]},"reason":{"type":"object","properties":{"kind":{"type":"string","enum":["SECTOR","NEED"]},"needs":{"type":"array","items":{"type":"string","enum":["physical_risk","weather","field_operations","margin","commercial_loss","finance","accounting","partner_growth","relocation","international_education","ai_security","data_access","accessibility","creative_content","digital_presence","operations"]}}},"required":["kind","needs"],"additionalProperties":false},"interest_only":{"type":"boolean"},"price_mode":{"type":"string","enum":["OWNER_TARIFF","REQUEST_QUOTE"]},"checkout_allowed":{"type":"boolean","enum":[false]}},"required":["platform_id","name","priority","lifecycle","integration_readiness","stage","reason","interest_only","price_mode","checkout_allowed"],"additionalProperties":false},"maxItems":3},"additional":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string"},"name":{"type":"string"},"priority":{"type":"integer"},"lifecycle":{"type":"string","enum":["LIVE","BETA","COMING","RETIRED"]},"integration_readiness":{"type":"string","enum":["UNVERIFIED","DISCOVERY","SANDBOX_VERIFIED","PRODUCTION_VERIFIED"]},"stage":{"type":"string","enum":["Discover","Diagnose","Recommend","Scope","Proposal","Approval","Implementation","CustomerSuccess"]},"reason":{"type":"object","properties":{"kind":{"type":"string","enum":["SECTOR","NEED"]},"needs":{"type":"array","items":{"type":"string","enum":["physical_risk","weather","field_operations","margin","commercial_loss","finance","accounting","partner_growth","relocation","international_education","ai_security","data_access","accessibility","creative_content","digital_presence","operations"]}}},"required":["kind","needs"],"additionalProperties":false},"interest_only":{"type":"boolean"},"price_mode":{"type":"string","enum":["OWNER_TARIFF","REQUEST_QUOTE"]},"checkout_allowed":{"type":"boolean","enum":[false]}},"required":["platform_id","name","priority","lifecycle","integration_readiness","stage","reason","interest_only","price_mode","checkout_allowed"],"additionalProperties":false}},"assessments":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string"},"state":{"type":"string","enum":["APPROPRIATE","NOT_PRIORITY","INFO_MISSING","NOT_ASSESSED"]},"required_purchase":{"type":"boolean","enum":[false]}},"required":["platform_id","state","required_purchase"],"additionalProperties":false}},"missing_fields":{"type":"array","items":{"type":"string","enum":["sector","needs"]}},"snapshot_ref":{"type":"string","nullable":true}},"required":["enabled","catalog_version","brief_version","recommended","additional","assessments","missing_fields","snapshot_ref"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brief_id":{"type":"string","format":"uuid"},"expected_brief_version":{"type":"integer","minimum":1},"profile":{"type":"object","properties":{"sector":{"type":"string","maxLength":80},"employees":{"type":"integer","minimum":1,"maximum":1000000},"needs":{"type":"array","items":{"type":"string","enum":["physical_risk","weather","field_operations","margin","commercial_loss","finance","accounting","partner_growth","relocation","international_education","ai_security","data_access","accessibility","creative_content","digital_presence","operations"]},"maxItems":16,"default":[]},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"type":"string","minLength":2,"maxLength":8}},"required":["sector","employees"],"additionalProperties":false},"assessments":{"type":"object","required":["safeus","accesspulse","metory","marginera"],"properties":{"safeus":{"type":"string","enum":["APPROPRIATE","NOT_PRIORITY","INFO_MISSING","NOT_ASSESSED"]},"accesspulse":{"type":"string","enum":["APPROPRIATE","NOT_PRIORITY","INFO_MISSING","NOT_ASSESSED"]},"metory":{"type":"string","enum":["APPROPRIATE","NOT_PRIORITY","INFO_MISSING","NOT_ASSESSED"]},"marginera":{"type":"string","enum":["APPROPRIATE","NOT_PRIORITY","INFO_MISSING","NOT_ASSESSED"]}},"additionalProperties":false,"default":{}}},"required":["profile"],"additionalProperties":false}}}}}},"/v1/transformation/requests/{id}/solution-interests":{"post":{"operationId":"transformation.solution_interests","tags":["W-23"],"summary":"transformation.solution_interests (brief.write; owner Eranative)","x-capability":"brief.write","x-owner":"Eranative","x-workset":"W-23","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"version":{"type":"integer"},"solution_interests":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string","minLength":1,"maxLength":80},"intent":{"type":"string","enum":["INTERESTED","ALREADY_USING","NOT_NOW"]}},"required":["platform_id","intent"],"additionalProperties":false}}},"required":["id","version","solution_interests"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer","minimum":1},"solution_interests":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"string","minLength":1,"maxLength":80},"intent":{"type":"string","enum":["INTERESTED","ALREADY_USING","NOT_NOW"]}},"required":["platform_id","intent"],"additionalProperties":false},"maxItems":40}},"required":["expected_version","solution_interests"],"additionalProperties":false}}}}}},"/v1/transformation/requests/{id}/joinn-attribution":{"post":{"operationId":"transformation.joinn_attribution","tags":["W-23"],"summary":"transformation.joinn_attribution (brief.write; owner Eranative)","x-capability":"brief.write","x-owner":"Eranative","x-workset":"W-23","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"attribution_ref":{"type":"string"},"opportunity_ref":{"type":"string"},"receipt_ref":{"type":"string"},"verified_at":{"type":"string","format":"date-time"},"replayed":{"type":"boolean"}},"required":["request_id","attribution_ref","opportunity_ref","receipt_ref","verified_at","replayed"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer","minimum":1},"proof":{"type":"string","minLength":8,"maxLength":4096},"consent_ref":{"type":"string","minLength":1,"maxLength":200}},"required":["expected_version","proof","consent_ref"],"additionalProperties":false}}}}}},"/v1/transformation/requests/{id}/transitions":{"post":{"operationId":"transformation.transition","tags":["W-23"],"summary":"transformation.transition (transformation.transition; owner Eranative)","x-capability":"transformation.transition","x-owner":"Eranative","x-workset":"W-23","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["REQUESTED","SCOPING","QUOTED","ACCEPTED","CLOSED"]},"version":{"type":"integer"},"quote_ref":{"type":"string","nullable":true}},"required":["id","state","version","quote_ref"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer","minimum":1},"target":{"type":"string","enum":["REQUESTED","SCOPING","QUOTED","ACCEPTED","CLOSED"]},"reason":{"type":"string","maxLength":2000,"default":""},"quote_ref":{"type":"string","minLength":1,"maxLength":200}},"required":["expected_version","target"],"additionalProperties":false}}}}}},"/v1/transformation/drafts":{"post":{"operationId":"transformation.draft.save","tags":["W-23"],"summary":"transformation.draft.save (PUBLIC; owner Eranative)","x-capability":"PUBLIC","x-owner":"Eranative","x-workset":"W-23","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}},"required":["token","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"},"selection":{"type":"object","properties":{"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"service_ids":{"type":"array","items":{"type":"string"},"maxItems":8},"platform_ids":{"type":"array","items":{"type":"string"},"maxItems":16}},"required":["catalog_version","profile","service_ids","platform_ids"],"additionalProperties":false},"notes":{"type":"string","maxLength":4000,"default":""}},"required":["selection"],"additionalProperties":false}}}}}},"/v1/transformation/drafts/resolve":{"post":{"operationId":"transformation.draft.resolve","tags":["W-23"],"summary":"transformation.draft.resolve (PUBLIC; owner Eranative)","x-capability":"PUBLIC","x-owner":"Eranative","x-workset":"W-23","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"selection":{"type":"object","properties":{"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"service_ids":{"type":"array","items":{"type":"string"},"maxItems":8},"platform_ids":{"type":"array","items":{"type":"string"},"maxItems":16}},"required":["catalog_version","profile","service_ids","platform_ids"],"additionalProperties":false},"notes":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"claimed":{"type":"boolean"}},"required":["selection","notes","expires_at","claimed"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["token"],"additionalProperties":false}}}}}},"/v1/catalog":{"get":{"operationId":"catalog.list","tags":["W-03"],"summary":"catalog.list (PUBLIC; owner M7/catalog)","x-capability":"PUBLIC","x-owner":"M7/catalog","x-workset":"W-03","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"capability_id":{"type":"string"},"title":{"type":"string"},"commercial_state":{"type":"string","enum":["INTEREST","QUOTABLE","PURCHASABLE","PROVISIONING","ACTIVE","SUSPENDED","CANCEL_AT_TERM","CANCELLED"]},"price_status":{"type":"string","enum":["APPROVED_ESTIMATE_RANGE","BINDING_QUOTE","ACTIVE_TARIFF","OFFER_REQUIRED"]},"price":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"cadence":{"type":"string","enum":["once","monthly","variable"]},"unit":{"type":"string"}},"required":["capability_id","title","commercial_state","price_status","price","cadence"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[]}},"/v1/session":{"get":{"operationId":"session.read","tags":["W-04"],"summary":"session.read (authenticated; owner M4/M8)","x-capability":"authenticated","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"actor_ref":{"type":"string","format":"uuid"},"tenant_ref":{"type":"string","format":"uuid"},"roles":{"type":"array","items":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]}},"locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"simulated_owners":{"type":"array","items":{"type":"string"}}},"required":["actor_ref","tenant_ref","roles","locale","simulated_owners"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/workspaces":{"post":{"operationId":"workspace.create","tags":["W-04"],"summary":"workspace.create (workspace.create; owner M4/M8)","x-capability":"workspace.create","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["tenant_id","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"country":{"type":"string","minLength":2,"maxLength":2},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"sector":{"type":"string"}},"required":["name","country","primary_locale","sector"],"additionalProperties":false}}}}}},"/v1/invitations":{"post":{"operationId":"membership.invite","tags":["W-04"],"summary":"membership.invite (membership.invite; owner M4/M8)","x-capability":"membership.invite","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"invitation_id":{"type":"string","format":"uuid"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["invitation_id","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]},"org_unit_id":{"type":"string","format":"uuid","nullable":true,"default":null}},"required":["email","role"],"additionalProperties":false}}}}}},"/v1/briefs":{"post":{"operationId":"brief.create","tags":["W-06"],"summary":"brief.create (brief.write; owner Eranative)","x-capability":"brief.write","x-owner":"Eranative","x-workset":"W-06","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","SUBMITTED","REVIEWED","ARCHIVED"]},"company":{"type":"object","properties":{"name":{"type":"string"},"sector":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"employee_band":{"type":"string"},"branches":{"type":"integer","minimum":0},"departments":{"type":"array","items":{"type":"string"}},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"website_url":{"type":"string","format":"uri"}},"required":["name","sector","country","employee_band","branches","departments","primary_locale"],"additionalProperties":false},"existing_systems":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"name":{"type":"string"},"api_access":{"type":"string","enum":["none","read","read_write","unknown"]}},"required":["kind","name","api_access"],"additionalProperties":false}},"goals":{"type":"object","properties":{"processes":{"type":"array","items":{"type":"string"}},"product_count_band":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"traffic_band":{"type":"string"},"ai_needs":{"type":"array","items":{"type":"string"}},"budget_band":{"type":"string"},"support_expectation":{"type":"string"}},"required":["processes","product_count_band","channels","roles","traffic_band","ai_needs","budget_band","support_expectation"],"additionalProperties":false},"build":{"type":"object","properties":{"web_mode":{"type":"string","enum":["NEW","INTEGRATE_EXISTING","NONE"]},"mini_app":{"type":"boolean"},"extra_locales":{"type":"array","items":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]}},"social_setup":{"type":"boolean"}},"required":["web_mode","mini_app","extra_locales","social_setup"],"additionalProperties":false},"products":{"type":"array","items":{"type":"string"}},"operations":{"type":"object","properties":{"level":{"type":"string","enum":["Launch","Operate","Dedicated"]},"support_hours":{"type":"string"},"slo_target":{"type":"string"},"ai_payment_mode":{"type":"string","enum":["prepaid","payg"]}},"required":["level","support_hours","slo_target","ai_payment_mode"],"additionalProperties":false}},"required":["tenant_id","id","version","state","company","existing_systems","goals","build","products","operations"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"name":{"type":"string"},"sector":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"employee_band":{"type":"string"},"branches":{"type":"integer","minimum":0},"departments":{"type":"array","items":{"type":"string"}},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"website_url":{"type":"string","format":"uri"}},"required":["name","sector","country","employee_band","branches","departments","primary_locale"],"additionalProperties":false},"existing_systems":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"name":{"type":"string"},"api_access":{"type":"string","enum":["none","read","read_write","unknown"]}},"required":["kind","name","api_access"],"additionalProperties":false}},"goals":{"type":"object","properties":{"processes":{"type":"array","items":{"type":"string"}},"product_count_band":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"traffic_band":{"type":"string"},"ai_needs":{"type":"array","items":{"type":"string"}},"budget_band":{"type":"string"},"support_expectation":{"type":"string"}},"required":["processes","product_count_band","channels","roles","traffic_band","ai_needs","budget_band","support_expectation"],"additionalProperties":false},"build":{"type":"object","properties":{"web_mode":{"type":"string","enum":["NEW","INTEGRATE_EXISTING","NONE"]},"mini_app":{"type":"boolean"},"extra_locales":{"type":"array","items":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]}},"social_setup":{"type":"boolean"}},"required":["web_mode","mini_app","extra_locales","social_setup"],"additionalProperties":false},"products":{"type":"array","items":{"type":"string"}},"operations":{"type":"object","properties":{"level":{"type":"string","enum":["Launch","Operate","Dedicated"]},"support_hours":{"type":"string"},"slo_target":{"type":"string"},"ai_payment_mode":{"type":"string","enum":["prepaid","payg"]}},"required":["level","support_hours","slo_target","ai_payment_mode"],"additionalProperties":false}},"additionalProperties":false}}}}}},"/v1/briefs/{id}":{"patch":{"operationId":"brief.update","tags":["W-06"],"summary":"brief.update (brief.write; owner Eranative)","x-capability":"brief.write","x-owner":"Eranative","x-workset":"W-06","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","SUBMITTED","REVIEWED","ARCHIVED"]},"company":{"type":"object","properties":{"name":{"type":"string"},"sector":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"employee_band":{"type":"string"},"branches":{"type":"integer","minimum":0},"departments":{"type":"array","items":{"type":"string"}},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"website_url":{"type":"string","format":"uri"}},"required":["name","sector","country","employee_band","branches","departments","primary_locale"],"additionalProperties":false},"existing_systems":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"name":{"type":"string"},"api_access":{"type":"string","enum":["none","read","read_write","unknown"]}},"required":["kind","name","api_access"],"additionalProperties":false}},"goals":{"type":"object","properties":{"processes":{"type":"array","items":{"type":"string"}},"product_count_band":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"traffic_band":{"type":"string"},"ai_needs":{"type":"array","items":{"type":"string"}},"budget_band":{"type":"string"},"support_expectation":{"type":"string"}},"required":["processes","product_count_band","channels","roles","traffic_band","ai_needs","budget_band","support_expectation"],"additionalProperties":false},"build":{"type":"object","properties":{"web_mode":{"type":"string","enum":["NEW","INTEGRATE_EXISTING","NONE"]},"mini_app":{"type":"boolean"},"extra_locales":{"type":"array","items":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]}},"social_setup":{"type":"boolean"}},"required":["web_mode","mini_app","extra_locales","social_setup"],"additionalProperties":false},"products":{"type":"array","items":{"type":"string"}},"operations":{"type":"object","properties":{"level":{"type":"string","enum":["Launch","Operate","Dedicated"]},"support_hours":{"type":"string"},"slo_target":{"type":"string"},"ai_payment_mode":{"type":"string","enum":["prepaid","payg"]}},"required":["level","support_hours","slo_target","ai_payment_mode"],"additionalProperties":false}},"required":["tenant_id","id","version","state","company","existing_systems","goals","build","products","operations"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer"},"patch":{"type":"object","properties":{"company":{"type":"object","properties":{"name":{"type":"string"},"sector":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"employee_band":{"type":"string"},"branches":{"type":"integer","minimum":0},"departments":{"type":"array","items":{"type":"string"}},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"website_url":{"type":"string","format":"uri"}},"required":["name","sector","country","employee_band","branches","departments","primary_locale"],"additionalProperties":false},"existing_systems":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"name":{"type":"string"},"api_access":{"type":"string","enum":["none","read","read_write","unknown"]}},"required":["kind","name","api_access"],"additionalProperties":false}},"goals":{"type":"object","properties":{"processes":{"type":"array","items":{"type":"string"}},"product_count_band":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"traffic_band":{"type":"string"},"ai_needs":{"type":"array","items":{"type":"string"}},"budget_band":{"type":"string"},"support_expectation":{"type":"string"}},"required":["processes","product_count_band","channels","roles","traffic_band","ai_needs","budget_band","support_expectation"],"additionalProperties":false},"build":{"type":"object","properties":{"web_mode":{"type":"string","enum":["NEW","INTEGRATE_EXISTING","NONE"]},"mini_app":{"type":"boolean"},"extra_locales":{"type":"array","items":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]}},"social_setup":{"type":"boolean"}},"required":["web_mode","mini_app","extra_locales","social_setup"],"additionalProperties":false},"products":{"type":"array","items":{"type":"string"}},"operations":{"type":"object","properties":{"level":{"type":"string","enum":["Launch","Operate","Dedicated"]},"support_hours":{"type":"string"},"slo_target":{"type":"string"},"ai_payment_mode":{"type":"string","enum":["prepaid","payg"]}},"required":["level","support_hours","slo_target","ai_payment_mode"],"additionalProperties":false}},"additionalProperties":false}},"required":["expected_version","patch"],"additionalProperties":false}}}}},"get":{"operationId":"brief.get","tags":["W-06"],"summary":"brief.get (brief.read; owner Eranative)","x-capability":"brief.read","x-owner":"Eranative","x-workset":"W-06","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","SUBMITTED","REVIEWED","ARCHIVED"]},"company":{"type":"object","properties":{"name":{"type":"string"},"sector":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2},"employee_band":{"type":"string"},"branches":{"type":"integer","minimum":0},"departments":{"type":"array","items":{"type":"string"}},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"website_url":{"type":"string","format":"uri"}},"required":["name","sector","country","employee_band","branches","departments","primary_locale"],"additionalProperties":false},"existing_systems":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"name":{"type":"string"},"api_access":{"type":"string","enum":["none","read","read_write","unknown"]}},"required":["kind","name","api_access"],"additionalProperties":false}},"goals":{"type":"object","properties":{"processes":{"type":"array","items":{"type":"string"}},"product_count_band":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"traffic_band":{"type":"string"},"ai_needs":{"type":"array","items":{"type":"string"}},"budget_band":{"type":"string"},"support_expectation":{"type":"string"}},"required":["processes","product_count_band","channels","roles","traffic_band","ai_needs","budget_band","support_expectation"],"additionalProperties":false},"build":{"type":"object","properties":{"web_mode":{"type":"string","enum":["NEW","INTEGRATE_EXISTING","NONE"]},"mini_app":{"type":"boolean"},"extra_locales":{"type":"array","items":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]}},"social_setup":{"type":"boolean"}},"required":["web_mode","mini_app","extra_locales","social_setup"],"additionalProperties":false},"products":{"type":"array","items":{"type":"string"}},"operations":{"type":"object","properties":{"level":{"type":"string","enum":["Launch","Operate","Dedicated"]},"support_hours":{"type":"string"},"slo_target":{"type":"string"},"ai_payment_mode":{"type":"string","enum":["prepaid","payg"]}},"required":["level","support_hours","slo_target","ai_payment_mode"],"additionalProperties":false}},"required":["tenant_id","id","version","state","company","existing_systems","goals","build","products","operations"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/blueprints/compile":{"post":{"operationId":"blueprint.compile","tags":["W-06"],"summary":"blueprint.compile (blueprint.write; owner Eranative)","x-capability":"blueprint.write","x-owner":"Eranative","x-workset":"W-06","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"brief_id":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","VALIDATED","APPROVED","SUPERSEDED"]},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"components":{"type":"array","items":{"type":"object","properties":{"component_id":{"type":"string"},"requirement_ids":{"type":"array","items":{"type":"string"}},"template":{"type":"object","properties":{"template_id":{"type":"string"},"version":{"type":"string"}},"required":["template_id","version"],"additionalProperties":false},"overlay":{"type":"object","additionalProperties":{},"default":{}},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"readiness":{"type":"string","enum":["TEMPLATE_READY","STAGING_VERIFIED","PRODUCTION_VERIFIED"]},"price_driver_values":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"default":{}},"dependencies":{"type":"array","items":{"type":"string"},"default":[]}},"required":["component_id","requirement_ids","template","owner_ref","readiness"],"additionalProperties":false}},"unresolved":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":"string"},"reason":{"type":"string"}},"required":["requirement_id","reason"],"additionalProperties":false}}},"required":["tenant_id","id","brief_id","version","state","scope_hash","components","unresolved"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brief_id":{"type":"string","format":"uuid"},"brief_version":{"type":"integer"}},"required":["brief_id","brief_version"],"additionalProperties":false}}}}}},"/v1/blueprints/{id}":{"get":{"operationId":"blueprint.get","tags":["W-06"],"summary":"blueprint.get (blueprint.read; owner Eranative)","x-capability":"blueprint.read","x-owner":"Eranative","x-workset":"W-06","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"brief_id":{"type":"string","format":"uuid"},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","VALIDATED","APPROVED","SUPERSEDED"]},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"components":{"type":"array","items":{"type":"object","properties":{"component_id":{"type":"string"},"requirement_ids":{"type":"array","items":{"type":"string"}},"template":{"type":"object","properties":{"template_id":{"type":"string"},"version":{"type":"string"}},"required":["template_id","version"],"additionalProperties":false},"overlay":{"type":"object","additionalProperties":{},"default":{}},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"readiness":{"type":"string","enum":["TEMPLATE_READY","STAGING_VERIFIED","PRODUCTION_VERIFIED"]},"price_driver_values":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"default":{}},"dependencies":{"type":"array","items":{"type":"string"},"default":[]}},"required":["component_id","requirement_ids","template","owner_ref","readiness"],"additionalProperties":false}},"unresolved":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":"string"},"reason":{"type":"string"}},"required":["requirement_id","reason"],"additionalProperties":false}}},"required":["tenant_id","id","brief_id","version","state","scope_hash","components","unresolved"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/estimates":{"post":{"operationId":"estimate.calculate","tags":["W-06"],"summary":"estimate.calculate (brief.read; owner M7/M12)","x-capability":"brief.read","x-owner":"M7/M12","x-workset":"W-06","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"totals":{"type":"object","properties":{"once":{"type":"string"},"monthly":{"type":"string"},"variable":{"type":"string"}},"required":["once","monthly","variable"],"additionalProperties":false},"known_line_ids":{"type":"array","items":{"type":"string"}},"discovery_required":{"type":"array","items":{"type":"string"}},"completeness":{"type":"string","enum":["READY","PARTIAL"]},"lines":{"type":"array","items":{"type":"object","properties":{"line_id":{"type":"string"},"component_id":{"type":"string","nullable":true},"capability_id":{"type":"string"},"plan_version":{"type":"string","nullable":true},"cadence":{"type":"string","enum":["once","monthly","variable"]},"quantity":{"type":"string","default":"1"},"unit":{"type":"string"},"amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"price_status":{"type":"string","enum":["INTERNAL_HYPOTHESIS","APPROVED_ESTIMATE_RANGE","BINDING_QUOTE","ACTIVE_TARIFF","OFFER_REQUIRED"]},"included_in":{"type":"string","nullable":true,"default":null},"billable_from":{"type":"string","enum":["acceptance","delivery","activation"],"default":"delivery"},"cancellation_effect":{"type":"string","default":"end_of_term"},"scope_ref":{"type":"string","nullable":true,"default":null}},"required":["line_id","component_id","capability_id","plan_version","cadence","unit","amount","price_status"],"additionalProperties":false}},"binding":{"type":"boolean","enum":[false]},"rate_card_version":{"type":"string"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"internal":{"type":"object","properties":{"target_margin":{"type":"string"},"once":{"type":"object","properties":{"retail":{"type":"string"},"cost":{"type":"object","properties":{"loaded_labor":{"type":"string"},"hosting":{"type":"string"},"licenses":{"type":"string"},"other_direct":{"type":"string"},"risk":{"type":"string"}},"required":["loaded_labor","hosting","licenses","other_direct","risk"],"additionalProperties":false,"nullable":true},"cost_total":{"type":"string","nullable":true},"contribution_margin":{"type":"string","nullable":true},"gate":{"type":"string","enum":["PASS","FAIL","UNKNOWN","NOT_APPLICABLE"]}},"required":["retail","cost","cost_total","contribution_margin","gate"],"additionalProperties":false},"monthly":{"type":"object","properties":{"retail":{"type":"string"},"cost":{"type":"object","properties":{"loaded_labor":{"type":"string"},"hosting":{"type":"string"},"licenses":{"type":"string"},"other_direct":{"type":"string"},"risk":{"type":"string"}},"required":["loaded_labor","hosting","licenses","other_direct","risk"],"additionalProperties":false,"nullable":true},"cost_total":{"type":"string","nullable":true},"contribution_margin":{"type":"string","nullable":true},"gate":{"type":"string","enum":["PASS","FAIL","UNKNOWN","NOT_APPLICABLE"]}},"required":["retail","cost","cost_total","contribution_margin","gate"],"additionalProperties":false},"margin_gate":{"type":"string","enum":["PASS","FAIL","UNKNOWN"]}},"required":["target_margin","once","monthly","margin_gate"],"additionalProperties":false}},"required":["currency","totals","known_line_ids","discovery_required","completeness","lines","binding","rate_card_version","scope_hash"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"blueprint_id":{"type":"string","format":"uuid"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["blueprint_id","scope_hash","currency"],"additionalProperties":false}}}}}},"/v1/quotes":{"post":{"operationId":"quote.request","tags":["W-07"],"summary":"quote.request (quote.request; owner M7)","x-capability":"quote.request","x-owner":"M7","x-workset":"W-07","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"blueprint_id":{"type":"string","format":"uuid"},"quote_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","ESTIMATED","REQUESTED","REVIEWED","OFFERED","ACCEPTED","EXPIRED","SUPERSEDED"]},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"rate_card_version":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"merchant_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"tax_profile_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"lines":{"type":"array","items":{"type":"object","properties":{"line_id":{"type":"string"},"component_id":{"type":"string","nullable":true},"capability_id":{"type":"string"},"plan_version":{"type":"string","nullable":true},"cadence":{"type":"string","enum":["once","monthly","variable"]},"quantity":{"type":"string","default":"1"},"unit":{"type":"string"},"amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"price_status":{"type":"string","enum":["INTERNAL_HYPOTHESIS","APPROVED_ESTIMATE_RANGE","BINDING_QUOTE","ACTIVE_TARIFF","OFFER_REQUIRED"]},"included_in":{"type":"string","nullable":true,"default":null},"billable_from":{"type":"string","enum":["acceptance","delivery","activation"],"default":"delivery"},"cancellation_effect":{"type":"string","default":"end_of_term"},"scope_ref":{"type":"string","nullable":true,"default":null}},"required":["line_id","component_id","capability_id","plan_version","cadence","unit","amount","price_status"],"additionalProperties":false}},"assumptions":{"type":"array","items":{"type":"string"}},"exclusions":{"type":"array","items":{"type":"string"}},"valid_until":{"type":"string","format":"date-time","nullable":true},"document_hash":{"type":"string","minLength":64,"maxLength":64,"nullable":true},"acceptance_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","blueprint_id","quote_version","state","scope_hash","rate_card_version","currency","merchant_ref","tax_profile_ref","lines","assumptions","exclusions","valid_until","document_hash","acceptance_ref"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"blueprint_id":{"type":"string","format":"uuid"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"notes":{"type":"string","maxLength":4000}},"required":["blueprint_id","scope_hash","currency"],"additionalProperties":false}}}}}},"/v1/quotes/{id}":{"get":{"operationId":"quote.get","tags":["W-07"],"summary":"quote.get (quote.read; owner M7)","x-capability":"quote.read","x-owner":"M7","x-workset":"W-07","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"blueprint_id":{"type":"string","format":"uuid"},"quote_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","ESTIMATED","REQUESTED","REVIEWED","OFFERED","ACCEPTED","EXPIRED","SUPERSEDED"]},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"rate_card_version":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"merchant_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"tax_profile_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"lines":{"type":"array","items":{"type":"object","properties":{"line_id":{"type":"string"},"component_id":{"type":"string","nullable":true},"capability_id":{"type":"string"},"plan_version":{"type":"string","nullable":true},"cadence":{"type":"string","enum":["once","monthly","variable"]},"quantity":{"type":"string","default":"1"},"unit":{"type":"string"},"amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"price_status":{"type":"string","enum":["INTERNAL_HYPOTHESIS","APPROVED_ESTIMATE_RANGE","BINDING_QUOTE","ACTIVE_TARIFF","OFFER_REQUIRED"]},"included_in":{"type":"string","nullable":true,"default":null},"billable_from":{"type":"string","enum":["acceptance","delivery","activation"],"default":"delivery"},"cancellation_effect":{"type":"string","default":"end_of_term"},"scope_ref":{"type":"string","nullable":true,"default":null}},"required":["line_id","component_id","capability_id","plan_version","cadence","unit","amount","price_status"],"additionalProperties":false}},"assumptions":{"type":"array","items":{"type":"string"}},"exclusions":{"type":"array","items":{"type":"string"}},"valid_until":{"type":"string","format":"date-time","nullable":true},"document_hash":{"type":"string","minLength":64,"maxLength":64,"nullable":true},"acceptance_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","blueprint_id","quote_version","state","scope_hash","rate_card_version","currency","merchant_ref","tax_profile_ref","lines","assumptions","exclusions","valid_until","document_hash","acceptance_ref"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/quotes/{id}/accept":{"post":{"operationId":"quote.accept","tags":["W-07"],"summary":"quote.accept (quote.accept; owner M7/L2)","x-capability":"quote.accept","x-owner":"M7/L2","x-workset":"W-07","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"quote":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"blueprint_id":{"type":"string","format":"uuid"},"quote_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["DRAFT","ESTIMATED","REQUESTED","REVIEWED","OFFERED","ACCEPTED","EXPIRED","SUPERSEDED"]},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"rate_card_version":{"type":"string"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"merchant_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"tax_profile_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"lines":{"type":"array","items":{"type":"object","properties":{"line_id":{"type":"string"},"component_id":{"type":"string","nullable":true},"capability_id":{"type":"string"},"plan_version":{"type":"string","nullable":true},"cadence":{"type":"string","enum":["once","monthly","variable"]},"quantity":{"type":"string","default":"1"},"unit":{"type":"string"},"amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"price_status":{"type":"string","enum":["INTERNAL_HYPOTHESIS","APPROVED_ESTIMATE_RANGE","BINDING_QUOTE","ACTIVE_TARIFF","OFFER_REQUIRED"]},"included_in":{"type":"string","nullable":true,"default":null},"billable_from":{"type":"string","enum":["acceptance","delivery","activation"],"default":"delivery"},"cancellation_effect":{"type":"string","default":"end_of_term"},"scope_ref":{"type":"string","nullable":true,"default":null}},"required":["line_id","component_id","capability_id","plan_version","cadence","unit","amount","price_status"],"additionalProperties":false}},"assumptions":{"type":"array","items":{"type":"string"}},"exclusions":{"type":"array","items":{"type":"string"}},"valid_until":{"type":"string","format":"date-time","nullable":true},"document_hash":{"type":"string","minLength":64,"maxLength":64,"nullable":true},"acceptance_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","blueprint_id","quote_version","state","scope_hash","rate_card_version","currency","merchant_ref","tax_profile_ref","lines","assumptions","exclusions","valid_until","document_hash","acceptance_ref"],"additionalProperties":false},"contract_ref":{"type":"string","minLength":1,"maxLength":256},"order_id":{"type":"string","format":"uuid"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["quote","contract_ref","order_id","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_version":{"type":"integer"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"document_hash":{"type":"string","minLength":64,"maxLength":64},"accepted_by":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"authority_evidence_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["name","title","authority_evidence_ref"],"additionalProperties":false}},"required":["quote_version","scope_hash","document_hash","accepted_by"],"additionalProperties":false}}}}}},"/v1/change-requests":{"post":{"operationId":"change.request","tags":["W-07"],"summary":"change.request (blueprint.write; owner M7)","x-capability":"blueprint.write","x-owner":"M7","x-workset":"W-07","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"change_request_id":{"type":"string","format":"uuid"},"new_blueprint_id":{"type":"string","format":"uuid"},"new_scope_hash":{"type":"string","minLength":64,"maxLength":64},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["change_request_id","new_blueprint_id","new_scope_hash","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string","format":"uuid"},"blueprint_id":{"type":"string","format":"uuid"},"description":{"type":"string","minLength":1},"proposed_overlay":{"type":"object","additionalProperties":{},"default":{}}},"required":["quote_id","blueprint_id","description"],"additionalProperties":false}}}}}},"/v1/cart/checkout":{"post":{"operationId":"cart.checkout","tags":["W-08"],"summary":"cart.checkout (cart.purchase; owner M7)","x-capability":"cart.purchase","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"order_id":{"type":"string","format":"uuid"},"checkout_url":{"type":"string","format":"uri"},"provider_session_ref":{"type":"string","minLength":1,"maxLength":256},"expires_at":{"type":"string","format":"date-time"},"totals":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"once":{"type":"string"},"monthly":{"type":"string"},"due_now":{"type":"string"}},"required":["currency","once","monthly","due_now"],"additionalProperties":false},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["order_id","checkout_url","provider_session_ref","expires_at","totals","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"capability_id":{"type":"string","minLength":1},"unit":{"type":"string","minLength":1},"quantity":{"type":"integer","minimum":1,"maximum":20,"default":1}},"required":["capability_id","unit"],"additionalProperties":false},"minItems":1,"maxItems":20},"provider":{"type":"string","enum":["stripe","iyzico"]},"return_url":{"type":"string","format":"uri"},"accept_terms":{"type":"boolean","enum":[true]},"catalog_version":{"type":"string"},"profile":{"type":"object","properties":{"employees":{"type":"integer","minimum":1,"maximum":1000000},"departments":{"type":"integer","minimum":1,"maximum":10000},"branches":{"type":"integer","minimum":1,"maximum":10000},"sector":{"type":"string","maxLength":80},"custom":{"type":"boolean"},"existing_web":{"type":"boolean"}},"required":["employees","departments","branches","sector","custom","existing_web"],"additionalProperties":false},"scope_accepted":{"type":"boolean","enum":[true]}},"required":["items","return_url","accept_terms"],"additionalProperties":false}}}}}},"/v1/orders/{id}/checkout":{"post":{"operationId":"checkout.create","tags":["W-08"],"summary":"checkout.create (contract.accept; owner M7)","x-capability":"contract.accept","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"checkout_url":{"type":"string","format":"uri"},"provider_session_ref":{"type":"string","minLength":1,"maxLength":256},"expires_at":{"type":"string","format":"date-time"}},"required":["checkout_url","provider_session_ref","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["stripe","iyzico"]},"return_url":{"type":"string","format":"uri"}},"required":["provider","return_url"],"additionalProperties":false}}}}}},"/v1/webhooks/{provider}":{"post":{"operationId":"webhook.ingest","tags":["W-08"],"summary":"webhook.ingest (PROVIDER_SIGNATURE; owner M7)","x-capability":"PROVIDER_SIGNATURE","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"type":"boolean"},"duplicate":{"type":"boolean"}},"required":["accepted","duplicate"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"provider payload (signature verified)"}}}}}},"/v1/subscriptions":{"get":{"operationId":"subscription.list","tags":["W-08"],"summary":"subscription.list (subscription.read; owner M7)","x-capability":"subscription.read","x-owner":"M7","x-workset":"W-08","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"capability_id":{"type":"string"},"plan_version":{"type":"string"},"state":{"type":"string","enum":["PENDING","ACTIVE","PAST_DUE","CANCEL_AT_TERM","CANCELLED"]},"commercial_state":{"type":"string","enum":["INTEREST","QUOTABLE","PURCHASABLE","PROVISIONING","ACTIVE","SUSPENDED","CANCEL_AT_TERM","CANCELLED"]},"technical_state":{"type":"string","enum":["NOT_CONNECTED","PROVISIONING","READY","DEGRADED","SUSPENDED","REMOVED"]},"term_end":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer"}},"required":["id","capability_id","plan_version","state","commercial_state","technical_state","term_end","version"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/subscriptions/{id}/preview":{"post":{"operationId":"subscription.preview","tags":["W-08"],"summary":"subscription.preview (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"proration":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"next_invoice":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"effective_at":{"type":"string","format":"date-time"}},"required":["proration","next_invoice","effective_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_plan_version":{"type":"string"},"effective":{"type":"string","enum":["now","term_end"]}},"required":["target_plan_version","effective"],"additionalProperties":false}}}}}},"/v1/subscriptions/{id}/change":{"post":{"operationId":"subscription.change","tags":["W-08"],"summary":"subscription.change (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PENDING","ACTIVE","PAST_DUE","CANCEL_AT_TERM","CANCELLED"]},"version":{"type":"integer"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","version","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_plan_version":{"type":"string"},"effective":{"type":"string","enum":["now","term_end"]},"expected_version":{"type":"integer"}},"required":["target_plan_version","effective","expected_version"],"additionalProperties":false}}}}}},"/v1/subscriptions/{id}/cancel":{"post":{"operationId":"subscription.cancel","tags":["W-08"],"summary":"subscription.cancel (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PENDING","ACTIVE","PAST_DUE","CANCEL_AT_TERM","CANCELLED"]},"term_end":{"type":"string","format":"date-time","nullable":true},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","term_end","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"},"expected_version":{"type":"integer"}},"required":["expected_version"],"additionalProperties":false}}}}}},"/v1/subscriptions/{id}/pause":{"post":{"operationId":"subscription.pause-work","tags":["W-08"],"summary":"subscription.pause-work (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"paused_until":{"type":"string","format":"date-time"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","paused_until","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"until":{"type":"string","format":"date-time"},"expected_version":{"type":"integer"}},"required":["until","expected_version"],"additionalProperties":false}}}}}},"/v1/subscriptions/{id}/resume":{"post":{"operationId":"subscription.resume","tags":["W-08"],"summary":"subscription.resume (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PENDING","ACTIVE","PAST_DUE","CANCEL_AT_TERM","CANCELLED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer"}},"required":["expected_version"],"additionalProperties":false}}}}}},"/v1/billing/portal":{"post":{"operationId":"billing.portal","tags":["W-08"],"summary":"billing.portal (subscription.change; owner M7)","x-capability":"subscription.change","x-owner":"M7","x-workset":"W-08","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"},"url":{"type":"string","format":"uri","nullable":true}},"required":["available","url"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}},"/v1/tasks":{"get":{"operationId":"task.list","tags":["W-09"],"summary":"task.list (task.read; owner process owner)","x-capability":"task.read","x-owner":"process owner","x-workset":"W-09","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"instance_id":{"type":"string","format":"uuid"},"template_id":{"type":"string"},"state":{"type":"string"},"role":{"type":"string"},"due_at":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer"}},"required":["id","instance_id","template_id","state","role","due_at","version"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/processes":{"post":{"operationId":"process.start","tags":["W-09"],"summary":"process.start (task.create; owner process owner)","x-capability":"task.create","x-owner":"process owner","x-workset":"W-09","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"instance_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["RUNNING","WAITING_HUMAN","WAITING_EXTERNAL","FAILED_RETRYABLE","FAILED_FINAL","COMPENSATING","COMPLETED","CANCELLED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["instance_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template_id":{"type":"string"},"template_version":{"type":"string"},"input":{"type":"object","additionalProperties":{}}},"required":["template_id","template_version","input"],"additionalProperties":false}}}}}},"/v1/tasks/{id}/decision":{"post":{"operationId":"task.decide","tags":["W-09"],"summary":"task.decide (approval.decide; owner L2/A5)","x-capability":"approval.decide","x-owner":"L2/A5","x-workset":"W-09","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid"},"instance_state":{"type":"string","enum":["RUNNING","WAITING_HUMAN","WAITING_EXTERNAL","FAILED_RETRYABLE","FAILED_FINAL","COMPENSATING","COMPLETED","CANCELLED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["task_id","instance_state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["APPROVE","REJECT","RETURN"]},"comment":{"type":"string","maxLength":4000},"expected_version":{"type":"integer"}},"required":["decision","expected_version"],"additionalProperties":false}}}}}},"/v1/connections":{"get":{"operationId":"connection.list","tags":["W-10"],"summary":"connection.list (connection.read; owner L7/adapter)","x-capability":"connection.read","x-owner":"L7/adapter","x-workset":"W-10","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"provider":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"direction":{"type":"string","enum":["read","write","bidirectional"]},"scopes":{"type":"array","items":{"type":"string"}},"secret_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"api_version":{"type":"string"},"mapping_version":{"type":"string"},"region":{"type":"string","nullable":true},"retention_days":{"type":"integer","nullable":true},"rate_limit":{"type":"string","nullable":true},"conflict_policy":{"type":"string","enum":["source_wins","target_wins","manual"]},"generation":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["PENDING","ACTIVE","DEGRADED","REVOKED"]},"consent_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","provider","owner_ref","direction","scopes","secret_ref","api_version","mapping_version","region","retention_days","rate_limit","conflict_policy","generation","state","consent_ref"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/connections/{id}/authorize":{"post":{"operationId":"connection.authorize","tags":["W-10"],"summary":"connection.authorize (connection.write; owner L7)","x-capability":"connection.write","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connection":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"provider":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"direction":{"type":"string","enum":["read","write","bidirectional"]},"scopes":{"type":"array","items":{"type":"string"}},"secret_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"api_version":{"type":"string"},"mapping_version":{"type":"string"},"region":{"type":"string","nullable":true},"retention_days":{"type":"integer","nullable":true},"rate_limit":{"type":"string","nullable":true},"conflict_policy":{"type":"string","enum":["source_wins","target_wins","manual"]},"generation":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["PENDING","ACTIVE","DEGRADED","REVOKED"]},"consent_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","provider","owner_ref","direction","scopes","secret_ref","api_version","mapping_version","region","retention_days","rate_limit","conflict_policy","generation","state","consent_ref"],"additionalProperties":false},"authorize_url":{"type":"string","format":"uri","nullable":true},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["connection","authorize_url","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"direction":{"type":"string","enum":["read","write","bidirectional"]},"consent_ref":{"type":"string","minLength":1,"maxLength":256},"external_ref":{"type":"string","maxLength":255}},"required":["provider","scopes","direction","consent_ref"],"additionalProperties":false}}}}}},"/v1/connections/{id}/revoke":{"post":{"operationId":"connection.revoke","tags":["W-10"],"summary":"connection.revoke (connection.write; owner L7)","x-capability":"connection.write","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connection":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"id":{"type":"string","format":"uuid"},"provider":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"direction":{"type":"string","enum":["read","write","bidirectional"]},"scopes":{"type":"array","items":{"type":"string"}},"secret_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"api_version":{"type":"string"},"mapping_version":{"type":"string"},"region":{"type":"string","nullable":true},"retention_days":{"type":"integer","nullable":true},"rate_limit":{"type":"string","nullable":true},"conflict_policy":{"type":"string","enum":["source_wins","target_wins","manual"]},"generation":{"type":"integer","exclusiveMinimum":true,"minimum":0},"state":{"type":"string","enum":["PENDING","ACTIVE","DEGRADED","REVOKED"]},"consent_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["tenant_id","id","provider","owner_ref","direction","scopes","secret_ref","api_version","mapping_version","region","retention_days","rate_limit","conflict_policy","generation","state","consent_ref"],"additionalProperties":false},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["connection","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"additionalProperties":false}}}}}},"/v1/connections/{id}/sync":{"post":{"operationId":"connection.sync","tags":["W-10"],"summary":"connection.sync (connection.write; owner adapter owner)","x-capability":"connection.write","x-owner":"adapter owner","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"generation":{"type":"integer"}},"required":["job_id","generation"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["full","delta"],"default":"delta"}},"additionalProperties":false}}}}}},"/v1/calendar/bookings":{"get":{"operationId":"calendar.bookings","tags":["W-10"],"summary":"calendar.bookings (calendar.read; owner L7)","x-capability":"calendar.read","x-owner":"L7","x-workset":"W-10","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"google":{"type":"object","properties":{"available":{"type":"boolean"},"connection_id":{"type":"string","format":"uuid","nullable":true},"state":{"type":"string","enum":["PENDING","ACTIVE","DEGRADED","REVOKED"],"nullable":true},"account_email":{"type":"string","nullable":true}},"required":["available","connection_id","state","account_email"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"booking_ref":{"type":"string"},"connection_id":{"type":"string","format":"uuid"},"provider_event_id":{"type":"string","nullable":true},"html_link":{"type":"string","nullable":true},"title":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"time_zone":{"type":"string"},"state":{"type":"string","enum":["ACTIVE","CANCELLED"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","booking_ref","connection_id","provider_event_id","html_link","title","starts_at","ends_at","time_zone","state","version"],"additionalProperties":false}}},"required":["google","items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"calendar.booking.create","tags":["W-10"],"summary":"calendar.booking.create (calendar.write; owner L7)","x-capability":"calendar.write","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"booking_ref":{"type":"string"},"connection_id":{"type":"string","format":"uuid"},"provider_event_id":{"type":"string","nullable":true},"html_link":{"type":"string","nullable":true},"title":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"time_zone":{"type":"string"},"state":{"type":"string","enum":["ACTIVE","CANCELLED"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","booking_ref","connection_id","provider_event_id","html_link","title","starts_at","ends_at","time_zone","state","version"],"additionalProperties":false},"replayed":{"type":"boolean"}},"required":["booking","replayed"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"booking_ref":{"type":"string","pattern":"^(task|quote):[0-9a-f-]{36}$"},"title":{"type":"string","minLength":1,"maxLength":300},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"time_zone":{"type":"string","minLength":1,"maxLength":64},"approved":{"type":"boolean","enum":[true]}},"required":["booking_ref","title","start","end","time_zone","approved"],"additionalProperties":false}}}}}},"/v1/calendar/availability":{"post":{"operationId":"calendar.availability","tags":["W-10"],"summary":"calendar.availability (calendar.read; owner L7)","x-capability":"calendar.read","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connected":{"type":"boolean"},"busy":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"}},"required":["start","end"],"additionalProperties":false}}},"required":["connected","busy"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"time_min":{"type":"string","format":"date-time"},"time_max":{"type":"string","format":"date-time"}},"required":["time_min","time_max"],"additionalProperties":false}}}}}},"/v1/calendar/bookings/{id}":{"patch":{"operationId":"calendar.booking.update","tags":["W-10"],"summary":"calendar.booking.update (calendar.write; owner L7)","x-capability":"calendar.write","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"booking_ref":{"type":"string"},"connection_id":{"type":"string","format":"uuid"},"provider_event_id":{"type":"string","nullable":true},"html_link":{"type":"string","nullable":true},"title":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"time_zone":{"type":"string"},"state":{"type":"string","enum":["ACTIVE","CANCELLED"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","booking_ref","connection_id","provider_event_id","html_link","title","starts_at","ends_at","time_zone","state","version"],"additionalProperties":false}},"required":["booking"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"time_zone":{"type":"string","minLength":1,"maxLength":64},"approved":{"type":"boolean","enum":[true]}},"required":["expected_version","start","end","time_zone","approved"],"additionalProperties":false}}}}}},"/v1/calendar/bookings/{id}/cancel":{"post":{"operationId":"calendar.booking.cancel","tags":["W-10"],"summary":"calendar.booking.cancel (calendar.write; owner L7)","x-capability":"calendar.write","x-owner":"L7","x-workset":"W-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"booking_ref":{"type":"string"},"connection_id":{"type":"string","format":"uuid"},"provider_event_id":{"type":"string","nullable":true},"html_link":{"type":"string","nullable":true},"title":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"time_zone":{"type":"string"},"state":{"type":"string","enum":["ACTIVE","CANCELLED"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["id","booking_ref","connection_id","provider_event_id","html_link","title","starts_at","ends_at","time_zone","state","version"],"additionalProperties":false}},"required":["booking"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"approved":{"type":"boolean","enum":[true]}},"required":["expected_version","approved"],"additionalProperties":false}}}}}},"/v1/ai/jobs":{"post":{"operationId":"ai.invoke","tags":["W-11"],"summary":"ai.invoke (ai.invoke; owner PAL/M12)","x-capability":"ai.invoke","x-owner":"PAL/M12","x-workset":"W-11","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"reservation_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["RESERVED","SETTLED","RELEASED","RESERVED_UNKNOWN","ESCALATED","RECONCILED_PROVIDER_INVOICE","WRITTEN_OFF_SET_EXPENSE"]},"retail_reserved":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false}},"required":["job_id","reservation_id","state","retail_reserved"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task":{"type":"string"},"input_ref":{"type":"string","minLength":1,"maxLength":256},"tier_max":{"type":"string","enum":["L0","L1","L2"],"default":"L1"},"purpose":{"type":"string"},"max_retail":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false}},"required":["task","input_ref","purpose"],"additionalProperties":false}}}}}},"/v1/usage":{"get":{"operationId":"usage.get","tags":["W-11"],"summary":"usage.get (usage.read; owner M12)","x-capability":"usage.read","x-owner":"M12","x-workset":"W-11","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string"},"included":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"consumed":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"reserved":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"debt":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"cap":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false,"nullable":true},"debt_mode":{"type":"string","enum":["STOP","GRACE","PAYG"]},"threshold_percent":{"type":"number"},"unknown_count":{"type":"integer"}},"required":["period","included","consumed","reserved","debt","cap","debt_mode","threshold_percent","unknown_count"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/credits/checkout":{"post":{"operationId":"credit.purchase","tags":["W-11"],"summary":"credit.purchase (credit.purchase; owner M7/M12)","x-capability":"credit.purchase","x-owner":"M7/M12","x-workset":"W-11","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"checkout_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["checkout_url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,8})?$"}},"required":["currency","amount"],"additionalProperties":false},"provider":{"type":"string","enum":["stripe","iyzico"]},"return_url":{"type":"string","format":"uri"}},"required":["amount","provider","return_url"],"additionalProperties":false}}}}}},"/v1/usage/debt-policy":{"post":{"operationId":"debt.approve","tags":["W-11"],"summary":"debt.approve (payg.approve; owner M12/L7)","x-capability":"payg.approve","x-owner":"M12/L7","x-workset":"W-11","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"policy":{"type":"object","properties":{"billing_account_ref":{"type":"string","minLength":1,"maxLength":256},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"included_monthly_retail":{"type":"string"},"debt_mode":{"type":"string","enum":["STOP","GRACE","PAYG"]},"payg_cap":{"type":"string","nullable":true},"grace_ratio":{"type":"string","enum":["0.15"]},"thresholds_percent":{"type":"array","minItems":4,"maxItems":4,"items":[{"type":"number","enum":[80]},{"type":"number","enum":[90]},{"type":"number","enum":[100]},{"type":"number","enum":[115]}]}},"required":["billing_account_ref","currency","included_monthly_retail","debt_mode","payg_cap","grace_ratio","thresholds_percent"],"additionalProperties":false},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["policy","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"debt_mode":{"type":"string","enum":["STOP","GRACE","PAYG"]},"payg_cap":{"type":"string","nullable":true},"approved_by":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"authority_evidence_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["name","title","authority_evidence_ref"],"additionalProperties":false}},"required":["debt_mode","payg_cap","approved_by"],"additionalProperties":false}}}}}},"/v1/installations/plan":{"post":{"operationId":"factory.plan","tags":["W-12"],"summary":"factory.plan (factory.plan; owner Eranative/owners)","x-capability":"factory.plan","x-owner":"Eranative/owners","x-workset":"W-12","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object","properties":{"manifest_version":{"type":"string"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"blueprint_id":{"type":"string","format":"uuid"},"modules":{"type":"array","items":{"type":"object","properties":{"module_id":{"type":"string"},"version":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"entitlement_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"migration_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"rollback_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["module_id","version","owner_ref","entitlement_ref","migration_ref","rollback_ref"],"additionalProperties":false}},"steps":{"type":"array","items":{"type":"object","properties":{"step_id":{"type":"string"},"kind":{"type":"string","enum":["config","migration","adapter","verify"]},"idempotency_key":{"type":"string"},"compensation":{"type":"string","nullable":true},"depends_on":{"type":"array","items":{"type":"string"},"default":[]}},"required":["step_id","kind","idempotency_key","compensation"],"additionalProperties":false}}},"required":["manifest_version","scope_hash","blueprint_id","modules","steps"],"additionalProperties":false},"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]}},"required":["manifest","job_id","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"blueprint_id":{"type":"string","format":"uuid"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"contract_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["blueprint_id","scope_hash","contract_ref"],"additionalProperties":false}}}}}},"/v1/installations":{"post":{"operationId":"factory.start","tags":["W-12"],"summary":"factory.start (factory.apply; owner Eranative/owners)","x-capability":"factory.apply","x-owner":"Eranative/owners","x-workset":"W-12","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["job_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object","properties":{"manifest_version":{"type":"string"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"blueprint_id":{"type":"string","format":"uuid"},"modules":{"type":"array","items":{"type":"object","properties":{"module_id":{"type":"string"},"version":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"entitlement_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"migration_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"rollback_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["module_id","version","owner_ref","entitlement_ref","migration_ref","rollback_ref"],"additionalProperties":false}},"steps":{"type":"array","items":{"type":"object","properties":{"step_id":{"type":"string"},"kind":{"type":"string","enum":["config","migration","adapter","verify"]},"idempotency_key":{"type":"string"},"compensation":{"type":"string","nullable":true},"depends_on":{"type":"array","items":{"type":"string"},"default":[]}},"required":["step_id","kind","idempotency_key","compensation"],"additionalProperties":false}}},"required":["manifest_version","scope_hash","blueprint_id","modules","steps"],"additionalProperties":false},"approved_by_actor":{"type":"string","format":"uuid"}},"required":["manifest","approved_by_actor"],"additionalProperties":false}}}}}},"/v1/installations/{id}":{"get":{"operationId":"factory.get","tags":["W-12"],"summary":"factory.get (blueprint.read; owner Eranative)","x-capability":"blueprint.read","x-owner":"Eranative","x-workset":"W-12","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]},"steps":{"type":"array","items":{"type":"object","properties":{"step_id":{"type":"string"},"state":{"type":"string"},"evidence_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["step_id","state","evidence_ref"],"additionalProperties":false}}},"required":["job_id","state","steps"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/installations/{id}/resume":{"post":{"operationId":"factory.resume","tags":["W-12"],"summary":"factory.resume (factory.apply; owner Eranative/owners)","x-capability":"factory.apply","x-owner":"Eranative/owners","x-workset":"W-12","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]}},"required":["job_id","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from_step_id":{"type":"string"}},"additionalProperties":false}}}}}},"/v1/installations/{id}/upgrade":{"post":{"operationId":"factory.upgrade","tags":["W-12"],"summary":"factory.upgrade (factory.apply; owner Eranative/owners)","x-capability":"factory.apply","x-owner":"Eranative/owners","x-workset":"W-12","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]}},"required":["job_id","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object","properties":{"manifest_version":{"type":"string"},"scope_hash":{"type":"string","minLength":64,"maxLength":64},"blueprint_id":{"type":"string","format":"uuid"},"modules":{"type":"array","items":{"type":"object","properties":{"module_id":{"type":"string"},"version":{"type":"string"},"owner_ref":{"type":"string","minLength":1,"maxLength":256},"entitlement_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"migration_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true},"rollback_ref":{"type":"string","minLength":1,"maxLength":256,"nullable":true}},"required":["module_id","version","owner_ref","entitlement_ref","migration_ref","rollback_ref"],"additionalProperties":false}},"steps":{"type":"array","items":{"type":"object","properties":{"step_id":{"type":"string"},"kind":{"type":"string","enum":["config","migration","adapter","verify"]},"idempotency_key":{"type":"string"},"compensation":{"type":"string","nullable":true},"depends_on":{"type":"array","items":{"type":"string"},"default":[]}},"required":["step_id","kind","idempotency_key","compensation"],"additionalProperties":false}}},"required":["manifest_version","scope_hash","blueprint_id","modules","steps"],"additionalProperties":false}},"required":["manifest"],"additionalProperties":false}}}}}},"/v1/installations/{id}/rollback":{"post":{"operationId":"factory.rollback","tags":["W-12"],"summary":"factory.rollback (release.rollback; owner Eranative/owners)","x-capability":"release.rollback","x-owner":"Eranative/owners","x-workset":"W-12","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["PLANNED","APPROVED","RUNNING","VERIFYING","ACTIVE","FAILED_RETRYABLE","COMPENSATING","ROLLED_BACK"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["job_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to_release_ref":{"type":"string","minLength":1,"maxLength":256},"reason":{"type":"string"}},"required":["to_release_ref","reason"],"additionalProperties":false}}}}}},"/v1/documents/uploads":{"post":{"operationId":"document.upload-init","tags":["W-13"],"summary":"document.upload-init (document.write; owner document owner)","x-capability":"document.write","x-owner":"document owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"upload_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["document_id","upload_url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"mime":{"type":"string"},"size_bytes":{"type":"integer","exclusiveMinimum":true,"minimum":0},"classification":{"type":"string","enum":["public","internal","confidential","personal"]},"original_locale":{"type":"string","minLength":2,"maxLength":10}},"required":["filename","mime","size_bytes","classification"],"additionalProperties":false}}}}}},"/v1/documents/{id}/complete":{"post":{"operationId":"document.upload-complete","tags":["W-13"],"summary":"document.upload-complete (document.write; owner document owner)","x-capability":"document.write","x-owner":"document owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["QUARANTINE","SCANNED","REVIEW","PUBLISHED","ARCHIVED","DELETED"]}},"required":["document_id","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"etag":{"type":"string","minLength":1}},"additionalProperties":false}}}}}},"/v1/documents/{id}":{"get":{"operationId":"document.get","tags":["W-13"],"summary":"document.get (document.read; owner document owner)","x-capability":"document.read","x-owner":"document owner","x-workset":"W-13","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["QUARANTINE","SCANNED","REVIEW","PUBLISHED","ARCHIVED","DELETED"]},"filename":{"type":"string"},"mime":{"type":"string"},"download_url":{"type":"string","format":"uri","nullable":true},"translation_state":{"type":"string","enum":["PENDING","DONE","FAILED","NOT_REQUIRED"]},"display_name":{"type":"string","nullable":true},"original_locale":{"type":"string","nullable":true},"scan_verdict":{"type":"string","nullable":true}},"required":["document_id","state","filename","mime","download_url","translation_state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/knowledge/search":{"post":{"operationId":"knowledge.search","tags":["W-13"],"summary":"knowledge.search (knowledge.search; owner knowledge owner)","x-capability":"knowledge.search","x-owner":"knowledge owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"hits":{"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"chunk_ref":{"type":"string","minLength":1,"maxLength":256},"score":{"type":"number"},"snippet":{"type":"string"}},"required":["document_id","chunk_ref","score","snippet"],"additionalProperties":false}}},"required":["hits"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1},"top_k":{"type":"integer","minimum":1,"maximum":50,"default":8},"purpose":{"type":"string"}},"required":["query","purpose"],"additionalProperties":false}}}}}},"/v1/cases":{"get":{"operationId":"case.list","tags":["W-13"],"summary":"case.list (case.read; owner case owner)","x-capability":"case.read","x-owner":"case owner","x-workset":"W-13","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"subject":{"type":"string"},"state":{"type":"string","enum":["NEW","TRIAGED","IN_PROGRESS","WAITING_CUSTOMER","WAITING_INTERNAL","RESOLVED","CLOSED","REOPENED"]},"channel":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","subject","state","channel","updated_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"case.create","tags":["W-13"],"summary":"case.create (case.write; owner case owner)","x-capability":"case.write","x-owner":"case owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["NEW","TRIAGED","IN_PROGRESS","WAITING_CUSTOMER","WAITING_INTERNAL","RESOLVED","CLOSED","REOPENED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string"},"body":{"type":"string"},"channel":{"type":"string","enum":["web","email","whatsapp","phone"]},"customer_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["subject","body","channel"],"additionalProperties":false}}}}}},"/v1/cases/{id}/messages":{"post":{"operationId":"case.message","tags":["W-13"],"summary":"case.message (case.write; owner case owner)","x-capability":"case.write","x-owner":"case owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string","format":"uuid"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["message_id","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string"},"visibility":{"type":"string","enum":["customer","internal"]}},"required":["body","visibility"],"additionalProperties":false}}}}}},"/v1/cases/{id}/handoff":{"post":{"operationId":"case.handoff","tags":["W-13"],"summary":"case.handoff (case.write; owner case owner)","x-capability":"case.write","x-owner":"case owner","x-workset":"W-13","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["NEW","TRIAGED","IN_PROGRESS","WAITING_CUSTOMER","WAITING_INTERNAL","RESOLVED","CLOSED","REOPENED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to_role":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]},"reason":{"type":"string"}},"required":["to_role","reason"],"additionalProperties":false}}}}}},"/v1/publications/preview":{"post":{"operationId":"publication.preview","tags":["W-15"],"summary":"publication.preview (catalog.write; owner M2/Voriq)","x-capability":"catalog.write","x-owner":"M2/Voriq","x-workset":"W-15","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"listing_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["DRAFT","VALIDATED","AWAITING_APPROVAL","QUEUED","PUBLISHED","REJECTED","STALE","CONFLICT","WITHDRAWN","DEGRADED"]},"issues":{"type":"array","items":{"type":"string"}}},"required":["listing_id","state","issues"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"channel":{"type":"string"}},"required":["listing_ids","channel"],"additionalProperties":false}}}}}},"/v1/publications":{"post":{"operationId":"publication.publish","tags":["W-15"],"summary":"publication.publish (catalog.publish; owner Voriq)","x-capability":"catalog.publish","x-owner":"Voriq","x-workset":"W-15","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"publication_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["DRAFT","VALIDATED","AWAITING_APPROVAL","QUEUED","PUBLISHED","REJECTED","STALE","CONFLICT","WITHDRAWN","DEGRADED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["publication_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"listing_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"channel":{"type":"string"},"approval_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["listing_ids","channel"],"additionalProperties":false}}}}}},"/v1/listings":{"get":{"operationId":"listing.list","tags":["W-15"],"summary":"listing.list (catalog.write; owner M2/Voriq)","x-capability":"catalog.write","x-owner":"M2/Voriq","x-workset":"W-15","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"simulated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_ref":{"type":"string"},"channel":{"type":"string"},"locale":{"type":"string"},"title":{"type":"string","nullable":true},"source_revision":{"type":"integer"},"availability":{"type":"string","enum":["AVAILABLE","OUT_OF_STOCK","UNKNOWN"]},"sellable":{"type":"boolean"},"publication_state":{"type":"string","enum":["DRAFT","VALIDATED","AWAITING_APPROVAL","QUEUED","PUBLISHED","REJECTED","STALE","CONFLICT","WITHDRAWN","DEGRADED"],"nullable":true}},"required":["id","product_ref","channel","locale","title","source_revision","availability","sellable","publication_state"],"additionalProperties":false}}},"required":["simulated","items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/publications/{id}/withdraw":{"post":{"operationId":"publication.withdraw","tags":["W-15"],"summary":"publication.withdraw (catalog.publish; owner Voriq)","x-capability":"catalog.publish","x-owner":"Voriq","x-workset":"W-15","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"publication_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["DRAFT","VALIDATED","AWAITING_APPROVAL","QUEUED","PUBLISHED","REJECTED","STALE","CONFLICT","WITHDRAWN","DEGRADED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["publication_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"],"additionalProperties":false}}}}}},"/v1/accessibility":{"get":{"operationId":"accessibility.get","tags":["W-17"],"summary":"accessibility.get (accessibility.read; owner AccessPulse)","x-capability":"accessibility.read","x-owner":"AccessPulse","x-workset":"W-17","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"number","nullable":true},"issues":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"url":{"type":"string"}},"required":["rule","severity","url"],"additionalProperties":false}},"last_checked":{"type":"string","format":"date-time","nullable":true},"simulated":{"type":"boolean"},"state":{"type":"string","enum":["QUEUED","RUNNING","PASS","FAIL","PARTIAL","ERROR"],"nullable":true},"coverage":{"type":"object","additionalProperties":{}},"pending_job_id":{"type":"string","format":"uuid","nullable":true}},"required":["score","issues","last_checked","simulated"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/accessibility/retest":{"post":{"operationId":"accessibility.retest","tags":["W-17"],"summary":"accessibility.retest (accessibility.write; owner AccessPulse)","x-capability":"accessibility.write","x-owner":"AccessPulse","x-workset":"W-17","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"}},"required":["job_id"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false}}}}}},"/v1/csr/leave":{"post":{"operationId":"csr.leave","tags":["W-17"],"summary":"csr.leave (csr.join; owner GoodnessBridge)","x-capability":"csr.join","x-owner":"GoodnessBridge","x-workset":"W-17","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"program_ref":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["LEFT"]}},"required":["program_ref","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"program_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["program_ref"],"additionalProperties":false}}}}}},"/v1/csr/join":{"post":{"operationId":"csr.join","tags":["W-17"],"summary":"csr.join (csr.join; owner GoodnessBridge)","x-capability":"csr.join","x-owner":"GoodnessBridge","x-workset":"W-17","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"membership_ref":{"type":"string","minLength":1,"maxLength":256},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["membership_ref","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"program_ref":{"type":"string","minLength":1,"maxLength":256},"consent_ref":{"type":"string","minLength":1,"maxLength":256}},"required":["program_ref","consent_ref"],"additionalProperties":false}}}}}},"/v1/dashboard":{"get":{"operationId":"dashboard.get","tags":["W-18"],"summary":"dashboard.get (authenticated; owner projection owners)","x-capability":"authenticated","x-owner":"projection owners","x-workset":"W-18","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"value":{},"state":{"type":"string","enum":["loading","empty","partial","error","forbidden","stale","success"]},"as_of":{"type":"string","format":"date-time","nullable":true},"source":{"type":"string"}},"required":["id","kind","state","as_of","source"],"additionalProperties":false}}},"required":["tiles"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/customer/program":{"get":{"operationId":"customer.program","tags":["W-28"],"summary":"customer.program (authenticated; owner projection owners)","x-capability":"authenticated","x-owner":"projection owners","x-workset":"W-28","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","format":"date-time"},"widgets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_ref":{"type":"string"},"as_of":{"type":"string","format":"date-time"},"state":{"type":"string","enum":["loading","empty","partial","error","forbidden","stale","success"]},"value":{}},"required":["id","source_ref","as_of","state"],"additionalProperties":false}}},"required":["as_of","widgets"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/workspace":{"get":{"operationId":"workspace.get","tags":["W-04"],"summary":"workspace.get (authenticated; owner M4/M8)","x-capability":"authenticated","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"country":{"type":"string"},"sector":{"type":"string"},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"employee_band":{"type":"string"},"version":{"type":"integer"}},"required":["tenant_id","name","country","sector","primary_locale","employee_band","version"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]},"patch":{"operationId":"workspace.update","tags":["W-04"],"summary":"workspace.update (workspace.manage; owner M4/M8)","x-capability":"workspace.manage","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"version":{"type":"integer"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["tenant_id","version","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer"},"name":{"type":"string","minLength":1,"maxLength":120},"country":{"type":"string","minLength":2,"maxLength":2},"sector":{"type":"string","minLength":1,"maxLength":80},"primary_locale":{"type":"string","enum":["tr","en","es","de","fr","it","pt","zh","ja","ar","ur","hi","pl","nl","sv","da","nb","ru","uk","fi","cs","sk","hu","ro","el","bg","hr","sl","et","lv","lt","ca"]},"employee_band":{"type":"string","enum":["1-9","10-49","50-249","250-999","1000+"]}},"required":["expected_version"],"additionalProperties":false}}}}}},"/v1/memberships":{"get":{"operationId":"membership.list","tags":["W-04"],"summary":"membership.list (membership.read; owner M4/M8)","x-capability":"membership.read","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"person_id":{"type":"string","format":"uuid"},"display_name":{"type":"string"},"roles":{"type":"array","items":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]}},"since":{"type":"string","format":"date-time"},"is_me":{"type":"boolean"}},"required":["person_id","display_name","roles","since","is_me"],"additionalProperties":false}},"invitations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"role":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]},"state":{"type":"string","enum":["PENDING","ACCEPTED","EXPIRED","REVOKED"]},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"}},"required":["id","role","state","expires_at","created_at"],"additionalProperties":false}}},"required":["members","invitations"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/memberships/{id}/roles":{"post":{"operationId":"membership.update","tags":["W-04"],"summary":"membership.update (membership.manage; owner M4/M8)","x-capability":"membership.manage","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"person_id":{"type":"string","format":"uuid"},"roles":{"type":"array","items":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]}},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["person_id","roles","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"roles":{"type":"array","items":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]},"minItems":1,"maxItems":6}},"required":["roles"],"additionalProperties":false}}}}}},"/v1/memberships/{id}/remove":{"post":{"operationId":"membership.remove","tags":["W-04"],"summary":"membership.remove (membership.manage; owner M4/M8)","x-capability":"membership.manage","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"person_id":{"type":"string","format":"uuid"},"removed_roles":{"type":"array","items":{"type":"string","enum":["owner","billing","catalog","support","viewer","employee","department_manager","customer","partner","finance","studio_architect","delivery_operator","ops","founder"]}},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["person_id","removed_roles","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":500}},"additionalProperties":false}}}}}},"/v1/invitations/{id}/revoke":{"post":{"operationId":"invitation.revoke","tags":["W-04"],"summary":"invitation.revoke (membership.invite; owner M4/M8)","x-capability":"membership.invite","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"invitation_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["REVOKED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["invitation_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}},"/v1/notifications/read":{"post":{"operationId":"notification.read","tags":["W-18"],"summary":"notification.read (authenticated; owner KG-01)","x-capability":"authenticated","x-owner":"KG-01","x-workset":"W-18","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer"},"unread":{"type":"integer"}},"required":["updated","unread"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":200},"all":{"type":"boolean"}},"additionalProperties":false}}}}}},"/v1/notification-preferences":{"get":{"operationId":"notification.preferences.get","tags":["W-18"],"summary":"notification.preferences.get (authenticated; owner KG-01)","x-capability":"authenticated","x-owner":"KG-01","x-workset":"W-18","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"email_enabled":{"type":"boolean"},"muted_types":{"type":"array","items":{"type":"string"}},"version":{"type":"integer"}},"required":["email_enabled","muted_types","version"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]},"put":{"operationId":"notification.preferences.update","tags":["W-18"],"summary":"notification.preferences.update (authenticated; owner KG-01)","x-capability":"authenticated","x-owner":"KG-01","x-workset":"W-18","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"email_enabled":{"type":"boolean"},"muted_types":{"type":"array","items":{"type":"string"}},"version":{"type":"integer"}},"required":["email_enabled","muted_types","version"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email_enabled":{"type":"boolean"},"muted_types":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":50}},"required":["email_enabled","muted_types"],"additionalProperties":false}}}}}},"/v1/templates":{"get":{"operationId":"template.list","tags":["W-06"],"summary":"template.list (authenticated; owner Eranative)","x-capability":"authenticated","x-owner":"Eranative","x-workset":"W-06","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"version":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"sector":{"type":"string","nullable":true},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["id","kind","version","title","summary","sector","capabilities"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/notifications":{"get":{"operationId":"notification.list","tags":["W-18"],"summary":"notification.list (authenticated; owner KG-01)","x-capability":"authenticated","x-owner":"KG-01","x-workset":"W-18","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"title":{"type":"string"},"read":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"}},"required":["id","type","title","read","created_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/account/deletion-requests":{"post":{"operationId":"account.deletion.request","tags":["W-04"],"summary":"account.deletion.request (authenticated; owner M4/M8)","x-capability":"authenticated","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["QUEUED","IN_REVIEW"]},"created_at":{"type":"string","format":"date-time"},"retain_invoices":{"type":"boolean","enum":[true]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["request_id","state","created_at","retain_invoices","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm":{"type":"boolean","enum":[true]},"reason":{"type":"string","maxLength":1000}},"required":["confirm"],"additionalProperties":false}}}}},"get":{"operationId":"account.deletion.get","tags":["W-04"],"summary":"account.deletion.get (authenticated; owner M4/M8)","x-capability":"authenticated","x-owner":"M4/M8","x-workset":"W-04","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["QUEUED","IN_REVIEW","COMPLETED","REJECTED","WITHDRAWN"]},"created_at":{"type":"string","format":"date-time"},"processed_at":{"type":"string","format":"date-time","nullable":true},"retain_invoices":{"type":"boolean"}},"required":["request_id","state","created_at","processed_at","retain_invoices"],"additionalProperties":false,"nullable":true}},"required":["request"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/exports":{"post":{"operationId":"export.request","tags":["W-19"],"summary":"export.request (export.request; owner domain owner)","x-capability":"export.request","x-owner":"domain owner","x-workset":"W-19","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["QUEUED","RUNNING","READY","FAILED"]}},"required":["export_id","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["data","audit","documents","usage"]},"format":{"type":"string","enum":["json","csv"]},"range":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"],"additionalProperties":false}},"required":["kind","format"],"additionalProperties":false}}}}}},"/v1/exports/{id}":{"get":{"operationId":"export.get","tags":["W-19"],"summary":"export.get (export.request; owner domain owner)","x-capability":"export.request","x-owner":"domain owner","x-workset":"W-19","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"export_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["data","audit","documents","usage"]},"format":{"type":"string","enum":["json","csv"]},"state":{"type":"string","enum":["QUEUED","RUNNING","READY","FAILED","EXPIRED"]},"manifest":{"type":"object","additionalProperties":{},"nullable":true},"download_url":{"type":"string","format":"uri","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true}},"required":["export_id","kind","format","state","manifest","download_url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/releases/{id}/canary":{"post":{"operationId":"release.canary","tags":["W-20"],"summary":"release.canary (release.authorize; owner release owner)","x-capability":"release.authorize","x-owner":"release owner","x-workset":"W-20","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"canary_ref":{"type":"string","minLength":1,"maxLength":256},"state":{"type":"string","enum":["RUNNING","PASSED","FAILED"]}},"required":["canary_ref","state"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"percent":{"type":"integer","minimum":1,"maximum":50},"metrics":{"type":"array","items":{"type":"string"}}},"required":["percent","metrics"],"additionalProperties":false}}}}}},"/v1/releases/{id}/go":{"post":{"operationId":"release.go","tags":["W-20"],"summary":"release.go (release.authorize; owner release owner)","x-capability":"release.authorize","x-owner":"release owner","x-workset":"W-20","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"release_ref":{"type":"string","minLength":1,"maxLength":256},"go_decision":{"type":"string","enum":["GO","NO_GO"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["release_ref","go_decision","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"canary_ref":{"type":"string","minLength":1,"maxLength":256},"evidence_refs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"minItems":1},"approved_by_actor":{"type":"string","format":"uuid"}},"required":["canary_ref","evidence_refs","approved_by_actor"],"additionalProperties":false}}}}}},"/v1/tg/intake":{"post":{"operationId":"tg.intake.submit","tags":["WS-08"],"summary":"tg.intake.submit (PUBLIC; owner tenant)","x-capability":"PUBLIC","x-owner":"tenant","x-workset":"WS-08","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"public_ref":{"type":"string","pattern":"^TG-\\d{4}-\\d{5}$"},"state":{"type":"string","enum":["SUBMITTED"]},"submitted_at":{"type":"string","format":"date-time"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["public_ref","state","submitted_at","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"service_id":{"type":"string","enum":["law","company","logistics","residency","visa","driver","leasing","accounting","insurance","education","investment","consulting","europe"]},"locale":{"type":"string","enum":["tr","pl","en","ru"]},"contact":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"email":{"type":"string","format":"email","maxLength":200},"phone":{"type":"string","maxLength":32}},"required":["name","email"],"additionalProperties":false},"nationality":{"type":"string","minLength":2,"maxLength":80},"in_poland":{"type":"boolean"},"topic":{"type":"string","maxLength":40},"message":{"type":"string","maxLength":2000,"default":""},"documents":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","maxLength":32},"name":{"type":"string","maxLength":120},"size":{"type":"integer","minimum":0,"maximum":20971520}},"required":["code","name","size"],"additionalProperties":false},"maxItems":20,"default":[]},"consent":{"type":"boolean","enum":[true]},"website":{"type":"string","maxLength":0},"source":{"type":"object","properties":{"page":{"type":"string","maxLength":200},"campaign":{"type":"string","maxLength":64},"conversation_ref":{"type":"string","maxLength":128}},"additionalProperties":false}},"required":["service_id","locale","contact","nationality","in_poland","topic","consent"],"additionalProperties":false}}}}}},"/v1/tg/intake/status":{"post":{"operationId":"tg.intake.status","tags":["WS-08"],"summary":"tg.intake.status (PUBLIC; owner tenant)","x-capability":"PUBLIC","x-owner":"tenant","x-workset":"WS-08","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"public_ref":{"type":"string","pattern":"^TG-\\d{4}-\\d{5}$"},"service_id":{"type":"string","enum":["law","company","logistics","residency","visa","driver","leasing","accounting","insurance","education","investment","consulting","europe"]},"state":{"type":"string","enum":["DRAFT","SUBMITTED","TRIAGE","NEEDS_INFO","ELIGIBLE","DECLINED","CONVERTED","WITHDRAWN"]},"stage":{"type":"integer","minimum":0,"maximum":4},"submitted_at":{"type":"string","format":"date-time","nullable":true},"updated_at":{"type":"string","format":"date-time"},"missing":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"}},"required":["kind","code"],"additionalProperties":false}},"documents":{"type":"array","items":{"type":"object","properties":{"link_id":{"type":"string","format":"uuid"},"document_id":{"type":"string","format":"uuid"},"checklist_code":{"type":"string","nullable":true},"filename":{"type":"string"},"state":{"type":"string","enum":["UPLOADED","ACCEPTED","REJECTED"]},"scan":{"type":"string"},"review_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"}},"required":["link_id","document_id","checklist_code","filename","state","scan","review_note","created_at"],"additionalProperties":false}}},"required":["public_ref","service_id","state","stage","submitted_at","updated_at","missing","documents"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"public_ref":{"type":"string","pattern":"^TG-\\d{4}-\\d{5}$"},"email":{"type":"string","format":"email","maxLength":200}},"required":["public_ref","email"],"additionalProperties":false}}}}}},"/v1/tg/applications":{"get":{"operationId":"tg.application.list","tags":["WS-08"],"summary":"tg.application.list (authenticated; owner tenant)","x-capability":"authenticated","x-owner":"tenant","x-workset":"WS-08","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"service_id":{"type":"string","enum":["law","company","logistics","residency","visa","driver","leasing","accounting","insurance","education","investment","consulting","europe"]},"state":{"type":"string","enum":["DRAFT","SUBMITTED","TRIAGE","NEEDS_INFO","ELIGIBLE","DECLINED","CONVERTED","WITHDRAWN"]},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{4})?$"},"submitted_at":{"type":"string","format":"date-time","nullable":true},"applicant_display":{"type":"string"},"sla_due_at":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer"}},"required":["id","service_id","state","locale","submitted_at","applicant_display","sla_due_at","version"],"additionalProperties":false}},"next_cursor":{"type":"string","nullable":true}},"required":["items","next_cursor"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/tg/applications/{id}":{"get":{"operationId":"tg.application.get","tags":["WS-08"],"summary":"tg.application.get (authenticated; owner tenant)","x-capability":"authenticated","x-owner":"tenant","x-workset":"WS-08","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"service_id":{"type":"string","enum":["law","company","logistics","residency","visa","driver","leasing","accounting","insurance","education","investment","consulting","europe"]},"profile_version":{"type":"integer"},"state":{"type":"string","enum":["DRAFT","SUBMITTED","TRIAGE","NEEDS_INFO","ELIGIBLE","DECLINED","CONVERTED","WITHDRAWN"]},"locale":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{4})?$"},"answers":{"type":"object","additionalProperties":{}},"representation_ref":{"type":"string","format":"uuid","nullable":true},"missing":{"type":"array","items":{"type":"string"}},"case_id":{"type":"string","format":"uuid","nullable":true},"version":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"submitted_at":{"type":"string","format":"date-time","nullable":true},"documents":{"type":"array","items":{"type":"object","properties":{"link_id":{"type":"string","format":"uuid"},"document_id":{"type":"string","format":"uuid"},"checklist_code":{"type":"string","nullable":true},"filename":{"type":"string"},"state":{"type":"string","enum":["UPLOADED","ACCEPTED","REJECTED"]},"scan":{"type":"string"},"review_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"}},"required":["link_id","document_id","checklist_code","filename","state","scan","review_note","created_at"],"additionalProperties":false}}},"required":["id","service_id","profile_version","state","locale","answers","representation_ref","missing","case_id","version","created_at","submitted_at","documents"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/tg/applications/{id}/triage":{"post":{"operationId":"tg.application.triage","tags":["WS-10"],"summary":"tg.application.triage (tg.application.triage; owner tenant)","x-capability":"tg.application.triage","x-owner":"tenant","x-workset":"WS-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["DRAFT","SUBMITTED","TRIAGE","NEEDS_INFO","ELIGIBLE","DECLINED","CONVERTED","WITHDRAWN"]},"version":{"type":"integer"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","version","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer"},"decision":{"type":"string","enum":["ELIGIBLE","DECLINED"]},"reason":{"type":"string","maxLength":2000},"conflict_check_ref":{"type":"string","minLength":1,"maxLength":256},"assigned_expert_id":{"type":"string","format":"uuid"}},"required":["expected_version","decision","reason"],"additionalProperties":false}}}}}},"/v1/tg/applications/{id}/request-info":{"post":{"operationId":"tg.application.request_info","tags":["WS-10"],"summary":"tg.application.request_info (tg.application.triage; owner tenant)","x-capability":"tg.application.triage","x-owner":"tenant","x-workset":"WS-10","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["NEEDS_INFO"]},"version":{"type":"integer"},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["id","state","version","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_version":{"type":"integer"},"missing":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["FIELD","DOCUMENT"]},"code":{"type":"string"},"note":{"type":"string","maxLength":500}},"required":["kind","code"],"additionalProperties":false},"minItems":1},"message":{"type":"string","maxLength":2000}},"required":["expected_version","missing","message"],"additionalProperties":false}}}}}},"/v1/tg/dashboard/management":{"get":{"operationId":"tg.management.workload","tags":["WS-11"],"summary":"tg.management.workload (tg.management.read; owner projection)","x-capability":"tg.management.read","x-owner":"projection","x-workset":"WS-11","x-idempotent":false,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","format":"date-time"},"tiles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{},"state":{"type":"string","enum":["loading","empty","partial","error","forbidden","stale","success"]},"source":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["id","state","source","as_of"],"additionalProperties":false}}},"required":["as_of","tiles"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}]}},"/v1/tg/intake/documents":{"post":{"operationId":"tg.intake.document_init","tags":["WS-12"],"summary":"tg.intake.document_init (PUBLIC; owner document owner)","x-capability":"PUBLIC","x-owner":"document owner","x-workset":"WS-12","x-idempotent":true,"parameters":[{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"upload_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["document_id","upload_url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"public_ref":{"type":"string","pattern":"^TG-\\d{4}-\\d{5}$"},"email":{"type":"string","format":"email","maxLength":200},"checklist_code":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{1,31}$"},"filename":{"type":"string","minLength":1,"maxLength":255},"mime":{"type":"string","maxLength":120},"size_bytes":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["public_ref","email","checklist_code","filename","mime","size_bytes"],"additionalProperties":false}}}}}},"/v1/tg/intake/documents/{id}/complete":{"post":{"operationId":"tg.intake.document_complete","tags":["WS-12"],"summary":"tg.intake.document_complete (PUBLIC; owner document owner)","x-capability":"PUBLIC","x-owner":"document owner","x-workset":"WS-12","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"document_id":{"type":"string","format":"uuid"},"link_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["UPLOADED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["document_id","link_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"public_ref":{"type":"string","pattern":"^TG-\\d{4}-\\d{5}$"},"email":{"type":"string","format":"email","maxLength":200},"etag":{"type":"string","minLength":1,"maxLength":200}},"required":["public_ref","email"],"additionalProperties":false}}}}}},"/v1/tg/document-links/{id}/review":{"post":{"operationId":"tg.document.review","tags":["WS-12"],"summary":"tg.document.review (tg.case.write; owner document owner)","x-capability":"tg.case.write","x-owner":"document owner","x-workset":"WS-12","x-idempotent":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"link_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["ACCEPTED","REJECTED"]},"receipt":{"type":"object","properties":{"ownerRef":{"type":"string","minLength":1,"maxLength":256},"resourceRef":{"type":"string","minLength":1,"maxLength":256},"revision":{"type":"string"},"auditRef":{"type":"string","minLength":1,"maxLength":256},"synthetic":{"type":"boolean","default":false}},"required":["ownerRef","resourceRef","revision","auditRef"],"additionalProperties":false}},"required":["link_id","state","receipt"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["ACCEPTED","REJECTED"]},"note":{"type":"string","maxLength":1000}},"required":["decision"],"additionalProperties":false}}}}}},"/v1/tg/documents/{id}/download-url":{"post":{"operationId":"tg.document.download","tags":["WS-12"],"summary":"tg.document.download (authenticated; owner document owner)","x-capability":"authenticated","x-owner":"document owner","x-workset":"WS-12","x-idempotent":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Purpose","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Error (VALIDATION)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Error (UNAUTHENTICATED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Error (FORBIDDEN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Error (NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Error (CONFLICT)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"410":{"description":"Error (GONE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Error (MERCHANT_UNKNOWN)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Error (RATE_OR_BUDGET)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Error (INTERNAL)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Error (OWNER_UNAVAILABLE)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","maxLength":64},"case_id":{"type":"string","format":"uuid"}},"required":["purpose"],"additionalProperties":false}}}}}}}}