{"openapi":"3.1.0","info":{"title":"WARDALE Machine Authority API","version":"0.3.0","description":"Public machine contract for UARP identity, WARDALE Authority Binding, lifecycle and standing, constitutional authority, remediation, bounded execution, audit visibility, production readiness, evidence verification and capability calculation. Protected constitutional implementation logic is not exposed."},"servers":[{"url":"https://wardale.io","description":"Canonical public domain; availability is subject to production-domain routing."}],"paths":{"/api/health":{"get":{"summary":"Service health","responses":{"200":{"description":"Healthy"}}}},"/api/v1/assurance/status":{"get":{"summary":"Runtime signing and authority-issuer assurance state","responses":{"200":{"description":"Assurance state"}}}},"/api/v1/production/readiness":{"get":{"summary":"Return the composed fail-closed production readiness decision and blocker codes","responses":{"200":{"description":"Production readiness decision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductionReadiness"}}}}}}},"/api/v1/capabilities":{"get":{"summary":"List public WARDALE capabilities","responses":{"200":{"description":"Capability registry"}}}},"/api/v1/workforce/agents":{"get":{"summary":"List the controlled WARDALE internal and related-business proving-ground workforce registry","responses":{"200":{"description":"Governed pilot/prototype workforce definitions"}}}},"/api/v1/uarp/schema":{"get":{"summary":"Return public UARP schema, lifecycle and standing taxonomy","responses":{"200":{"description":"UARP schema"}}}},"/api/v1/uarp/verify":{"post":{"summary":"Verify UARP record structure, lifecycle and declared standing","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UarpRecord"}}}},"responses":{"200":{"description":"Structurally valid UARP record"},"422":{"description":"UARP record failed verification"}}}},"/api/v1/uarp/lifecycle/evaluate":{"post":{"summary":"Evaluate a UARP lifecycle transition","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UarpLifecycleRequest"}}}},"responses":{"200":{"description":"Lifecycle transition decision"},"400":{"description":"Invalid JSON"}}}},"/api/v1/uarp/challenge/evaluate":{"post":{"summary":"Evaluate an evidenced correction or challenge to a UARP record","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UarpChallengeRequest"}}}},"responses":{"200":{"description":"Challenge review decision and audit hash"},"400":{"description":"Invalid JSON"}}}},"/api/v1/authority/binding/schema":{"get":{"summary":"Return the public WARDALE Authority Binding semantic and lifecycle contract","responses":{"200":{"description":"Authority Binding interoperability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityBinding"}}}}}}},"/api/v1/authority/decide":{"post":{"summary":"Evaluate constitutional standing authority for an intended consequence and append the decision to the audit ledger","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityRequest"}}}},"responses":{"200":{"description":"Authority decision, Evidence Receipt and audit ledger pointer"},"400":{"description":"Invalid JSON"}}}},"/api/v1/authority/remediate":{"post":{"summary":"Revoke authority, log the reason, re-evaluate the request and verify revoked execution is blocked","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityRemediationRequest"}}}},"responses":{"200":{"description":"Authority revoked and blocked execution verified"},"400":{"description":"Invalid JSON or missing remediation reason"},"409":{"description":"Remediation did not verify a blocked decision"}}}},"/api/v1/audit/ledger":{"get":{"summary":"Return the controlled audit summary, integrity and storage status","responses":{"200":{"description":"Audit summary"}}}},"/api/v1/execution/execute":{"post":{"summary":"Execute a registered deterministic action bound to a valid signed ALLOW receipt","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoundedExecutionRequest"}}}},"responses":{"200":{"description":"Execution completed with signed execution evidence"},"400":{"description":"Invalid request"},"403":{"description":"Execution denied by authority or action policy"},"422":{"description":"Authority signature invalid"}}}},"/api/v1/evidence/schema":{"get":{"summary":"Return the canonical M1 Evidence Receipt schema","responses":{"200":{"description":"Evidence Receipt schema"}}}},"/api/v1/evidence/verify":{"post":{"summary":"Verify WARDALE signed authority evidence and append verification result to the audit ledger","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceVerificationRequest"}}}},"responses":{"200":{"description":"Evidence verified with audit pointer"},"422":{"description":"Evidence not verified with audit pointer"}}}},"/api/v1/capability/calculate":{"post":{"summary":"Calculate reachable machine capabilities","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityCalculationRequest"}}}},"responses":{"200":{"description":"Capability closure"}}}}},"components":{"schemas":{"ProductionReadiness":{"type":"object","required":["service","environment","production","signingConfigured","authorityIssuerConfigured","auditDurabilityReady","executionGatewayInstalled","ready","blockers"],"properties":{"service":{"type":"string"},"environment":{"type":"string"},"production":{"type":"boolean"},"signingConfigured":{"type":"boolean"},"authorityIssuerConfigured":{"type":"boolean"},"auditDurabilityReady":{"type":"boolean"},"executionGatewayInstalled":{"type":"boolean"},"ready":{"type":"boolean"},"blockers":{"type":"array","items":{"type":"string","enum":["NOT_PRODUCTION_RUNTIME","SIGNING_NOT_CONFIGURED","AUTHORITY_ISSUER_NOT_CONFIGURED","AUDIT_DURABILITY_NOT_READY","EXECUTION_GATEWAY_NOT_INSTALLED"]}},"auditStorage":{"type":"object","additionalProperties":true},"evidence":{"type":"object","additionalProperties":{"type":"string"}}}},"UarpRecord":{"type":"object","required":["uarpId","actorName","actorType","ownerId","purpose","standing","lifecycle","assurance","protocols"],"properties":{"uarpId":{"type":"string","pattern":"^uarp:"},"actorName":{"type":"string"},"actorType":{"type":"string"},"ownerId":{"type":"string"},"operatorId":{"type":"string"},"purpose":{"type":"string"},"standing":{"type":"string","enum":["active","suspended","expired","revoked","unknown"]},"lifecycle":{"type":"string","enum":["registered","claimed","verified","active","suspended","retired","revoked"]},"assurance":{"type":"string","enum":["observed","owner_claimed","verified","certified","continuously_assured"]},"protocols":{"type":"array","items":{"type":"string"}},"endpoints":{"type":"array","items":{"type":"string"}},"linkedReferences":{"type":"object","additionalProperties":{"type":"string"}},"issuedAt":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"}}},"UarpLifecycleRequest":{"type":"object","required":["event"],"properties":{"current":{"anyOf":[{"type":"string","enum":["registered","claimed","verified","active","suspended","retired","revoked"]},{"type":"null"}]},"event":{"type":"string","enum":["REGISTER","CLAIM","VERIFY","ACTIVATE","SUSPEND","RETIRE","REVOKE"]}}},"UarpChallengeRequest":{"type":"object","required":["uarpId","challengerId","reason","evidenceRefs"],"properties":{"uarpId":{"type":"string"},"challengerId":{"type":"string"},"reason":{"type":"string"},"evidenceRefs":{"type":"array","items":{"type":"string"}},"requestedCorrection":{"type":"string"},"currentAssurance":{"type":"string","enum":["observed","owner_claimed","verified","certified","continuously_assured"]}}},"ExternalIdentityReference":{"type":"object","required":["provider","subjectId","assurance"],"properties":{"provider":{"type":"string"},"subjectId":{"type":"string"},"assurance":{"type":"string","enum":["observed","authenticated","verified"]},"tenantId":{"type":"string"},"uarpId":{"type":"string"}}},"AuthorityBinding":{"type":"object","required":["schemaVersion","bindingId","actorId","principalId","accountableHumanId","purpose","constitutionVersion","grantSource","authorityScopes","standing","lifecycle","validFrom","validUntil","externalIdentities"],"properties":{"schemaVersion":{"type":"string","enum":["0.1.0"]},"bindingId":{"type":"string","pattern":"^wdl_ab_"},"actorId":{"type":"string"},"principalId":{"type":"string"},"accountableHumanId":{"type":"string"},"purpose":{"type":"string"},"constitutionVersion":{"type":"string"},"grantSource":{"type":"string"},"authorityScopes":{"type":"array","items":{"type":"string"}},"standing":{"type":"string","enum":["active","suspended","expired","unknown"]},"lifecycle":{"type":"string","enum":["draft","active","suspended","revoked","expired"]},"validFrom":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"},"externalIdentities":{"type":"array","items":{"$ref":"#/components/schemas/ExternalIdentityReference"}},"authorizedApproverIds":{"type":"array","items":{"type":"string"}},"allowedCounterparties":{"type":"array","items":{"type":"string"}},"maxAmount":{"type":"number"},"metadata":{"type":"object","additionalProperties":true}}},"HumanApproval":{"type":"object","required":["id","approvedById","approvedAt","decision"],"properties":{"id":{"type":"string"},"approvedById":{"type":"string"},"approvedAt":{"type":"string","format":"date-time"},"decision":{"type":"string","enum":["APPROVE","REJECT"]}}},"AuthorityRequest":{"type":"object","required":["actorId","principalId","action","requestedScope","authorityScopes","standing","consequenceClass","constitutionVersion","grantSource","accountableHumanId","authorityValidUntil"],"properties":{"actorId":{"type":"string"},"principalId":{"type":"string"},"action":{"type":"string"},"requestedScope":{"type":"string"},"authorityScopes":{"type":"array","items":{"type":"string"}},"standing":{"type":"string","enum":["active","suspended","expired","unknown"]},"consequenceClass":{"type":"string","enum":["low","moderate","high","critical"]},"constitutionVersion":{"type":"string"},"grantSource":{"type":"string"},"accountableHumanId":{"type":"string"},"authorityValidUntil":{"type":"string","format":"date-time"},"revoked":{"type":"boolean"},"amount":{"type":"number"},"maxAmount":{"type":"number"},"requestedCounterparty":{"type":"string"},"allowedCounterparties":{"type":"array","items":{"type":"string"}},"authorizedApproverIds":{"type":"array","items":{"type":"string"}},"approval":{"$ref":"#/components/schemas/HumanApproval"},"context":{"type":"object","additionalProperties":true}}},"AuthorityRemediationRequest":{"type":"object","required":["authorityRequest","remediationReason"],"properties":{"authorityRequest":{"$ref":"#/components/schemas/AuthorityRequest"},"remediationReason":{"type":"string"}}},"BoundedExecutionRequest":{"type":"object","required":["authorityPayload","authoritySignature","idempotencyKey","action"],"properties":{"authorityPayload":{"type":"string"},"authoritySignature":{"type":"string"},"idempotencyKey":{"type":"string","minLength":8,"maxLength":128},"action":{"type":"object","required":["type","marker"],"properties":{"type":{"type":"string","enum":["evidence.seal"]},"marker":{"type":"string","maxLength":1000}}}}},"EvidenceVerificationRequest":{"type":"object","required":["payload","signature"],"properties":{"payload":{"type":"string"},"signature":{"type":"string"}}},"CapabilityCalculationRequest":{"type":"object","properties":{"availableSignals":{"type":"array","items":{"type":"string"}},"targetCapabilityId":{"type":"string"}}}}}}