{"openapi":"3.1.0","info":{"title":"MonetiAgents Public Developer Platform","version":"1.0.0","description":"Public MonetiAgents API for agent credentials, marketplace execution, usage, settlements, metering, billing, and capability discovery.","termsOfService":"https://monetiagents.local/terms","contact":{"name":"MonetiAgents Developer Platform","email":"developers@monetiagents.local"},"license":{"name":"Proprietary","identifier":"LicenseRef-MonetiAgents-Proprietary"}},"servers":[{"url":"http://localhost:3000","description":"Local development"}],"tags":[{"name":"Developer Credentials"},{"name":"Marketplace"},{"name":"Agent Commerce"},{"name":"Transactions"},{"name":"Usage"},{"name":"Settlements"},{"name":"Agents"},{"name":"Capabilities"},{"name":"Billing"},{"name":"Metering"},{"name":"Public Onboarding"}],"externalDocs":{"description":"Developer quickstart","url":"http://localhost:3000/docs/developer-quickstart"},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Use `Authorization: Bearer msk_<env>_<secret>` to authenticate with an issued MonetiAgents credential."},"MonetiHmacAuth":{"type":"apiKey","in":"header","name":"x-moneti-signature","description":"HMAC-SHA256 over `METHOD\\nPATH\\nTIMESTAMP\\nNONCE\\nIDEMPOTENCY_KEY\\nSHA256(BODY_UTF8)` using the issued secret. Required companion headers: `x-moneti-key-id`, `x-moneti-timestamp`, `x-moneti-nonce`, `idempotency-key`."}},"schemas":{"PublicErrorCatalog":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"statusCode":{"type":"number"},"category":{"type":"string"}},"required":["code","message","statusCode","category"]},"example":[{"code":"AUTHENTICATION_REQUIRED","message":"Authentication is required.","statusCode":401,"category":"AUTH"},{"code":"INVALID_API_KEY","message":"The supplied API key is invalid.","statusCode":401,"category":"AUTH"},{"code":"API_KEY_REVOKED","message":"The supplied API key has been revoked.","statusCode":401,"category":"AUTH"},{"code":"API_KEY_EXPIRED","message":"The supplied API key has expired.","statusCode":401,"category":"AUTH"},{"code":"INVALID_SIGNATURE","message":"The supplied HMAC signature is invalid.","statusCode":401,"category":"AUTH"},{"code":"TIMESTAMP_EXPIRED","message":"The request timestamp is outside the accepted tolerance window.","statusCode":401,"category":"AUTH"},{"code":"NONCE_REPLAYED","message":"The supplied nonce was already used.","statusCode":409,"category":"AUTH"},{"code":"CAPABILITY_FORBIDDEN","message":"The authenticated credential does not have the required capability.","statusCode":403,"category":"AUTH"},{"code":"TENANT_ACCESS_DENIED","message":"The requested resource is outside the authenticated tenant scope.","statusCode":403,"category":"AUTH"},{"code":"VALIDATION_ERROR","message":"The request payload is invalid.","statusCode":400,"category":"VALIDATION"},{"code":"IDEMPOTENCY_CONFLICT","message":"The supplied idempotency key conflicts with a previous request.","statusCode":409,"category":"MARKETPLACE"},{"code":"AGENT_INACTIVE","message":"The consumer agent is inactive.","statusCode":403,"category":"POLICY"},{"code":"VENDOR_INACTIVE","message":"The vendor agent is inactive.","statusCode":409,"category":"MARKETPLACE"},{"code":"VENDOR_SETTLEMENT_NOT_READY","message":"The vendor is not ready for Stripe settlement.","statusCode":409,"category":"SETTLEMENT"},{"code":"GUARDRAIL_TRIGGERED","message":"A policy guardrail blocked the request.","statusCode":403,"category":"POLICY"},{"code":"PAYMENT_AUTHORIZATION_ERROR","message":"Payment authorization failed.","statusCode":502,"category":"PAYMENT"},{"code":"VENDOR_EXECUTION_FAILED","message":"Vendor execution failed.","statusCode":502,"category":"MARKETPLACE"},{"code":"INFRASTRUCTURE_ERROR","message":"An internal infrastructure dependency failed.","statusCode":503,"category":"INTERNAL"}]},"DeveloperCredentialIssued":{"type":"object","properties":{"agentId":{"type":"string","format":"uuid"},"credentialId":{"type":"string","format":"uuid"},"keyId":{"type":"string","example":"mk_test_fca937f9f1f2b8f1"},"secret":{"type":"string","example":"msk_test_8ec31da8cae8b10ee1d57c0c5da5c0e6160cc2f7c3a0f8d1"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"}},"required":["agentId","credentialId","keyId","secret","createdAt","expiresAt"]},"ErrorDetails":{"type":"object","additionalProperties":{}},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"INVALID_API_KEY"},"message":{"type":"string","example":"The supplied API key is invalid."},"requestId":{"type":"string","example":"2f7a4b7e-89ba-44c3-b07e-50b38070db88"},"details":{"$ref":"#/components/schemas/ErrorDetails"}},"required":["code","message","requestId"]}},"required":["error"]},"CredentialCreateRequest":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"string","minLength":1},"maxItems":50},"expiresAt":{"type":["string","null"],"format":"date-time"}}},"DeveloperCredentialRecord":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"agentId":{"type":"string","format":"uuid"},"keyId":{"type":"string"},"apiKeyPrefix":{"type":["string","null"]},"role":{"type":"string","enum":["admin","consumer","vendor"]},"status":{"type":"string","enum":["active","rotating","expired","revoked"]},"capabilities":{"type":"array","items":{"type":"string"}},"organizationId":{"type":"string","format":"uuid"},"workspaceId":{"type":["string","null"],"format":"uuid"},"projectId":{"type":["string","null"],"format":"uuid"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rotationOverlapEndsAt":{"type":["string","null"],"format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","agentId","keyId","apiKeyPrefix","role","status","capabilities","organizationId","workspaceId","projectId","expiresAt","rotationOverlapEndsAt","lastUsedAt","revokedAt","createdAt","updatedAt"]},"DeveloperCredentialList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperCredentialRecord"}}},"required":["data"]},"CredentialRotateRequest":{"type":"object","properties":{"overlapSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":86400},"capabilities":{"type":"array","items":{"type":"string","minLength":1},"maxItems":50},"expiresAt":{"type":["string","null"],"format":"date-time"}}},"CredentialRevokeRequest":{"type":"object","properties":{"reason":{"type":["string","null"],"minLength":1,"maxLength":500}}},"MarketplaceCompletedResult":{"type":"object","properties":{"status":{"type":"string","enum":["completed"]},"executionStatus":{"type":"string","enum":["completed"]},"usageStatus":{"type":"string","enum":["confirmed"]},"settlementStatus":{"type":"string"},"settlementMode":{"type":"string","enum":["direct","aggregated"]},"transactionId":{"type":"string","format":"uuid"},"usageId":{"type":"string","format":"uuid"},"settlementId":{"type":"string","format":"uuid"},"aggregationKey":{"type":"string"},"bucketId":{"type":"string","format":"uuid"},"paymentProviderStatus":{"type":"string"},"paymentStatus":{"type":"string"},"reconciliationStatus":{"type":"string"},"payment":{"type":"object","properties":{"grossAmount":{"type":"string"},"platformFee":{"type":"string"},"netAmount":{"type":"string"},"currency":{"type":"string"},"txHash":{"type":"string"}},"required":["grossAmount","platformFee","netAmount","currency","txHash"]},"amount":{"type":"object","properties":{"grossAmount":{"type":"string"},"platformFee":{"type":"string"},"netAmount":{"type":"string"},"currency":{"type":"string"}},"required":["grossAmount","platformFee","netAmount","currency"]},"vendorResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"body":{}},"required":["statusCode"]}},"required":["status","executionStatus","usageStatus","settlementStatus","settlementMode","transactionId","usageId","vendorResponse"]},"MarketplaceBlockedResult":{"type":"object","properties":{"status":{"type":"string","enum":["blocked"]},"reason":{"type":"string"},"transactionId":{"type":"string","format":"uuid"}},"required":["status","reason","transactionId"]},"MarketplaceProcessingResult":{"type":"object","properties":{"status":{"type":"string","enum":["processing"]},"transactionId":{"type":"string","format":"uuid"},"ledgerStatus":{"type":"string"}},"required":["status","transactionId","ledgerStatus"]},"MarketplaceFailedResult":{"type":"object","properties":{"status":{"type":"string","enum":["failed"]},"transactionId":{"type":"string","format":"uuid"},"reason":{"type":"string","enum":["PAYMENT_AUTHORIZATION_FAILED","VENDOR_EXECUTION_FAILED","PAYMENT_CAPTURE_FAILED"]},"rollback":{"type":"object","properties":{"redis":{"type":"boolean"},"paymentAuthorizationCancelled":{"type":"boolean"}},"required":["redis","paymentAuthorizationCancelled"]}},"required":["status","transactionId","reason","rollback"]},"MarketplaceExecutionResponse":{"anyOf":[{"$ref":"#/components/schemas/MarketplaceCompletedResult"},{"$ref":"#/components/schemas/MarketplaceBlockedResult"},{"$ref":"#/components/schemas/MarketplaceProcessingResult"},{"$ref":"#/components/schemas/MarketplaceFailedResult"}]},"MarketplaceExecutionRequest":{"type":"object","properties":{"consumerAgentId":{"type":"string"},"vendorAgentId":{"type":"string"},"capabilityId":{"type":"string"},"payloadData":{"type":"object","additionalProperties":{}}},"required":["vendorAgentId","payloadData"],"additionalProperties":false},"AgentSearchCandidate":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"vendorName":{"type":"string"},"vendorType":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"capability":{"type":"object","properties":{"key":{"type":"string"},"version":{"type":"string"}},"required":["key","version"]},"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"required":["id","key","name","version"]},"price":{"type":"string"},"currency":{"type":"string"},"certified":{"type":"boolean"},"certificationStatus":{"type":"string"},"qualityScore":{"type":"number"},"reliabilityScore":{"type":"number"},"trustScore":{"type":"number"},"reputation":{"type":"object","properties":{"snapshotId":{"type":"string","format":"uuid"},"status":{"type":"string"},"overallScore":{"type":"number"},"qualityScore":{"type":"number"},"reliabilityScore":{"type":"number"},"confidenceScore":{"type":"number"},"signals":{"type":"array","items":{"type":"string"}},"windowEndedAt":{"type":"string"}},"required":["status","overallScore","qualityScore","reliabilityScore","confidenceScore","signals"]},"agentManifest":{"type":"object","properties":{"version":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"type":"string"}},"discoveryTags":{"type":"array","items":{"type":"string"}}},"required":["capabilities","tools","discoveryTags"]},"estimatedLatencyMs":{"type":"number"},"executionMode":{"type":"string"},"region":{"type":"string"},"sponsored":{"type":"boolean"},"sponsoredPlacement":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid"},"bidModel":{"type":"string"},"bidAmount":{"type":"string"},"clearingPrice":{"type":"string"},"currency":{"type":"string"},"auctionRank":{"type":"number"},"disclosure":{"type":"string"}},"required":["campaignId","bidModel","bidAmount","clearingPrice","currency","auctionRank","disclosure"]},"rankingScore":{"type":"number"},"rankingReasons":{"type":"array","items":{"type":"string"}},"scoreBreakdown":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]}},"antiGaming":{"type":"object","properties":{"penalty":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}},"recentTransactionCount":{"type":"number"},"recentFailureCount":{"type":"number"},"recentReconciliationMismatchCount":{"type":"number"},"recentResultRejectedCount":{"type":"number"},"recentResultReworkCount":{"type":"number"},"recentResultHumanReviewCount":{"type":"number"}},"required":["penalty","reasons","recentTransactionCount","recentFailureCount","recentReconciliationMismatchCount","recentResultRejectedCount","recentResultReworkCount","recentResultHumanReviewCount"]},"nextActions":{"type":"object","additionalProperties":{"type":"string"}}},"required":["vendorAgentId","vendorName","vendorType","capability","service","price","currency","certified","certificationStatus","qualityScore","reliabilityScore","trustScore","reputation","estimatedLatencyMs","executionMode","region","sponsored","rankingScore","rankingReasons","scoreBreakdown","antiGaming","nextActions"]},"AgentSearchResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.agent-search.v1"]},"searchId":{"type":"string","format":"uuid"},"intent":{"type":"string"},"rankingStrategy":{"type":"string"},"currency":{"type":"string"},"filters":{"type":"object","additionalProperties":{}},"budget":{"type":"object","additionalProperties":{}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/AgentSearchCandidate"}},"sponsoredResults":{"type":"array","items":{"$ref":"#/components/schemas/AgentSearchCandidate"}},"sponsoredAuction":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.sponsored-auction.v1"]},"model":{"type":"string","enum":["second_price"]},"requested":{"type":"boolean"},"rateLimited":{"type":"boolean"},"rateLimitReason":{"type":"string"},"eligibleBidCount":{"type":"number"},"winnerCount":{"type":"number"},"chargedAmount":{"type":"string"},"currency":{"type":"string"},"disclosure":{"type":"string"}},"required":["schemaVersion","model","requested","eligibleBidCount","winnerCount","chargedAmount","currency","disclosure"]},"nextActions":{"type":"object","additionalProperties":{"type":"string"}},"safety":{"type":"object","additionalProperties":{}}},"required":["schemaVersion","searchId","intent","rankingStrategy","currency","filters","budget","candidates","sponsoredResults","sponsoredAuction","nextActions","safety"]}},"required":["data"]},"AgentSearchRequest":{"type":"object","properties":{"intent":{"type":"string","minLength":1,"maxLength":4000},"intentContext":{"type":"object","additionalProperties":{},"default":{}},"budget":{"type":"object","properties":{"maximumAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"}},"default":{}},"capabilityHints":{"type":"array","items":{"type":"string","minLength":3,"maxLength":255},"maxItems":20,"default":[]},"rankingStrategy":{"type":"string","enum":["best_match","lowest_price","lowest_latency","highest_quality","highest_reliability","balanced"],"default":"best_match"},"filters":{"type":"object","properties":{"certifiedOnly":{"type":"boolean","default":false},"vendorTypes":{"type":"array","items":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"maxItems":4,"default":[]},"maxPrice":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"maxLatencyMs":{"type":"integer","minimum":0},"minimumQualityScore":{"type":"integer","minimum":0,"maximum":100},"minimumReliabilityScore":{"type":"integer","minimum":0,"maximum":100},"minimumTrustScore":{"type":"integer","minimum":0,"maximum":100},"region":{"type":"string","minLength":1,"maxLength":80},"executionMode":{"type":"string","enum":["sync","async"]},"excludeSponsored":{"type":"boolean","default":true}},"default":{},"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":["intent"],"additionalProperties":false},"SponsoredCampaign":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused","archived"]},"bidModel":{"type":"string"},"bidAmount":{"type":"string"},"dailyBudgetAmount":{"type":"string"},"totalBudgetAmount":{"type":"string"},"spentAmount":{"type":"string"},"currency":{"type":"string"},"targeting":{"type":"object","additionalProperties":{}},"startsAt":{"type":["string","null"]},"endsAt":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["campaignId","organizationId","vendorAgentId","vendorServiceId","capabilityKey","name","status","bidModel","bidAmount","dailyBudgetAmount","totalBudgetAmount","spentAmount","currency","targeting","startsAt","endsAt","createdAt","updatedAt"]},"SponsoredCampaignListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"campaigns":{"type":"array","items":{"$ref":"#/components/schemas/SponsoredCampaign"}},"count":{"type":"number"}},"required":["campaigns","count"]}},"required":["data"]},"SponsoredCampaignResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SponsoredCampaign"}},"required":["data"]},"SponsoredCampaignCreateRequest":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string","minLength":3,"maxLength":255},"name":{"type":"string","minLength":3,"maxLength":255},"status":{"type":"string","enum":["draft","active","paused"],"default":"active"},"bidAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"dailyBudgetAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"totalBudgetAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"targeting":{"type":"object","additionalProperties":{},"default":{}},"startsAt":{"type":"string","format":"date-time"},"endsAt":{"type":"string","format":"date-time"}},"required":["vendorServiceId","capabilityKey","name","bidAmount","dailyBudgetAmount","totalBudgetAmount"],"additionalProperties":false},"SponsoredBillingEvidence":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"searchId":{"type":["string","null"],"format":"uuid"},"createdAt":{"type":"string"},"intentDigest":{"type":["string","null"]},"idempotencyKeyDigest":{"type":["string","null"]},"campaignId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":["string","null"]},"clearingPrice":{"type":"string"},"chargedAmount":{"type":"string"},"currency":{"type":"string"},"position":{"type":["number","null"]},"evidenceHash":{"type":"string"}},"required":["eventId","searchId","createdAt","intentDigest","idempotencyKeyDigest","campaignId","vendorAgentId","vendorServiceId","capabilityKey","clearingPrice","chargedAmount","currency","position","evidenceHash"]},"SponsoredBillingReportResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.sponsored-billing.v1"]},"reportId":{"type":"string","format":"uuid"},"campaignId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"eventCount":{"type":"number"},"chargedAmount":{"type":"string"},"currency":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/SponsoredBillingEvidence"}},"reportDigest":{"type":"string"},"signature":{"type":"string"},"signatureAlgorithm":{"type":"string","enum":["hmac-sha256"]},"verification":{"type":"object","additionalProperties":{}}},"required":["schemaVersion","reportId","campaignId","vendorAgentId","periodStart","periodEnd","eventCount","chargedAmount","currency","evidence","reportDigest","signature","signatureAlgorithm","verification"]}},"required":["data"]},"SponsoredCampaignTrustPostureResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.sponsored-trust-posture.v1"]},"generatedAt":{"type":"string"},"summary":{"type":"object","properties":{"campaignCount":{"type":"number"},"activeCampaignCount":{"type":"number"},"pausedCampaignCount":{"type":"number"},"eligibleForReactivationCount":{"type":"number"},"autoPausedCampaignCount":{"type":"number"},"runtimeBlockedCampaignCount":{"type":"number"},"riskySiteDomainCount":{"type":"number"}},"required":["campaignCount","activeCampaignCount","pausedCampaignCount","eligibleForReactivationCount","autoPausedCampaignCount","runtimeBlockedCampaignCount","riskySiteDomainCount"]},"campaigns":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/SponsoredCampaign"},{"type":"object","properties":{"publicHosts":{"type":"array","items":{"type":"string"}},"siteDomains":{"type":"array","items":{"type":"string"}},"latestTrustEligible":{"type":"boolean"},"latestTrustReason":{"type":["string","null"]},"runtimeBlockCountLastHour":{"type":"number"},"latestAutoPausedAt":{"type":["string","null"]},"latestDefenseAt":{"type":["string","null"]},"reactivationAllowed":{"type":"boolean"}},"required":["publicHosts","siteDomains","latestTrustEligible","latestTrustReason","runtimeBlockCountLastHour","latestAutoPausedAt","latestDefenseAt","reactivationAllowed"]}]}}},"required":["schemaVersion","generatedAt","summary","campaigns"]}},"required":["data"]},"SponsoredCampaignDisputeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"disputeId":{"type":"string","format":"uuid"},"campaignId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["resolved","rejected"]},"reasonCode":{"type":"string","enum":["duplicate_impression","bot_traffic","invalid_targeting","billing_mismatch"]},"requestedCreditAmount":{"type":["string","null"]},"approvedCreditAmount":{"type":"string"},"currency":{"type":"string"},"decision":{"type":"object","properties":{"evaluatedEventCount":{"type":"number"},"duplicateGroups":{"type":"array","items":{"type":"object","additionalProperties":{}}},"botBurstGroups":{"type":"array","items":{"type":"object","additionalProperties":{}}},"creditedEventIds":{"type":"array","items":{"type":"string","format":"uuid"}},"deterministicOutcome":{"type":"string"}},"required":["evaluatedEventCount","duplicateGroups","botBurstGroups","creditedEventIds","deterministicOutcome"]}},"required":["disputeId","campaignId","status","reasonCode","requestedCreditAmount","approvedCreditAmount","currency","decision"]}},"required":["data"]},"SponsoredCampaignDisputeRequest":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid"},"reasonCode":{"type":"string","enum":["duplicate_impression","bot_traffic","invalid_targeting","billing_mismatch"]},"searchId":{"type":"string","format":"uuid"},"eventIds":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":100,"default":[]},"requestedCreditAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"evidence":{"type":"object","additionalProperties":{},"default":{}}},"required":["campaignId","reasonCode"],"additionalProperties":false},"SponsoredCampaignOptimizationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"optimizationId":{"type":"string","format":"uuid"},"campaignId":{"type":"string","format":"uuid"},"strategy":{"type":"string","enum":["target_cpa","max_impressions"]},"dryRun":{"type":"boolean"},"previousBidAmount":{"type":"string"},"recommendedBidAmount":{"type":"string"},"appliedBidAmount":{"type":["string","null"]},"currency":{"type":"string"},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"metrics":{"type":"object","additionalProperties":{}},"decision":{"type":"object","additionalProperties":{}}},"required":["optimizationId","campaignId","strategy","dryRun","previousBidAmount","recommendedBidAmount","appliedBidAmount","currency","periodStart","periodEnd","metrics","decision"]}},"required":["data"]},"SponsoredCampaignOptimizationRequest":{"type":"object","properties":{"strategy":{"type":"string","enum":["target_cpa","max_impressions"]},"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"targetCpaAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"minBidAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$","default":"0.000001"},"maxBidAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"maxBidAdjustmentPct":{"type":"number","minimum":1,"maximum":100,"default":25},"dryRun":{"type":"boolean","default":false},"observedConversionCount":{"type":["integer","null"],"minimum":0}},"required":["strategy"],"additionalProperties":false},"SponsoredCampaignReactivationResponse":{"type":"object","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/SponsoredCampaign"},{"type":"object","properties":{"reactivated":{"type":"boolean"},"publicHosts":{"type":"array","items":{"type":"string"}},"siteDomains":{"type":"array","items":{"type":"string"}},"latestTrustEligible":{"type":"boolean"},"latestTrustReason":{"type":["string","null"]}},"required":["reactivated","publicHosts","siteDomains","latestTrustEligible","latestTrustReason"]}]}},"required":["data"]},"SponsoredMarketInsightsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.sponsored-market-insights.v1"]},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"privacy":{"type":"object","additionalProperties":{}},"insights":{"type":"array","items":{"type":"object","properties":{"capabilityKey":{"type":"string"},"competitionTier":{"type":"string","enum":["low","medium","high"]},"activeCampaignCount":{"type":"number"},"activeVendorCount":{"type":"number"},"searchDemandCount":{"type":"number"},"sponsoredImpressionCount":{"type":"number"},"averageBidAmount":{"type":"string"},"averageClearingPrice":{"type":"string"},"totalSponsoredSpend":{"type":"string"},"recommendation":{"type":"string"}},"required":["capabilityKey","competitionTier","activeCampaignCount","activeVendorCount","searchDemandCount","sponsoredImpressionCount","averageBidAmount","averageClearingPrice","totalSponsoredSpend","recommendation"]}}},"required":["schemaVersion","periodStart","periodEnd","privacy","insights"]}},"required":["data"]},"AgentDiscoveryCandidate":{"type":"object","properties":{"offerId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorName":{"type":"string"},"vendorType":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"vendorServiceId":{"type":"string","format":"uuid"},"serviceKey":{"type":"string"},"serviceName":{"type":"string"},"serviceVersion":{"type":"string"},"capabilityKey":{"type":"string"},"capabilityVersion":{"type":"string"},"basePrice":{"type":"string"},"currency":{"type":"string"},"estimatedLatencyMs":{"type":"number"},"executionMode":{"type":"string","enum":["sync","async"]},"region":{"type":"string"},"capacityStatus":{"type":"string"},"trustScore":{"type":"number"},"certificationStatus":{"type":"string","enum":["certified","failed","expired","needs_review","uncertified"]},"certificationScore":{"type":["string","null"]},"certificationProfile":{"type":["string","null"]},"certificationHarnessVersion":{"type":["string","null"]},"lastCertifiedAt":{"type":["string","null"]},"certificationExpiresAt":{"type":["string","null"]},"certificationIsCurrent":{"type":"boolean"},"score":{"type":"number"},"matchReasons":{"type":"array","items":{"type":"string"}}},"required":["offerId","vendorAgentId","vendorName","vendorType","vendorServiceId","serviceKey","serviceName","serviceVersion","capabilityKey","capabilityVersion","basePrice","currency","estimatedLatencyMs","executionMode","region","capacityStatus","trustScore","certificationStatus","certificationScore","certificationProfile","certificationHarnessVersion","lastCertifiedAt","certificationExpiresAt","certificationIsCurrent","score","matchReasons"]},"AgentDiscoveryResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"intent":{"type":"string"},"matched":{"type":"boolean"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/AgentDiscoveryCandidate"}},"routingHint":{"type":"object","properties":{"routeEndpoint":{"type":"string"},"quoteEndpoint":{"type":"string"},"idempotencyRequired":{"type":"boolean"}},"required":["routeEndpoint","quoteEndpoint","idempotencyRequired"]}},"required":["intent","matched","candidates","routingHint"]}},"required":["data"]},"AgentDiscoveryRequest":{"type":"object","properties":{"intent":{"type":"string","minLength":1,"maxLength":4000},"intentContext":{"type":"object","additionalProperties":{},"default":{}},"capabilityHints":{"type":"array","items":{"type":"string","minLength":3,"maxLength":255},"maxItems":20,"default":[]},"vendorTypes":{"type":"array","items":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"maxItems":4,"default":[]},"requirements":{"type":"object","properties":{"maxPrice":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"maxLatencyMs":{"type":"integer","minimum":0},"minimumTrustScore":{"type":"integer","minimum":0,"maximum":100},"region":{"type":"string","minLength":1,"maxLength":80},"executionMode":{"type":"string","enum":["sync","async"]},"requiresAgentVendor":{"type":"boolean","default":false},"requiresCertifiedVendor":{"type":"boolean","default":false}},"default":{},"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":["intent"],"additionalProperties":false},"AgentIndexSubmission":{"type":"object","properties":{"submissionId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"submittedByCredentialId":{"type":["string","null"],"format":"uuid"},"source":{"type":"string","enum":["crawler","self_submit","partner_feed","manual_review"]},"descriptorUrl":{"type":"string","format":"uri"},"normalizedHost":{"type":"string"},"descriptorDigest":{"type":"string"},"structuralFingerprint":{"type":"string"},"endpointFingerprint":{"type":["string","null"]},"ownershipStatus":{"type":"string","enum":["verified","pending","failed"]},"sybilScore":{"type":"number"},"sybilReasons":{"type":"array","items":{"type":"string"}},"honeypotSignals":{"type":"array","items":{"type":"string"}},"indexStatus":{"type":"string","enum":["staging","pending_proof","quarantined","rejected"]},"stagingReason":{"type":["string","null"]},"expectedDnsProof":{"type":"string"},"reviewedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["submissionId","organizationId","submittedByCredentialId","source","descriptorUrl","normalizedHost","descriptorDigest","structuralFingerprint","endpointFingerprint","ownershipStatus","sybilScore","sybilReasons","honeypotSignals","indexStatus","stagingReason","reviewedAt","createdAt","updatedAt"]},"AgentIndexSubmissionResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AgentIndexSubmission"}},"required":["data"]},"AgentIndexSubmissionRequest":{"type":"object","properties":{"source":{"type":"string","enum":["crawler","self_submit","partner_feed","manual_review"],"default":"crawler"},"descriptorUrl":{"type":"string","maxLength":2000,"format":"uri"},"descriptor":{"type":"object","additionalProperties":{}},"dnsProofs":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["dns_txt","well_known_file","https_header"]},"value":{"type":"string","minLength":3,"maxLength":2000}},"required":["type","value"],"additionalProperties":false},"maxItems":20,"default":[]},"httpProofs":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["dns_txt","well_known_file","https_header"]},"value":{"type":"string","minLength":3,"maxLength":2000}},"required":["type","value"],"additionalProperties":false},"maxItems":20,"default":[]},"crawlerSignals":{"type":"object","properties":{"websiteUrl":{"type":"string","minLength":1,"maxLength":255},"hiddenField":{"type":"string","minLength":1,"maxLength":255},"honeypot":{"type":"string","minLength":1,"maxLength":255},"botTrap":{"type":"string","minLength":1,"maxLength":255},"robotsTrap":{"type":"string","enum":["triggered"]}},"default":{},"additionalProperties":false}},"required":["descriptorUrl","descriptor"],"additionalProperties":false},"AgentIndexSubmissionListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/AgentIndexSubmission"}},"count":{"type":"number"}},"required":["submissions","count"]}},"required":["data"]},"AgentReputationSnapshot":{"type":"object","properties":{"snapshotId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string"},"snapshotVersion":{"type":"string"},"windowStartedAt":{"type":"string"},"windowEndedAt":{"type":"string"},"status":{"type":"string","enum":["excellent","good","watchlist","risky","insufficient_data"]},"overallScore":{"type":"number"},"qualityScore":{"type":"number"},"reliabilityScore":{"type":"number"},"commercialCompletionScore":{"type":"number"},"reconciliationIntegrityScore":{"type":"number"},"responsivenessScore":{"type":"number"},"certificationFreshnessScore":{"type":"number"},"confidenceScore":{"type":"number"},"eventCounts":{"type":"object","additionalProperties":{}},"scoreBreakdown":{"type":"object","additionalProperties":{}},"publicSummary":{"type":"object","additionalProperties":{}},"privateMetrics":{"type":"object","additionalProperties":{}},"sourceEventDigest":{"type":"string"},"createdAt":{"type":"string"}},"required":["snapshotId","organizationId","vendorAgentId","vendorServiceId","capabilityKey","snapshotVersion","windowStartedAt","windowEndedAt","status","overallScore","qualityScore","reliabilityScore","commercialCompletionScore","reconciliationIntegrityScore","responsivenessScore","certificationFreshnessScore","confidenceScore","eventCounts","scoreBreakdown","publicSummary","sourceEventDigest","createdAt"]},"AgentReputationRebuildResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.agent-reputation.v1"]},"rebuiltCount":{"type":"number"},"windowDays":{"type":"number"},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/AgentReputationSnapshot"}}},"required":["schemaVersion","rebuiltCount","windowDays","snapshots"]}},"required":["data"]},"AgentReputationRebuildRequest":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string","minLength":3,"maxLength":255},"windowDays":{"type":"integer","minimum":1,"maximum":365,"default":30}}},"AgentReputationListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AgentReputationSnapshot"}}},"required":["data"]},"AgentEscrowRequirementResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.agent-escrow.v1"]},"reputationStatus":{"type":"string","enum":["excellent","good","watchlist","risky","insufficient_data"]},"reputationSnapshotId":{"type":["string","null"],"format":"uuid"},"reputationOverallScore":{"type":["number","null"]},"reputationConfidenceScore":{"type":["number","null"]},"requiredEscrowPercentage":{"type":"string"},"requiredAmount":{"type":"string"},"contractValue":{"type":"string"},"currency":{"type":"string"},"bypassAllowed":{"type":"boolean"},"policy":{"type":"object","additionalProperties":{"type":"string"}}},"required":["schemaVersion","reputationStatus","reputationSnapshotId","reputationOverallScore","reputationConfidenceScore","requiredEscrowPercentage","requiredAmount","contractValue","currency","bypassAllowed","policy"]}},"required":["data"]},"AgentEscrowCalculateRequest":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string","minLength":3,"maxLength":255},"contractValue":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"currency":{"type":"string","minLength":3,"maxLength":10,"default":"USD"}},"required":["vendorAgentId","contractValue"],"additionalProperties":false},"AgentEscrowHold":{"type":"object","properties":{"escrowHoldId":{"type":"string","format":"uuid"},"transactionId":{"type":"string"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":["string","null"],"format":"uuid"},"capabilityKey":{"type":["string","null"]},"reputationSnapshotId":{"type":["string","null"],"format":"uuid"},"reputationStatus":{"type":"string","enum":["excellent","good","watchlist","risky","insufficient_data"]},"contractValue":{"type":"string"},"requiredEscrowPercentage":{"type":"string"},"amountHeld":{"type":"string"},"currency":{"type":"string"},"status":{"type":"string","enum":["held","released","disputed","slashed"]},"acceptedTermsHash":{"type":["string","null"]},"metadata":{"type":"object","additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"releasedAt":{"type":["string","null"]},"disputedAt":{"type":["string","null"]},"slashedAt":{"type":["string","null"]},"requirement":{"type":"object","additionalProperties":{}}},"required":["escrowHoldId","transactionId","vendorAgentId","vendorServiceId","capabilityKey","reputationSnapshotId","reputationStatus","contractValue","requiredEscrowPercentage","amountHeld","currency","status","acceptedTermsHash","metadata","createdAt","updatedAt","releasedAt","disputedAt","slashedAt"]},"AgentEscrowHoldResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AgentEscrowHold"}},"required":["data"]},"AgentEscrowLockRequest":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string","minLength":3,"maxLength":255},"contractValue":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"currency":{"type":"string","minLength":3,"maxLength":10,"default":"USD"},"transactionId":{"type":"string","minLength":8,"maxLength":255},"acceptedTermsHash":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"},"metadata":{"type":"object","additionalProperties":{},"default":{}}},"required":["vendorAgentId","contractValue","transactionId"],"additionalProperties":false},"AgentEscrowReleaseRequest":{"type":"object","properties":{"outcome":{"type":"string","enum":["delivered","buyer_accepted","manual_release"],"default":"buyer_accepted"},"evidenceDigest":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"},"metadata":{"type":"object","additionalProperties":{},"default":{}}},"additionalProperties":false},"AgentEscrowDisputeRequest":{"type":"object","properties":{"reasonCode":{"type":"string","enum":["buyer_dispute","vendor_failure","evidence_mismatch","manual_review"]},"evidenceDigest":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"},"metadata":{"type":"object","additionalProperties":{},"default":{}}},"required":["reasonCode"],"additionalProperties":false},"AgentDescriptorDiagnosticsFactor":{"type":"object","properties":{"code":{"type":"string"},"impact":{"type":"string"},"description":{"type":"string"},"remediation":{"type":"string"}},"required":["code","impact","description","remediation"]},"AgentDescriptorDiagnosticsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string"},"agentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"currentStatus":{"type":"string"},"reputationScore":{"type":"number"},"descriptorStatus":{"type":"string","enum":["draft","live"]},"liveVersion":{"type":["string","null"]},"draftVersion":{"type":["string","null"]},"requestedTier":{"type":"string","enum":["metadata_only","transactional","premium_transactional"]},"eligibleForPromotion":{"type":"boolean"},"factors":{"type":"array","items":{"$ref":"#/components/schemas/AgentDescriptorDiagnosticsFactor"}}},"required":["schemaVersion","agentId","vendorAgentId","currentStatus","reputationScore","descriptorStatus","liveVersion","draftVersion","requestedTier","eligibleForPromotion","factors"]}},"required":["data"]},"AgentDescriptorDraftResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"descriptorStatus":{"type":"string","enum":["draft","live"]},"draftVersion":{"type":"string"},"validation":{"type":"object","additionalProperties":{}}},"required":["vendorAgentId","descriptorStatus","draftVersion","validation"]}},"required":["data"]},"AgentDescriptorDraftRequest":{"type":"object","properties":{"agentManifest":{"type":"object","additionalProperties":{}},"draftVersion":{"type":"string","minLength":1,"maxLength":80}},"required":["agentManifest"],"additionalProperties":false},"AgentDescriptorPromotionResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"descriptorStatus":{"type":"string","enum":["draft","live"]},"liveVersion":{"type":["string","null"]},"lastPromotedAt":{"type":["string","null"]},"diagnostics":{"type":"object","additionalProperties":{}}},"required":["vendorAgentId","descriptorStatus","liveVersion","lastPromotedAt","diagnostics"]}},"required":["data"]},"AgentDescriptorPromotionRequest":{"type":"object","properties":{"expectedDraftVersion":{"type":"string","minLength":1,"maxLength":80},"requestedTier":{"type":"string","enum":["metadata_only","transactional","premium_transactional"],"default":"transactional"}},"additionalProperties":false},"AgentRunEnvelope":{"type":"object","properties":{"agentRunId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"commerceTransactionId":{"type":["string","null"],"format":"uuid"},"workflowRunId":{"type":["string","null"],"format":"uuid"},"workflowStepId":{"type":["string","null"],"format":"uuid"},"buyerAgentId":{"type":["string","null"],"format":"uuid"},"vendorAgentId":{"type":["string","null"],"format":"uuid"},"vendorType":{"type":"string"},"status":{"type":"string"},"intent":{"type":"object","additionalProperties":{}},"plan":{"type":"object","additionalProperties":{}},"decisionTrace":{"type":"array","items":{}},"toolCalls":{"type":"array","items":{}},"observations":{"type":"array","items":{}},"result":{"type":"object","additionalProperties":{}},"evidence":{"type":"object","additionalProperties":{}},"metering":{"type":"object","additionalProperties":{}},"idempotencyKey":{"type":"string"},"requestFingerprint":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["agentRunId","organizationId","commerceTransactionId","workflowRunId","workflowStepId","buyerAgentId","vendorAgentId","vendorType","status","intent","plan","decisionTrace","toolCalls","observations","result","evidence","metering","idempotencyKey","requestFingerprint","createdAt","updatedAt"]},"AgentIntentExecutionResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string"},"agentRunId":{"type":"string","format":"uuid"},"transactionId":{"type":"string","format":"uuid"},"authorizationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"selected":{"$ref":"#/components/schemas/AgentDiscoveryCandidate"},"execution":{"type":"object","additionalProperties":{}},"envelope":{"$ref":"#/components/schemas/AgentRunEnvelope"}},"required":["status","agentRunId","transactionId","authorizationId","quoteId","selected","execution","envelope"]}},"required":["data"]},"AgentIntentExecutionRequest":{"type":"object","properties":{"intent":{"type":"string","minLength":1,"maxLength":4000},"intentContext":{"type":"object","additionalProperties":{},"default":{}},"capabilityHints":{"type":"array","items":{"type":"string","minLength":3,"maxLength":255},"maxItems":20,"default":[]},"vendorTypes":{"type":"array","items":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"maxItems":4,"default":[]},"requirements":{"type":"object","properties":{"maxPrice":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"maxLatencyMs":{"type":"integer","minimum":0},"minimumTrustScore":{"type":"integer","minimum":0,"maximum":100},"region":{"type":"string","minLength":1,"maxLength":80},"executionMode":{"type":"string","enum":["sync","async"]},"requiresAgentVendor":{"type":"boolean","default":false},"requiresCertifiedVendor":{"type":"boolean","default":false}},"default":{},"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"buyerAgentId":{"type":"string","format":"uuid"},"searchId":{"type":"string","format":"uuid"},"selectionStrategy":{"type":"string","enum":["highest_score","lowest_price","lowest_latency","highest_trust"],"default":"highest_score"},"maximumAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"delegatedSpendToken":{"type":"string","minLength":16,"maxLength":255},"quoteExpiresInSeconds":{"type":"integer","minimum":60,"maximum":86400,"default":900}},"required":["intent"],"additionalProperties":false},"AgentWalletReadinessResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"buyerAgentId":{"type":"string","format":"uuid"},"currency":{"type":"string"},"walletAddress":{"type":"string"},"spendMode":{"type":"string","enum":["sandbox","live","disabled"]},"delegatedSpendEnabled":{"type":"boolean"},"manualApprovalRequired":{"type":"boolean"},"hasStripeCustomerToken":{"type":"boolean"},"hasStripePaymentMethod":{"type":"boolean"},"budget":{"type":"object","properties":{"availableAmount":{"type":"string"},"reservedAmount":{"type":"string"},"consumedAmount":{"type":"string"}},"required":["availableAmount","reservedAmount","consumedAmount"]},"isReady":{"type":"boolean"},"readinessReasons":{"type":"array","items":{"type":"string"}},"checkedAt":{"type":"string"},"auditActor":{"type":"object","properties":{"actorId":{"type":"string"},"requestId":{"type":["string","null"]},"correlationId":{"type":["string","null"]}},"required":["actorId","requestId","correlationId"]}},"required":["buyerAgentId","currency","walletAddress","spendMode","delegatedSpendEnabled","manualApprovalRequired","hasStripeCustomerToken","hasStripePaymentMethod","budget","isReady","readinessReasons","checkedAt","auditActor"]}},"required":["data"]},"DelegatedSpendToken":{"type":"object","properties":{"delegationId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"buyerAgentId":{"type":"string","format":"uuid"},"issuedByCredentialId":{"type":["string","null"]},"delegateLabel":{"type":"string"},"tokenHint":{"type":"string"},"status":{"type":"string","enum":["active","revoked","expired"]},"maximumAmount":{"type":"string"},"currency":{"type":"string"},"allowedCapabilityKeys":{"type":"array","items":{"type":"string"}},"allowedVendorTypes":{"type":"array","items":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]}},"metadata":{"type":"object","additionalProperties":{}},"lastUsedAt":{"type":["string","null"]},"expiresAt":{"type":"string"},"revokedAt":{"type":["string","null"]},"revokedReason":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["delegationId","organizationId","buyerAgentId","issuedByCredentialId","delegateLabel","tokenHint","status","maximumAmount","currency","allowedCapabilityKeys","allowedVendorTypes","metadata","lastUsedAt","expiresAt","revokedAt","revokedReason","createdAt","updatedAt"]},"DelegatedSpendTokenIssuedResponse":{"type":"object","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/DelegatedSpendToken"},{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}]}},"required":["data"]},"DelegatedSpendTokenIssueRequest":{"type":"object","properties":{"buyerAgentId":{"type":"string","format":"uuid"},"delegateLabel":{"type":"string","minLength":3,"maxLength":255},"maximumAmount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"expiresInSeconds":{"type":"integer","minimum":60,"maximum":2592000,"default":86400},"allowedCapabilityKeys":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"maxItems":50,"default":[]},"allowedVendorTypes":{"type":"array","items":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"maxItems":4,"default":[]},"metadata":{"type":"object","additionalProperties":{},"default":{}}},"required":["delegateLabel","maximumAmount"],"additionalProperties":false},"DelegatedSpendTokenListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"buyerAgentId":{"type":"string","format":"uuid"},"tokens":{"type":"array","items":{"$ref":"#/components/schemas/DelegatedSpendToken"}}},"required":["buyerAgentId","tokens"]}},"required":["data"]},"DelegatedSpendTokenResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DelegatedSpendToken"}},"required":["data"]},"DelegatedSpendTokenRevokeRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"additionalProperties":false},"TransactionTimelineEvent":{"type":"object","properties":{"sequence":{"type":"number"},"source":{"type":"string"},"eventType":{"type":"string"},"status":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"summary":{"type":"string"},"data":{"type":"object","additionalProperties":{}}},"required":["sequence","source","eventType","status","occurredAt","summary","data"]},"TransactionTimelineResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"status":{"type":"string"},"buyerAgentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorServiceId":{"type":"string","format":"uuid"},"serviceKey":{"type":["string","null"]},"quoteId":{"type":"string","format":"uuid"},"authorizationId":{"type":"string","format":"uuid"},"idempotencyKey":{"type":"string"},"inputDigest":{"type":"string"},"requestFingerprint":{"type":"string"},"amount":{"type":"object","properties":{"actual":{"type":["string","null"]},"estimated":{"type":["string","null"]},"maximum":{"type":["string","null"]},"currency":{"type":"string"}},"required":["actual","estimated","maximum","currency"]},"quote":{"type":"object","additionalProperties":{}},"authorization":{"type":"object","additionalProperties":{}},"health":{"type":"object","additionalProperties":{}},"recovery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.transaction-recovery.v1"]},"statusProjection":{"type":"string","enum":["completed","in_progress","retry_scheduled","pending_recovery","manual_review","compensated","failed"]},"terminal":{"type":"boolean"},"retryable":{"type":"boolean"},"attentionRequired":{"type":"boolean"},"sagaStatus":{"type":["string","null"]},"transactionStatus":{"type":"string"},"nextActionCodes":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}},"required":["schemaVersion","statusProjection","terminal","retryable","attentionRequired","sagaStatus","transactionStatus","nextActionCodes","summary"]},"counts":{"type":"object","additionalProperties":{"type":"number"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/TransactionTimelineEvent"}},"nextActions":{"type":"array","items":{"type":"object","additionalProperties":{}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["transactionId","organizationId","status","buyerAgentId","vendorAgentId","vendorServiceId","serviceKey","quoteId","authorizationId","idempotencyKey","inputDigest","requestFingerprint","amount","quote","authorization","health","recovery","counts","events","nextActions","createdAt","updatedAt"]}},"required":["data"]},"SagaCompensationCatalogResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string"},"compensations":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["schemaVersion","compensations"]}},"required":["data"]},"RecoveryOperationsOverviewResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.recovery-operations.v1"]},"generatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["healthy","warning","critical"]},"summary":{"type":"object","properties":{"openSagaCount":{"type":"number"},"deadLetterSagaCount":{"type":"number"},"manualReviewSagaCount":{"type":"number"},"outboxBacklogCount":{"type":"number"},"deadLetterOutboxCount":{"type":"number"},"staleClaimedOutboxCount":{"type":"number"}},"required":["openSagaCount","deadLetterSagaCount","manualReviewSagaCount","outboxBacklogCount","deadLetterOutboxCount","staleClaimedOutboxCount"]},"queues":{"type":"object","properties":{"sagas":{"type":"object","properties":{"failed":{"type":"number"},"compensating":{"type":"number"},"manualReview":{"type":"number"},"deadLetter":{"type":"number"},"oldestUpdatedAt":{"type":["string","null"]}},"required":["failed","compensating","manualReview","deadLetter","oldestUpdatedAt"]},"outbox":{"type":"object","properties":{"pending":{"type":"number"},"claimed":{"type":"number"},"failed":{"type":"number"},"deadLetter":{"type":"number"},"staleClaimed":{"type":"number"},"oldestAvailableAt":{"type":["string","null"]}},"required":["pending","claimed","failed","deadLetter","staleClaimed","oldestAvailableAt"]}},"required":["sagas","outbox"]},"activity24h":{"type":"object","properties":{"outboxReplaysRequested":{"type":"number"},"sagaCompensationsRequested":{"type":"number"},"manualReviewsRequested":{"type":"number"},"compensationStepsCompleted":{"type":"number"},"sagasCompensated":{"type":"number"},"outboxPublished":{"type":"number"}},"required":["outboxReplaysRequested","sagaCompensationsRequested","manualReviewsRequested","compensationStepsCompleted","sagasCompensated","outboxPublished"]},"alerts":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["warning","critical"]},"code":{"type":"string"},"message":{"type":"string"},"count":{"type":"number"},"nextAction":{"type":"string"}},"required":["severity","code","message","count","nextAction"]}},"nextActions":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","generatedAt","status","summary","queues","activity24h","alerts","nextActions"]}},"required":["data"]},"RecoverySagaQueueResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.recovery-saga-queue.v1"]},"limit":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"sagaInstanceId":{"type":"string","format":"uuid"},"sagaType":{"type":"string"},"subjectType":{"type":"string"},"transactionId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["failed","compensating","manual_review","dead_letter"]},"currentStepKey":{"type":["string","null"]},"correlationId":{"type":["string","null"]},"idempotencyKey":{"type":"string"},"compensatableStepCount":{"type":"number"},"failedStepCount":{"type":"number"},"lastEventType":{"type":["string","null"]},"lastEventAt":{"type":["string","null"]},"ageSeconds":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"nextAction":{"type":"string"}},"required":["sagaInstanceId","sagaType","subjectType","transactionId","status","currentStepKey","correlationId","idempotencyKey","compensatableStepCount","failedStepCount","lastEventType","lastEventAt","ageSeconds","createdAt","updatedAt","nextAction"]}}},"required":["schemaVersion","limit","items"]}},"required":["data"]},"RecoveryOutboxQueueResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.recovery-outbox-queue.v1"]},"limit":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"outboxEventId":{"type":"string","format":"uuid"},"aggregateType":{"type":"string"},"aggregateId":{"type":"string","format":"uuid"},"eventType":{"type":"string"},"status":{"type":"string","enum":["pending","claimed","failed","dead_letter"]},"attempts":{"type":"number"},"availableAt":{"type":"string"},"claimedAt":{"type":["string","null"]},"claimOwner":{"type":["string","null"]},"claimExpiresAt":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"lastError":{"type":"object","additionalProperties":{}},"deliveryResult":{"type":"object","additionalProperties":{}},"staleClaim":{"type":"boolean"},"ageSeconds":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"nextAction":{"type":"string"}},"required":["outboxEventId","aggregateType","aggregateId","eventType","status","attempts","availableAt","claimedAt","claimOwner","claimExpiresAt","publishedAt","lastError","deliveryResult","staleClaim","ageSeconds","createdAt","updatedAt","nextAction"]}}},"required":["schemaVersion","limit","items"]}},"required":["data"]},"OutboxReplayResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"outboxEventId":{"type":"string","format":"uuid"},"aggregateType":{"type":"string"},"aggregateId":{"type":"string","format":"uuid"},"eventType":{"type":"string"},"status":{"type":"string"},"attempts":{"type":"number"},"previousStatus":{"type":"string"},"previousAttempts":{"type":"number"},"replayed":{"type":"boolean"},"idempotent":{"type":"boolean"},"nextAction":{"type":"string"}},"required":["outboxEventId","aggregateType","aggregateId","eventType","status","attempts","previousStatus","previousAttempts","replayed","idempotent","nextAction"]}},"required":["data"]},"OutboxReplayRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500},"evidence":{"type":"object","additionalProperties":{},"default":{}}},"required":["reason"]},"SagaCompensationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid"},"sagaInstanceId":{"type":"string","format":"uuid"},"action":{"type":"string","enum":["request_compensation","manual_review"]},"status":{"type":"string"},"currentStepKey":{"type":["string","null"]},"idempotent":{"type":"boolean"},"compensatableSteps":{"type":"array","items":{"type":"object","additionalProperties":{}}},"nextAction":{"type":"string"}},"required":["transactionId","sagaInstanceId","action","status","currentStepKey","idempotent","compensatableSteps","nextAction"]}},"required":["data"]},"SagaCompensationRequest":{"type":"object","properties":{"action":{"type":"string","enum":["request_compensation","manual_review"],"default":"request_compensation"},"reason":{"type":"string","minLength":3,"maxLength":500},"evidence":{"type":"object","additionalProperties":{},"default":{}}},"required":["reason"]},"AgentCertificationRecord":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"capabilityKey":{"type":"string"},"harnessVersion":{"type":"string"},"certificationProfile":{"type":"string"},"status":{"type":"string","enum":["certified","failed","expired","needs_review"]},"score":{"type":"string"},"checkSummary":{"type":"object","properties":{"total":{"type":"number"},"passed":{"type":"number"},"failed":{"type":"number"}},"required":["total","passed","failed"]},"summary":{"type":"object","additionalProperties":{}},"certifiedAt":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"isCurrentlyValid":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","organizationId","vendorAgentId","capabilityKey","harnessVersion","certificationProfile","status","score","checkSummary","summary","certifiedAt","expiresAt","isCurrentlyValid","createdAt","updatedAt"]},"Pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"],"example":null},"hasMore":{"type":"boolean","example":false}},"required":["nextCursor","hasMore"]},"AgentCertificationListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AgentCertificationRecord"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"AgentRunEnvelopeResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AgentRunEnvelope"}},"required":["data"]},"AgentRunEnvelopeRequest":{"type":"object","properties":{"commerceTransactionId":{"type":"string","format":"uuid"},"workflowRunId":{"type":"string","format":"uuid"},"workflowStepId":{"type":"string","format":"uuid"},"buyerAgentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"vendorType":{"type":"string","enum":["api_vendor","tool_vendor","agent_vendor","hybrid_vendor"]},"status":{"type":"string","enum":["created","planning","running","waiting","completed","failed","canceled"],"default":"created"},"intent":{"type":"object","additionalProperties":{},"default":{}},"plan":{"type":"object","additionalProperties":{},"default":{}},"decisionTrace":{"type":"array","items":{},"maxItems":32,"default":[]},"toolCalls":{"type":"array","items":{},"maxItems":32,"default":[]},"observations":{"type":"array","items":{},"maxItems":32,"default":[]},"result":{"type":"object","additionalProperties":{},"default":{}},"evidence":{"type":"object","additionalProperties":{},"default":{}},"metering":{"type":"object","additionalProperties":{},"default":{}}},"additionalProperties":false},"HarnessTool":{"type":"object","properties":{"toolKey":{"type":"string"},"displayName":{"type":"string"},"purpose":{"type":"string"},"method":{"type":"string"},"endpoint":{"type":"string"},"requiredCapabilities":{"type":"array","items":{"type":"string"}},"sideEffect":{"type":"string","enum":["read_only","spend_creating","external_side_effect","settlement_affecting"]},"idempotencyRequired":{"type":"boolean"},"retryPolicy":{"type":"object","properties":{"safeToRetry":{"type":"boolean"},"retryWithSameIdempotencyKey":{"type":"boolean"},"retryableStatusCodes":{"type":"array","items":{"type":"number"}}},"required":["safeToRetry","retryWithSameIdempotencyKey","retryableStatusCodes"]},"inputSchemaRef":{"type":"string"},"outputSchemaRef":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}}},"required":["toolKey","displayName","purpose","method","endpoint","requiredCapabilities","sideEffect","idempotencyRequired","retryPolicy","inputSchemaRef","outputSchemaRef","nextActions"]},"HarnessToolsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string"},"harnessSchemaVersion":{"type":"string"},"agentFormula":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/HarnessTool"}},"conventions":{"type":"object","additionalProperties":{"type":"string"}}},"required":["schemaVersion","harnessSchemaVersion","agentFormula","tools","conventions"]}},"required":["data"]},"AgentRunTimelineEvent":{"type":"object","properties":{"sequence":{"type":"number"},"eventType":{"type":"string"},"status":{"type":"string"},"occurredAt":{"type":"string"},"summary":{"type":"string"},"data":{}},"required":["sequence","eventType","status","occurredAt","summary"]},"AgentRunTimelineResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"agentRunId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"status":{"type":"string"},"commerceTransactionId":{"type":["string","null"],"format":"uuid"},"workflowRunId":{"type":["string","null"],"format":"uuid"},"workflowStepId":{"type":["string","null"],"format":"uuid"},"buyerAgentId":{"type":["string","null"],"format":"uuid"},"vendorAgentId":{"type":["string","null"],"format":"uuid"},"vendorType":{"type":"string"},"idempotencyKey":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"events":{"type":"array","items":{"$ref":"#/components/schemas/AgentRunTimelineEvent"}},"recovery":{"type":"object","properties":{"schemaVersion":{"type":"string","enum":["monetiagents.agent-recovery.v1"]},"statusProjection":{"type":"string","enum":["completed","in_progress","retry_scheduled","pending_recovery","manual_review","compensated","failed"]},"transactionStatus":{"type":["string","null"]},"summary":{"type":"string"},"linkedTransactionTimeline":{"type":["string","null"]},"nextActionCodes":{"type":"array","items":{"type":"string"}},"terminal":{"type":"boolean"},"retryable":{"type":"boolean"},"attentionRequired":{"type":"boolean"}},"required":["schemaVersion","statusProjection","transactionStatus","summary","linkedTransactionTimeline","nextActionCodes","terminal","retryable","attentionRequired"]},"nextActions":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["agentRunId","organizationId","status","commerceTransactionId","workflowRunId","workflowStepId","buyerAgentId","vendorAgentId","vendorType","idempotencyKey","createdAt","updatedAt","events","recovery","nextActions"]}},"required":["data"]},"PublicApplicationResponse":{"type":"object","properties":{"applicationId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["submitted","reviewing","approved","rejected","spam"]},"duplicate":{"type":"boolean"},"notificationStatus":{"type":"string","enum":["pending","sent","failed","not_configured","skipped"]}},"required":["applicationId","status","duplicate","notificationStatus"]},"PublicApplicationRequest":{"type":"object","properties":{"applicationType":{"type":"string","enum":["developer","vendor","partner","general"],"default":"general"},"email":{"type":"string","maxLength":255,"format":"email"},"name":{"type":"string","minLength":2,"maxLength":160},"company":{"type":"string","maxLength":180},"website":{"anyOf":[{"type":"string","maxLength":255,"format":"uri"},{"type":"string","enum":[""]}]},"useCase":{"type":"string","minLength":1,"maxLength":4000},"capabilities":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"vendorType":{"anyOf":[{"type":"string","enum":["api","ai_agent","tool","compute","data","workflow","hybrid","other"]},{"type":"string","enum":[""]}]},"websiteUrl":{"type":"string","maxLength":255},"metadata":{"type":"object","additionalProperties":{}}},"required":["email","name","useCase"]},"MoneyBreakdown":{"type":"object","properties":{"gross":{"type":"string","example":"0.020000"},"platformFee":{"type":"string","example":"0.000300"},"vendorNet":{"type":"string","example":"0.019700"},"currency":{"type":"string","example":"USD"}},"required":["gross","platformFee","vendorNet","currency"]},"Transaction":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid"},"organizationId":{"type":["string","null"],"format":"uuid"},"workspaceId":{"type":["string","null"],"format":"uuid"},"projectId":{"type":["string","null"],"format":"uuid"},"consumerAgentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"executionStatus":{"type":"string"},"usageStatus":{"type":["string","null"]},"settlementStatus":{"type":["string","null"]},"settlementMode":{"type":["string","null"]},"paymentStatus":{"type":["string","null"]},"reconciliationStatus":{"type":["string","null"]},"amount":{"$ref":"#/components/schemas/MoneyBreakdown"},"usageId":{"type":["string","null"],"format":"uuid"},"settlementId":{"type":["string","null"],"format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["transactionId","organizationId","workspaceId","projectId","consumerAgentId","vendorAgentId","executionStatus","usageStatus","settlementStatus","settlementMode","paymentStatus","reconciliationStatus","amount","usageId","settlementId","createdAt","updatedAt"]},"TransactionList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"UsageEvent":{"type":"object","properties":{"usageId":{"type":"string","format":"uuid"},"transactionId":{"type":"string","format":"uuid"},"consumerAgentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"capabilityId":{"type":["string","null"]},"quantity":{"type":"string"},"unit":{"type":"string"},"unitPrice":{"type":"string"},"currency":{"type":"string"},"usageStatus":{"type":"string"},"settlementStatus":{"type":"string"},"amount":{"type":"object","properties":{"gross":{"type":"string"},"platformFee":{"type":"string"},"vendorNet":{"type":"string"}},"required":["gross","platformFee","vendorNet"]},"occurredAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["usageId","transactionId","consumerAgentId","vendorAgentId","capabilityId","quantity","unit","unitPrice","currency","usageStatus","settlementStatus","amount","occurredAt","createdAt","updatedAt"]},"UsageList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UsageEvent"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"Settlement":{"type":"object","properties":{"settlementId":{"type":"string","format":"uuid"},"settlementType":{"type":"string"},"settlementStatus":{"type":"string"},"reconciliationStatus":{"type":"string"},"consumerAgentId":{"type":"string","format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"transactionId":{"type":["string","null"],"format":"uuid"},"usageCount":{"type":"number"},"provider":{"type":"string"},"currency":{"type":"string"},"amount":{"$ref":"#/components/schemas/MoneyBreakdown"},"createdAt":{"type":"string","format":"date-time"},"settledAt":{"type":["string","null"],"format":"date-time"},"failedAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["settlementId","settlementType","settlementStatus","reconciliationStatus","consumerAgentId","vendorAgentId","transactionId","usageCount","provider","currency","amount","createdAt","settledAt","failedAt","updatedAt"]},"SettlementList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Settlement"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"Agent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["consumer","vendor"]},"organizationId":{"type":"string","format":"uuid"},"workspaceId":{"type":["string","null"],"format":"uuid"},"projectId":{"type":["string","null"],"format":"uuid"},"name":{"type":"string"},"status":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"billingCurrency":{"type":["string","null"]},"serviceEndpoint":{"type":["string","null"]},"unitPrice":{"type":["string","null"]}},"required":["id","kind","organizationId","workspaceId","projectId","name","status","capabilities","billingCurrency","serviceEndpoint","unitPrice"]},"Capability":{"type":"object","properties":{"capabilityId":{"type":"string"},"availability":{"type":"string","enum":["available","unavailable"]},"vendors":{"type":"array","items":{"type":"object","properties":{"vendorAgentId":{"type":"string","format":"uuid"},"vendorName":{"type":"string"},"price":{"type":"string"},"currency":{"type":"string"},"serviceEndpoint":{"type":["string","null"]},"availability":{"type":"string","enum":["available","unavailable"]},"latencyMs":{"type":["number","null"]},"successRate":{"type":["number","null"]},"qualityScore":{"type":["number","null"]}},"required":["vendorAgentId","vendorName","price","currency","serviceEndpoint","availability","latencyMs","successRate","qualityScore"]}}},"required":["capabilityId","availability","vendors"]},"CapabilityList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Capability"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"BillingMetrics":{"type":"object","properties":{"currency":{"type":"string"},"period":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date-time"},"to":{"type":["string","null"],"format":"date-time"}},"required":["from","to"]},"usage":{"type":"object","properties":{"events":{"type":"number"},"gross":{"type":"string"}},"required":["events","gross"]},"settlements":{"type":"object","properties":{"unsettled":{"type":"string"},"settled":{"type":"string"}},"required":["unsettled","settled"]},"platform":{"type":"object","properties":{"fees":{"type":"string"},"paymentProviderFees":{"type":"string"},"externalProviderCosts":{"type":"string"}},"required":["fees","paymentProviderFees","externalProviderCosts"]},"vendors":{"type":"object","properties":{"net":{"type":"string"}},"required":["net"]},"economics":{"type":"object","properties":{"grossProfit":{"type":"string"},"grossMarginPercentage":{"type":"string"}},"required":["grossProfit","grossMarginPercentage"]}},"required":["currency","period","usage","settlements","platform","vendors","economics"]},"Payout":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"workspaceId":{"type":["string","null"],"format":"uuid"},"projectId":{"type":["string","null"],"format":"uuid"},"vendorAgentId":{"type":"string","format":"uuid"},"connectedAccountId":{"type":"string"},"provider":{"type":"string"},"amount":{"type":"string"},"currency":{"type":"string"},"status":{"type":"string"},"arrivalDate":{"type":["string","null"],"format":"date-time"},"failureCode":{"type":["string","null"]},"failureMessage":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"paidAt":{"type":["string","null"],"format":"date-time"}},"required":["id","organizationId","workspaceId","projectId","vendorAgentId","connectedAccountId","provider","amount","currency","status","arrivalDate","failureCode","failureMessage","createdAt","updatedAt","paidAt"]},"PayoutList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payout"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["data","pagination"]},"MeteringAcceptedResponse":{"type":"object","properties":{"status":{"type":"string","enum":["accepted"]},"duplicate":{"type":"boolean"},"meteringEventId":{"type":"string"},"executionId":{"type":"string","format":"uuid"},"usageId":{"type":"string","format":"uuid"},"settlementId":{"type":["string","null"],"format":"uuid"},"settlementStatus":{"type":"string"},"amount":{"$ref":"#/components/schemas/MoneyBreakdown"},"metric":{"type":"string"},"quantity":{"type":"string"},"unit":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"}},"required":["status","duplicate","meteringEventId","executionId","usageId","settlementId","settlementStatus","amount","metric","quantity","unit","occurredAt"]},"MeteringEventRequest":{"type":"object","properties":{"meteringEventId":{"type":"string","minLength":8,"maxLength":200},"executionId":{"type":"string","format":"uuid"},"capabilityId":{"type":"string","minLength":1,"maxLength":255},"metric":{"type":"string","minLength":1,"maxLength":50},"quantity":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,6})?$"},"unit":{"type":"string","minLength":1,"maxLength":50},"occurredAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","additionalProperties":{}}},"required":["executionId","capabilityId","metric","quantity","unit","occurredAt"]}},"parameters":{}},"paths":{"/api/v1/projects/{projectId}/agents/{agentId}/credentials":{"post":{"operationId":"createAgentCredential","summary":"Issue a new credential for an agent","description":"Returns the plaintext secret exactly once. The stored secret is encrypted with AES-256-GCM.","tags":["Developer Credentials"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialCreateRequest"}}}},"responses":{"201":{"description":"Credential issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialIssued"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"listAgentCredentials","summary":"List issued credentials for an agent","description":"Never returns plaintext secrets.","tags":["Developer Credentials"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentId","in":"path"}],"responses":{"200":{"description":"Credential list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialList"}}}}}}},"/api/v1/projects/{projectId}/agents/{agentId}/credentials/{credentialId}/rotate":{"post":{"operationId":"rotateAgentCredential","summary":"Rotate an existing credential","description":"Marks the current credential as rotating, creates a successor, and returns the successor secret once.","tags":["Developer Credentials"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"credentialId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRotateRequest"}}}},"responses":{"201":{"description":"Rotated credential issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialIssued"}}}}}}},"/api/v1/projects/{projectId}/agents/{agentId}/credentials/{credentialId}/revoke":{"post":{"operationId":"revokeAgentCredential","summary":"Revoke an existing credential","description":"Revokes the credential and prevents future auth with the same secret.","tags":["Developer Credentials"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"credentialId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialRevokeRequest"}}}},"responses":{"204":{"description":"Credential revoked."}}}},"/api/v1/marketplace/execute":{"post":{"operationId":"executeMarketplaceTransaction","summary":"Execute a marketplace transaction","description":"Purpose: buy a vendor capability through MonetiAgents. Requires HMAC headers, nonce anti-replay, and idempotency. Financial side effects depend on settlement mode.","tags":["Marketplace"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceExecutionRequest"}}}},"responses":{"200":{"description":"Marketplace execution response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceExecutionResponse"}}}},"202":{"description":"Marketplace execution still processing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceExecutionResponse"}}}},"403":{"description":"Blocked by guardrails or vendor readiness.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceExecutionResponse"}}}}}}},"/api/v1/agent-search":{"post":{"operationId":"searchAgentCommerceEngine","summary":"Search the agent commerce engine","description":"Transactional search for autonomous buyer agents. Returns organic ranked candidates, machine-readable ranking reasons, score breakdown, certification signals and executable next actions without creating spend.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSearchRequest"}}}},"responses":{"200":{"description":"Ranked agent-commerce candidates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSearchResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-sponsored-campaigns":{"get":{"operationId":"listSponsoredCampaigns","summary":"List sponsored placement campaigns","description":"Lists paid placement campaigns visible to the authenticated vendor or organization admin. Sponsored placement never changes organic ranking.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"vendorAgentId","in":"query"},{"schema":{"type":"string","enum":["draft","active","paused","archived"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Sponsored campaign list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignListResponse"}}}}}},"post":{"operationId":"createSponsoredCampaign","summary":"Create a sponsored placement campaign","description":"Creates a vendor-funded campaign for explicit sponsored search placement. Bids are auctioned separately from organic ranking and charged only for valid sponsored impressions.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignCreateRequest"}}}},"responses":{"201":{"description":"Sponsored campaign created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignResponse"}}}},"400":{"description":"Invalid campaign.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/vendor/sponsored-campaigns/{campaignId}/billing":{"get":{"operationId":"getSponsoredCampaignBilling","summary":"Download sponsored campaign billing evidence","description":"Returns a signed, tamper-evident billing report for sponsored impressions so vendor finance agents can reconcile every charged placement against local records.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"campaignId","in":"path"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"periodStart","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"periodEnd","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":500},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Signed sponsored campaign billing report.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredBillingReportResponse"}}}},"400":{"description":"Invalid billing report request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/vendor/sponsored-campaigns/trust-posture":{"get":{"operationId":"getSponsoredCampaignTrustPosture","summary":"List sponsored campaign runtime trust posture","description":"Returns the current discovery trust posture, runtime block counts and reactivation eligibility for sponsored campaigns visible to the authenticated vendor or organization admin.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["active","paused","all"],"default":"paused"},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Sponsored campaign trust posture.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignTrustPostureResponse"}}}}}}},"/api/v1/vendor/sponsored-campaigns/disputes":{"post":{"operationId":"createSponsoredCampaignDispute","summary":"Open a sponsored campaign billing dispute","description":"Lets vendor finance agents dispute sponsored impression charges. The arbiter deterministically evaluates persisted auction events and applies a campaign budget credit only when invalid traffic is proven.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignDisputeRequest"}}}},"responses":{"201":{"description":"Sponsored campaign dispute resolved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignDisputeResponse"}}}},"400":{"description":"Invalid dispute request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/vendor/sponsored-campaigns/{campaignId}/optimize":{"post":{"operationId":"optimizeSponsoredCampaign","summary":"Optimize sponsored campaign bid","description":"Lets vendor optimizer agents adjust campaign bid_amount using deterministic target CPA or max-impressions strategies derived from sponsored billing and conversion evidence.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"campaignId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignOptimizationRequest"}}}},"responses":{"200":{"description":"Sponsored campaign optimization decision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignOptimizationResponse"}}}},"400":{"description":"Invalid optimization request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/vendor/sponsored-campaigns/{campaignId}/reactivate":{"post":{"operationId":"reactivateSponsoredCampaign","summary":"Reactivate a paused sponsored campaign","description":"Reactivates a paused sponsored campaign only when its latest discovery host and site-domain trust posture is back to trusted.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"campaignId","in":"path"}],"responses":{"200":{"description":"Sponsored campaign reactivated or already active.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredCampaignReactivationResponse"}}}},"400":{"description":"Invalid reactivation request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-acquisition/sponsored-market-insights":{"get":{"operationId":"getSponsoredMarketInsights","summary":"Get aggregated sponsored acquisition insights","description":"Returns privacy-preserving capability-level sponsored market signals so agents can discover demand and competition tiers without exposing competitor identities.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":3,"maxLength":255},"required":false,"name":"capabilityKey","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"periodStart","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"periodEnd","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Aggregated sponsored acquisition insights.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SponsoredMarketInsightsResponse"}}}}}}},"/api/v1/agent-discovery/search":{"post":{"operationId":"searchAgentMarketplace","summary":"Search the marketplace by agent intent","description":"Accepts a natural-language intent plus structured requirements and returns ranked marketplace candidates without creating spend.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDiscoveryRequest"}}}},"responses":{"200":{"description":"Ranked marketplace candidates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDiscoveryResponse"}}}},"400":{"description":"Invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-index/submissions":{"post":{"operationId":"submitAgentIndexDescriptor","summary":"Submit an external agent descriptor to the safe index staging queue","description":"Stores public descriptors outside the executable marketplace catalog and evaluates DNS ownership proof, Sybil risk, shared endpoint fingerprints and honeypot signals before staging.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIndexSubmissionRequest"}}}},"responses":{"201":{"description":"Descriptor evaluated and stored in staging, pending proof, quarantine or rejected state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIndexSubmissionResponse"}}}},"400":{"description":"Invalid descriptor submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"listAgentIndexSubmissions","summary":"List public agent index submissions","description":"Returns staged, pending, quarantined or rejected external descriptor submissions for the authenticated organization.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["staging","pending_proof","quarantined","rejected"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":255},"required":false,"name":"host","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Agent index submissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIndexSubmissionListResponse"}}}}}}},"/api/v1/agent-reputation/rebuild":{"post":{"operationId":"rebuildAgentReputation","summary":"Rebuild persistent reputation snapshots","description":"Recomputes vendor reputation from immutable search, transaction, result assurance, reconciliation and certification evidence. Vendors cannot self-declare these scores.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentReputationRebuildRequest"}}}},"responses":{"201":{"description":"Reputation snapshots rebuilt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentReputationRebuildResponse"}}}},"400":{"description":"Invalid rebuild request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-reputation":{"get":{"operationId":"listAgentReputation","summary":"List latest agent reputation snapshots","description":"Returns latest reputation snapshots with public summary and private operator metrics for the authenticated organization.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"vendorAgentId","in":"query"},{"schema":{"type":"string","minLength":3,"maxLength":255},"required":false,"name":"capabilityKey","in":"query"},{"schema":{"type":"string","enum":["excellent","good","watchlist","risky","insufficient_data"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Latest reputation snapshots.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentReputationListResponse"}}}}}}},"/api/v1/escrow/calculate":{"post":{"operationId":"calculateAgentEscrowRequirement","summary":"Calculate reputation-based escrow collateral","description":"Calculates required vendor collateral from the latest persisted reputation snapshot. This read-only endpoint does not reserve funds.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowCalculateRequest"}}}},"responses":{"200":{"description":"Escrow requirement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowRequirementResponse"}}}},"400":{"description":"Invalid calculation request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/escrow/lock":{"post":{"operationId":"lockAgentEscrow","summary":"Lock vendor escrow collateral","description":"Atomically reserves required collateral from the vendor escrow account based on reputation. Requires an Idempotency-Key.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowLockRequest"}}}},"responses":{"201":{"description":"Escrow hold created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowHoldResponse"}}}},"422":{"description":"Insufficient escrow collateral.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/escrow/{escrowHoldId}/release":{"post":{"operationId":"releaseAgentEscrow","summary":"Release held escrow collateral","description":"Atomically returns held collateral to the vendor escrow account after buyer acceptance or manual release. Requires an Idempotency-Key.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"escrowHoldId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowReleaseRequest"}}}},"responses":{"200":{"description":"Escrow hold released.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowHoldResponse"}}}}}}},"/api/v1/escrow/{escrowHoldId}/dispute":{"post":{"operationId":"disputeAgentEscrow","summary":"Move held escrow into dispute","description":"Freezes held collateral in disputed status while a buyer or operator dispute is investigated.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"escrowHoldId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowDisputeRequest"}}}},"responses":{"200":{"description":"Escrow hold disputed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEscrowHoldResponse"}}}}}}},"/api/v1/vendor/reputation/diagnostics":{"get":{"operationId":"getOwnVendorReputationDiagnostics","summary":"Explain private vendor reputation and promotion readiness","description":"Returns private ADO diagnostics for the authenticated vendor credential, including promotion blockers and remediation hints. Organization admins may supply vendorAgentId as a query parameter.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"vendorAgentId","in":"query"},{"schema":{"type":"string","minLength":3,"maxLength":255},"required":false,"name":"capabilityKey","in":"query"},{"schema":{"type":"string","enum":["metadata_only","transactional","premium_transactional"],"default":"transactional"},"required":false,"name":"requestedTier","in":"query"}],"responses":{"200":{"description":"Private ADO diagnostics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorDiagnosticsResponse"}}}},"403":{"description":"Vendor credential attempted to inspect another vendor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-descriptors/{vendorAgentId}/diagnostics":{"get":{"operationId":"getAgentDescriptorDiagnostics","summary":"Explain descriptor promotion readiness","description":"Returns private ADO diagnostics for a vendor descriptor. Vendor credentials may only inspect themselves; organization admins may inspect any vendor in their organization.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"vendorAgentId","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":false,"name":"vendorAgentId","in":"query"},{"schema":{"type":"string","minLength":3,"maxLength":255},"required":false,"name":"capabilityKey","in":"query"},{"schema":{"type":"string","enum":["metadata_only","transactional","premium_transactional"],"default":"transactional"},"required":false,"name":"requestedTier","in":"query"}],"responses":{"200":{"description":"Private descriptor diagnostics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorDiagnosticsResponse"}}}}}}},"/api/v1/agent-descriptors/{vendorAgentId}/draft":{"put":{"operationId":"updateAgentDescriptorDraft","summary":"Upload a draft agent descriptor","description":"Stores a draft descriptor without changing the live marketplace index. Promotion is a separate policy-gated step.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"vendorAgentId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorDraftRequest"}}}},"responses":{"200":{"description":"Draft descriptor stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorDraftResponse"}}}},"400":{"description":"Invalid descriptor draft.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-descriptors/{vendorAgentId}/promote":{"post":{"operationId":"promoteAgentDescriptor","summary":"Promote a draft descriptor to live","description":"Atomically promotes a draft descriptor to live after schema, ownership and ADO reputation policy checks. Blocked promotions return 422 with machine-readable diagnostics.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"vendorAgentId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorPromotionRequest"}}}},"responses":{"200":{"description":"Descriptor promoted to live.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDescriptorPromotionResponse"}}}},"422":{"description":"Promotion blocked by ADO policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-commerce/intents":{"post":{"operationId":"executeAgentIntent","summary":"Execute an agent intent through MonetiAgents","description":"Composes discovery, candidate selection, quote, authorization, marketplace execution and an agent-run envelope under one idempotency key.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIntentExecutionRequest"}}}},"responses":{"201":{"description":"Intent accepted and executed or queued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIntentExecutionResponse"}}}},"400":{"description":"No candidate, budget denial or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-wallets/readiness":{"get":{"operationId":"getAgentWalletReadiness","summary":"Read buyer agent wallet readiness","description":"Returns buyer wallet readiness, available budget rails and delegated-spend mode before a spend-creating call is attempted.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"buyerAgentId","in":"query"},{"schema":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Wallet readiness status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentWalletReadinessResponse"}}}}}}},"/api/v1/agent-wallets/delegations":{"post":{"operationId":"issueDelegatedSpendToken","summary":"Issue a delegated spend token","description":"Creates a bounded delegated-spend token that can authorize another runtime to spend on behalf of a buyer agent under strict amount, currency and scope constraints.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedSpendTokenIssueRequest"}}}},"responses":{"201":{"description":"Delegated spend token issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedSpendTokenIssuedResponse"}}}}}},"get":{"operationId":"listDelegatedSpendTokens","summary":"List delegated spend tokens","description":"Lists active or historical delegated spend tokens for a buyer agent without revealing raw token secrets.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"buyerAgentId","in":"query"},{"schema":{"type":["boolean","null"],"default":false},"required":false,"name":"includeRevoked","in":"query"}],"responses":{"200":{"description":"Delegated spend tokens.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedSpendTokenListResponse"}}}}}}},"/api/v1/agent-wallets/delegations/{delegationId}/revoke":{"post":{"operationId":"revokeDelegatedSpendToken","summary":"Revoke a delegated spend token","description":"Revokes an existing delegated spend token so future spend attempts fail closed.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"delegationId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedSpendTokenRevokeRequest"}}}},"responses":{"200":{"description":"Delegated spend token revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegatedSpendTokenResponse"}}}}}}},"/api/v1/commerce/transactions/{transactionId}/timeline":{"get":{"operationId":"getCommerceTransactionTimeline","summary":"Get a commerce transaction timeline","description":"Returns a tenant-scoped chronological view of commerce, vendor, evidence, ledger, saga, outbox and inbox events for agent self-correction and operator debugging.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"transactionId","in":"path"}],"responses":{"200":{"description":"Commerce transaction timeline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionTimelineResponse"}}}},"404":{"description":"Transaction not found or not visible to the authenticated actor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/operations/compensation/catalog":{"get":{"operationId":"listSagaCompensationCatalog","summary":"List saga compensation catalog","description":"Returns the declarative compensation actions supported by MonetiAgents for operator-controlled recovery. This endpoint does not mutate state.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"Saga compensation catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SagaCompensationCatalogResponse"}}}}}}},"/api/v1/operations/recovery/overview":{"get":{"operationId":"getRecoveryOperationsOverview","summary":"Get recovery operations overview","description":"Returns tenant-scoped saga and outbox recovery health, alert thresholds, 24-hour activity counters and next actions for an operator cockpit.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"Recovery operations overview.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoveryOperationsOverviewResponse"}}}}}}},"/api/v1/operations/recovery/sagas":{"get":{"operationId":"listRecoverySagaQueue","summary":"List recovery saga queue","description":"Lists failed, compensating, manual-review and dead-letter saga instances with counts, latest events and recommended next actions.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["failed","compensating","manual_review","dead_letter"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Recovery saga queue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverySagaQueueResponse"}}}}}}},"/api/v1/operations/recovery/outbox":{"get":{"operationId":"listRecoveryOutboxQueue","summary":"List recovery outbox queue","description":"Lists pending, claimed, failed, dead-letter and stale-claimed transactional outbox events for operator recovery workflows.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["pending","claimed","failed","dead_letter","stale_claim"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Recovery outbox queue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoveryOutboxQueueResponse"}}}}}}},"/api/v1/operations/outbox/{eventId}/replay":{"post":{"operationId":"replayDeadLetterOutboxEvent","summary":"Replay a dead-lettered outbox event","description":"Moves a tenant-scoped transactional outbox event from dead_letter back to pending for publisher retry. Requires Idempotency-Key and organization admin credentials.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"eventId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboxReplayRequest"}}}},"responses":{"200":{"description":"Outbox event replay was accepted or idempotently recognized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboxReplayResponse"}}}},"404":{"description":"Outbox event not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Outbox event is not eligible for replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/operations/transactions/{transactionId}/compensations":{"post":{"operationId":"requestSagaCompensation","summary":"Request saga compensation for a transaction","description":"Moves the transaction saga into compensating or manual_review state and records an auditable recovery event. This endpoint does not execute money movement by itself.","tags":["Operations"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"transactionId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SagaCompensationRequest"}}}},"responses":{"202":{"description":"Saga compensation request accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SagaCompensationResponse"}}}},"404":{"description":"Saga not found for transaction.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Saga is not eligible for compensation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-certifications":{"get":{"operationId":"listAgentCertifications","summary":"List agent vendor certifications","description":"Returns persisted compatibility certification records for vendors and capabilities in the authenticated organization.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":false,"name":"vendorAgentId","in":"query"},{"schema":{"type":"string","minLength":3,"maxLength":255},"required":false,"name":"capabilityKey","in":"query"},{"schema":{"type":"string","enum":["certified","failed","expired","needs_review"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Agent vendor certification records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCertificationListResponse"}}}},"400":{"description":"Invalid certification filter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-runs":{"post":{"operationId":"createAgentRunEnvelope","summary":"Create an agent-run envelope","description":"Persists auditable agent intent, plan, decision trace, tool calls, observations, result, evidence and metering.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRunEnvelopeRequest"}}}},"responses":{"201":{"description":"Agent-run envelope created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRunEnvelopeResponse"}}}}}}},"/api/v1/agent-harness/tools":{"get":{"operationId":"listAgentHarnessTools","summary":"List canonical agent harness tools","description":"Returns machine-readable tools with side-effect labels, required capabilities, idempotency requirements, retry policy and schema references.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"Harness tools manifest.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HarnessToolsResponse"}}}}}}},"/api/v1/agent-runs/{agentRunId}":{"get":{"operationId":"getAgentRunEnvelope","summary":"Get an agent-run envelope","description":"Returns an auditable agent-run envelope by id.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentRunId","in":"path"}],"responses":{"200":{"description":"Agent-run envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRunEnvelopeResponse"}}}},"404":{"description":"Agent-run envelope not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agent-runs/{agentRunId}/timeline":{"get":{"operationId":"getAgentRunTimeline","summary":"Get an agent-run timeline","description":"Returns a compact chronological view of the agent run optimized for agent self-correction and operator debugging.","tags":["Agent Commerce"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"agentRunId","in":"path"}],"responses":{"200":{"description":"Agent-run timeline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRunTimelineResponse"}}}},"404":{"description":"Agent-run envelope not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/public/applications":{"post":{"operationId":"submitPublicApplication","summary":"Submit a public beta application","description":"Public controlled-intake endpoint for external developers and independent vendors. Supports `Idempotency-Key` to prevent duplicate applications.","tags":["Public Onboarding"],"parameters":[{"schema":{"type":"string","example":"join_monetiagents_01"},"required":false,"name":"Idempotency-Key","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApplicationRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PublicApplicationRequest"}}}},"responses":{"200":{"description":"Duplicate application replayed idempotently.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApplicationResponse"}}}},"201":{"description":"Application accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApplicationResponse"}}}},"400":{"description":"Invalid public application payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/transactions":{"get":{"operationId":"listTransactions","summary":"List marketplace transactions","description":"List marketplace transactions","tags":["Transactions"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"List marketplace transactions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionList"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/transactions/{id}":{"get":{"operationId":"getTransaction","summary":"Get a single transaction","description":"Get a single transaction","tags":["Transactions"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get a single transaction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transaction"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/usage":{"get":{"operationId":"listUsageEvents","summary":"List usage events","description":"List usage events","tags":["Usage"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"List usage events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageList"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/usage/{usageId}":{"get":{"operationId":"getUsageEvent","summary":"Get a single usage event","description":"Get a single usage event","tags":["Usage"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"usageId","in":"path"}],"responses":{"200":{"description":"Get a single usage event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageEvent"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/settlements":{"get":{"operationId":"listSettlements","summary":"List settlements","description":"List settlements","tags":["Settlements"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"List settlements","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementList"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/settlements/{id}":{"get":{"operationId":"getSettlement","summary":"Get a single settlement","description":"Get a single settlement","tags":["Settlements"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get a single settlement","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Settlement"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/me":{"get":{"operationId":"getAuthenticatedAgent","summary":"Get the authenticated agent profile","description":"Get the authenticated agent profile","tags":["Agents"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"Get the authenticated agent profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/agents/{id}":{"get":{"operationId":"getAgent","summary":"Get an agent profile","description":"Get an agent profile","tags":["Agents"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get an agent profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/capabilities":{"get":{"operationId":"listCapabilities","summary":"List discoverable capabilities","description":"List discoverable capabilities","tags":["Capabilities"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"List discoverable capabilities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityList"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/capabilities/{id}":{"get":{"operationId":"getCapability","summary":"Get a capability","description":"Get a capability","tags":["Capabilities"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get a capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capability"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/billing/metrics":{"get":{"operationId":"getBillingMetrics","summary":"Get billing metrics","description":"Get billing metrics","tags":["Billing"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"Get billing metrics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingMetrics"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/billing/payouts":{"get":{"operationId":"listPayouts","summary":"List payout records","description":"List payout records","tags":["Billing"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"responses":{"200":{"description":"List payout records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutList"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/billing/payouts/{id}":{"get":{"operationId":"getPayout","summary":"Get a payout record","description":"Get a payout record","tags":["Billing"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get a payout record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payout"}}}},"404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/metering/events":{"post":{"operationId":"createMeteringEvent","summary":"Report vendor metering units","description":"Vendors report measured units only. MonetiAgents calculates prices, creates or links usage, and deduplicates by `meteringEventId`.","tags":["Metering"],"security":[{"BearerAuth":[]},{"MonetiHmacAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeteringEventRequest"}}}},"responses":{"200":{"description":"Duplicate metering event replayed idempotently.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeteringAcceptedResponse"}}}},"201":{"description":"Metering event accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeteringAcceptedResponse"}}}}}}}},"webhooks":{}}