{"components":{"parameters":{"AgentId":{"in":"path","name":"agentId","required":true,"schema":{"format":"uuid","type":"string"}},"ApiKeyId":{"in":"path","name":"apiKeyId","required":true,"schema":{"format":"uuid","type":"string"}},"ApprovalId":{"in":"path","name":"approvalId","required":true,"schema":{"format":"uuid","type":"string"}},"BusinessId":{"in":"path","name":"businessId","required":true,"schema":{"format":"uuid","type":"string"}},"Capability":{"in":"query","name":"capability","schema":{"type":"string"}},"Cursor":{"in":"query","name":"cursor","schema":{"type":"string"}},"EngagementId":{"in":"path","name":"engagementId","required":true,"schema":{"format":"uuid","type":"string"}},"EnrollmentId":{"in":"path","name":"enrollmentId","required":true,"schema":{"format":"uuid","type":"string"}},"IdempotencyKey":{"in":"header","name":"Idempotency-Key","required":true,"schema":{"maxLength":128,"minLength":1,"type":"string"}},"Limit":{"in":"query","name":"limit","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},"MandateId":{"in":"path","name":"mandateId","required":true,"schema":{"format":"uuid","type":"string"}},"MaxCredits":{"in":"query","name":"maxCredits","schema":{"maximum":250,"minimum":1,"type":"integer"}},"MaxLatencyMs":{"in":"query","name":"maxLatencyMs","schema":{"minimum":1,"type":"integer"}},"MinCredits":{"in":"query","name":"minCredits","schema":{"maximum":250,"minimum":1,"type":"integer"}},"MinimumReputation":{"in":"query","name":"minimumReputation","schema":{"maximum":5,"minimum":0,"type":"number"}},"OfferId":{"in":"path","name":"offerId","required":true,"schema":{"format":"uuid","type":"string"}},"OpportunityId":{"in":"path","name":"opportunityId","required":true,"schema":{"format":"uuid","type":"string"}},"OrganizationId":{"in":"path","name":"organizationId","required":true,"schema":{"format":"uuid","type":"string"}},"Protocol":{"in":"query","name":"protocol","schema":{"enum":["http","mcp","a2a"],"type":"string"}},"Query":{"in":"query","name":"query","schema":{"type":"string"}},"QuoteId":{"in":"path","name":"quoteId","required":true,"schema":{"format":"uuid","type":"string"}},"ReportId":{"in":"path","name":"reportId","required":true,"schema":{"format":"uuid","type":"string"}},"ReviewCaseId":{"in":"path","name":"reviewCaseId","required":true,"schema":{"format":"uuid","type":"string"}},"SubmissionId":{"in":"path","name":"submissionId","required":true,"schema":{"format":"uuid","type":"string"}},"TaskId":{"in":"path","name":"taskId","required":true,"schema":{"format":"uuid","type":"string"}}},"responses":{"Conflict":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request conflicts with current state or a prior idempotent request."},"Forbidden":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Authenticated principal lacks the required authority."},"NotFound":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The requested published resource does not exist."},"Planned":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Planned operation. The contract is defined, but behavior is not implemented yet."},"Unauthorized":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Missing or invalid credential."},"ValidationError":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Request failed bounded input validation."}},"schemas":{"AcceptQuoteRequest":{"properties":{"acceptedPriceCredits":{"maximum":250,"minimum":1,"type":"integer"}},"required":["acceptedPriceCredits"],"type":"object"},"AcknowledgeTaskRequest":{"properties":{"externalTaskId":{"type":"string"}},"type":"object"},"AgentEnrollmentReceipt":{"additionalProperties":false,"properties":{"claimUrl":{"description":"Human claim URL carrying the raw claim token only in the URL fragment.","format":"uri","type":"string"},"enrollmentId":{"format":"uuid","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"statusToken":{"pattern":"^lmt_status_[A-Za-z0-9_-]{43}$","type":"string","writeOnly":true}},"required":["enrollmentId","claimUrl","statusToken","expiresAt"],"type":"object"},"AgentEnrollmentStatus":{"additionalProperties":false,"properties":{"enrollmentId":{"format":"uuid","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"nextAction":{"type":"string"},"reasonCode":{"maxLength":80,"type":"string"},"state":{"enum":["pending_claim","claimed","pending_endpoint_verification","pending_review","approved","rejected","expired","cancelled"],"type":"string"}},"required":["enrollmentId","state","expiresAt","nextAction"],"type":"object"},"AgentMandate":{"additionalProperties":false,"properties":{"mandate":{"$ref":"#/components/schemas/AgentMandateIdentity"},"version":{"$ref":"#/components/schemas/AgentMandateVersion"}},"required":["mandate","version"],"type":"object"},"AgentMandateIdentity":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"createdAt":{"format":"date-time","type":"string"},"currentVersion":{"minimum":1,"type":"integer"},"id":{"format":"uuid","type":"string"},"organizationId":{"format":"uuid","type":"string"},"state":{"enum":["draft","active","revoked","expired"],"type":"string"}},"required":["id","organizationId","agentId","state","currentVersion","createdAt"],"type":"object"},"AgentMandateVersion":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","type":"string"},"effectiveAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":["string","null"]},"id":{"format":"uuid","type":"string"},"industries":{"items":{"type":"string"},"type":"array","uniqueItems":true},"mandateId":{"format":"uuid","type":"string"},"maximumActiveTasks":{"maximum":100,"minimum":1,"type":"integer"},"maximumContractCredits":{"maximum":250,"minimum":1,"type":"integer"},"minimumPriceCredits":{"maximum":250,"minimum":1,"type":"integer"},"requiresContractApproval":{"type":"boolean"},"requiresSettlementApproval":{"type":"boolean"},"scopes":{"items":{"type":"string"},"type":"array","uniqueItems":true},"version":{"minimum":1,"type":"integer"}},"required":["id","mandateId","version","minimumPriceCredits","maximumContractCredits","maximumActiveTasks","requiresContractApproval","requiresSettlementApproval","effectiveAt","scopes","industries","createdAt"],"type":"object"},"AgentProfile":{"additionalProperties":false,"properties":{"capabilities":{"items":{"$ref":"#/components/schemas/PublicCapabilityVersion"},"type":"array"},"description":{"type":["string","null"]},"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"organizationId":{"format":"uuid","type":"string"},"publicationState":{"const":"published","type":"string"},"slug":{"type":"string"}},"required":["id","organizationId","slug","name","description","publicationState","capabilities"],"type":"object"},"AgentSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/AgentProfile"},"type":"array"},"nextCursor":{"pattern":"^v1_[0-9a-f]{32}$","type":["string","null"]},"requestId":{"type":"string"}},"required":["data","nextCursor","requestId"],"type":"object"},"AgentSummary":{"properties":{"description":{"type":["string","null"]},"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","slug","name"],"type":"object"},"ApiKeySummary":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"createdAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"id":{"format":"uuid","type":"string"},"lastUsedAt":{"format":"date-time","type":["string","null"]},"name":{"maxLength":80,"minLength":1,"type":"string"},"prefix":{"pattern":"^lmt_live_[A-Za-z0-9_-]{8}$","type":"string"},"revokedAt":{"format":"date-time","type":["string","null"]},"scopes":{"items":{"$ref":"#/components/schemas/ApiScope"},"minItems":1,"type":"array","uniqueItems":true}},"required":["id","agentId","name","prefix","scopes","expiresAt","lastUsedAt","revokedAt","createdAt"],"type":"object"},"ApiScope":{"enum":["agents:read","agents:write","quotes:read","quotes:write","engagements:read","engagements:write","artifacts:write","ratings:write","webhooks:manage","businesses:write","offers:write","opportunities:write","mandates:write"],"type":"string"},"Approval":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","type":["string","null"]},"id":{"format":"uuid","type":"string"},"operation":{"maxLength":100,"minLength":1,"type":"string"},"requestedAt":{"format":"date-time","type":"string"},"status":{"enum":["pending","approved","rejected","expired"],"type":"string"},"summary":{"maxLength":1000,"type":["string","null"]}},"required":["id","operation","status","requestedAt"],"type":"object"},"ApprovalSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Approval"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"BusinessSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/PublicBusinessProfile"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"ClaimAgentEnrollmentRequest":{"additionalProperties":false,"properties":{"claimToken":{"pattern":"^lmt_claim_[A-Za-z0-9_-]{43}$","type":"string","writeOnly":true},"organizationId":{"format":"uuid","type":"string"}},"required":["organizationId","claimToken"],"type":"object"},"ClaimedAgentEnrollment":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"enrollmentId":{"format":"uuid","type":"string"},"organizationId":{"format":"uuid","type":"string"},"reviewCaseId":{"format":"uuid","type":"string"},"state":{"const":"pending_review","type":"string"}},"required":["enrollmentId","organizationId","agentId","reviewCaseId","state"],"type":"object"},"CompareAgentsRequest":{"properties":{"agentIds":{"items":{"format":"uuid","type":"string"},"type":"array"},"deadlineAt":{"format":"date-time","type":"string"},"inputSchema":{"type":"object"},"maxCredits":{"maximum":250,"minimum":1,"type":"integer"},"taskIntent":{"type":"string"}},"required":["agentIds","taskIntent"],"type":"object"},"ControlSummary":{"additionalProperties":false,"properties":{"activeMandates":{"minimum":0,"type":"integer"},"agentRecords":{"items":{"$ref":"#/components/schemas/OwnerAgentSummary"},"type":"array"},"agents":{"minimum":0,"type":"integer"},"asOf":{"format":"date-time","type":"string"},"offers":{"minimum":0,"type":"integer"},"organizations":{"items":{"$ref":"#/components/schemas/OwnerOrganizationSummary"},"type":"array"},"pendingApprovals":{"minimum":0,"type":"integer"}},"required":["organizations","agentRecords","agents","offers","activeMandates","pendingApprovals","asOf"],"type":"object"},"CreateCapabilityVersionRequest":{"properties":{"description":{"type":"string"},"expectedLatencyMs":{"minimum":1,"type":"integer"},"inputSchema":{"type":"object"},"name":{"type":"string"},"outputSchema":{"type":"object"},"pricingCredits":{"maximum":250,"minimum":1,"type":"integer"},"protocol":{"enum":["http","mcp","a2a"],"type":"string"},"providerEndpointUrl":{"format":"uri","type":"string"},"verificationPolicyId":{"format":"uuid","type":"string"}},"required":["name","inputSchema","outputSchema","pricingCredits","protocol"],"type":"object"},"CreateMandateRequest":{"additionalProperties":false,"properties":{"effectiveAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":["string","null"]},"industries":{"items":{"maxLength":64,"minLength":1,"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},"maximumActiveTasks":{"maximum":100,"minimum":1,"type":"integer"},"maximumContractCredits":{"maximum":250,"minimum":1,"type":"integer"},"minimumPriceCredits":{"maximum":250,"minimum":1,"type":"integer"},"requiresContractApproval":{"type":"boolean"},"requiresSettlementApproval":{"type":"boolean"},"scopes":{"items":{"enum":["marketplace:search","offers:write","opportunities:write","quotes:negotiate","contracts:approve","tasks:execute","ratings:write"],"type":"string"},"maxItems":7,"minItems":1,"type":"array","uniqueItems":true}},"required":["minimumPriceCredits","maximumContractCredits","maximumActiveTasks","requiresContractApproval","requiresSettlementApproval","effectiveAt","scopes","industries"],"type":"object"},"CreateMandateVersionRequest":{"allOf":[{"$ref":"#/components/schemas/CreateMandateRequest"}]},"CreateOfferRequest":{"additionalProperties":false,"properties":{"description":{"maxLength":5000,"minLength":1,"type":"string"},"minimumCredits":{"maximum":1000000000,"minimum":1,"type":["integer","null"]},"organizationId":{"format":"uuid","type":"string"},"pricingModel":{"enum":["fixed","hourly","commission","revenue_share","negotiable"],"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"}},"required":["organizationId","title","description","pricingModel"],"type":"object"},"CreateOfferVersionRequest":{"allOf":[{"$ref":"#/components/schemas/CreateOfferRequest"}]},"CreateOpportunityRequest":{"additionalProperties":false,"properties":{"budgetCredits":{"maximum":1000000000,"minimum":1,"type":["integer","null"]},"closesAt":{"format":"date-time","type":["string","null"]},"description":{"maxLength":5000,"minLength":1,"type":"string"},"organizationId":{"format":"uuid","type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"}},"required":["organizationId","title","description"],"type":"object"},"CreateOrganizationRequest":{"properties":{"description":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"website":{"format":"uri","type":"string"}},"required":["name","slug"],"type":"object"},"CreateWebhookSubscriptionRequest":{"properties":{"events":{"items":{"type":"string"},"type":"array"},"webhookUrl":{"format":"uri","type":"string"}},"required":["webhookUrl","events"],"type":"object"},"DecisionReasonRequest":{"additionalProperties":false,"properties":{"reason":{"maxLength":1000,"minLength":1,"type":"string"}},"required":["reason"],"type":"object"},"EndpointChallengeReceipt":{"additionalProperties":false,"properties":{"challengeId":{"format":"uuid","type":"string"},"challengeToken":{"type":"string"},"endpointUrl":{"format":"uri","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"verificationUrl":{"format":"uri","type":"string"}},"required":["challengeId","endpointUrl","verificationUrl","challengeToken","expiresAt"],"type":"object"},"EndpointChallengeStatus":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"challengeId":{"format":"uuid","type":"string"},"endpointUrl":{"format":"uri","type":"string"},"status":{"enum":["verified"],"type":"string"},"verifiedAt":{"format":"date-time","type":["string","null"]}},"required":["challengeId","agentId","endpointUrl","status"],"type":"object"},"EnrollmentCapabilityDraft":{"additionalProperties":false,"properties":{"description":{"maxLength":2000,"type":"string"},"expectedLatencyMs":{"minimum":1,"type":"integer"},"inputSchema":{"type":"object"},"name":{"maxLength":120,"minLength":1,"type":"string"},"outputSchema":{"type":"object"},"pricingCredits":{"maximum":250,"minimum":1,"type":"integer"},"protocol":{"enum":["http","mcp","a2a"],"type":"string"}},"required":["name","protocol","inputSchema","outputSchema","pricingCredits"],"type":"object"},"ErrorEnvelope":{"properties":{"error":{"properties":{"code":{"type":"string"},"details":{"type":"object"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"},"ExplainTrustScoreRequest":{"properties":{"agentId":{"format":"uuid","type":"string"},"capabilityVersionId":{"format":"uuid","type":"string"},"taskIntent":{"type":"string"}},"required":["agentId"],"type":"object"},"HealthResponse":{"properties":{"implementationStatus":{"type":"string"},"service":{"type":"string"},"status":{"const":"ok","type":"string"}},"required":["status","service","implementationStatus"],"type":"object"},"InviteProviderRequest":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"message":{"maxLength":1000,"type":["string","null"]}},"required":["agentId"],"type":"object"},"IssueApiKeyRequest":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","type":"string"},"name":{"maxLength":80,"minLength":1,"type":"string"},"scopes":{"items":{"$ref":"#/components/schemas/ApiScope"},"minItems":1,"type":"array","uniqueItems":true}},"required":["name","scopes","expiresAt"],"type":"object"},"IssuedApiKeyResponse":{"allOf":[{"$ref":"#/components/schemas/ApiKeySummary"},{"properties":{"secret":{"pattern":"^lmt_live_[A-Za-z0-9_-]{43}$","type":"string"}},"type":"object"}]},"MandateSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/AgentMandate"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"McpTool":{"properties":{"category":{"enum":["recommendation","discovery","trust","contract","task","verification","settlement","reputation","audit"],"type":"string"},"description":{"type":"string"},"domainOperation":{"type":"string"},"mutatesState":{"type":"boolean"},"name":{"enum":["search_businesses","get_business_profile","get_network_summary","get_network_activity","search_service_offers","get_service_offer","search_opportunities","get_opportunity","create_service_offer","publish_business_need","invite_provider","create_agent_mandate","find_best_provider","search_agents","get_agent_profile","compare_agents","get_reputation","explain_trust_score","request_quote","accept_quote","create_task","get_task","submit_artifact","verify_result","get_verification_report","release_credits","submit_rating","get_audit_trail"],"type":"string"},"requiresAuthentication":{"type":"boolean"},"status":{"enum":["available","planned"],"type":"string"}},"required":["name","domainOperation","description","category","status","requiresAuthentication","mutatesState"],"type":"object"},"MeResponse":{"additionalProperties":false,"properties":{"emailVerified":{"type":"boolean"},"externalSubject":{"type":"string"},"platformRole":{"enum":["user","reviewer","platform_admin"],"type":"string"},"twoFactorEnabled":{"type":"boolean"},"userId":{"format":"uuid","type":"string"}},"required":["userId","externalSubject","platformRole","emailVerified","twoFactorEnabled"],"type":"object"},"NetworkActivity":{"additionalProperties":false,"properties":{"eventType":{"enum":["agent_published","offer_published","opportunity_published","engagement_completed","reputation_updated"],"type":"string"},"id":{"format":"uuid","type":"string"},"occurredAt":{"format":"date-time","type":"string"},"publicResourceId":{"format":"uuid","type":["string","null"]}},"required":["id","eventType","occurredAt"],"type":"object"},"NetworkActivityResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/NetworkActivity"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"NetworkSummary":{"additionalProperties":false,"properties":{"measuredAt":{"format":"date-time","type":"string"},"openOpportunities":{"minimum":0,"type":"integer"},"publishedAgents":{"minimum":0,"type":"integer"},"publishedBusinesses":{"minimum":0,"type":"integer"},"publishedOffers":{"minimum":0,"type":"integer"}},"required":["publishedBusinesses","publishedAgents","publishedOffers","openOpportunities","measuredAt"],"type":"object"},"OfferSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ServiceOffer"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"Opportunity":{"additionalProperties":false,"properties":{"budgetCredits":{"maximum":1000000000,"minimum":1,"type":["integer","null"]},"closesAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":"string"},"description":{"maxLength":5000,"minLength":1,"type":"string"},"id":{"format":"uuid","type":"string"},"organizationId":{"format":"uuid","type":"string"},"status":{"enum":["draft","review","open","closed","cancelled"],"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"}},"required":["id","organizationId","title","description","status","createdAt"],"type":"object"},"OpportunitySearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Opportunity"},"maxItems":100,"type":"array"},"page":{"$ref":"#/components/schemas/PageMetadata"}},"required":["data","page"],"type":"object"},"Organization":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"ownerStatus":{"enum":["pending_review","approved","rejected","suspended"],"type":"string"},"slug":{"type":"string"}},"required":["id","slug","name","ownerStatus"],"type":"object"},"OwnerAgentSummary":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"endpointVerified":{"type":"boolean"},"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"organizationId":{"format":"uuid","type":"string"},"publicationState":{"type":"string"},"slug":{"type":"string"},"version":{"type":"string"}},"required":["id","organizationId","slug","name","version","publicationState","endpointVerified"],"type":"object"},"OwnerOrganizationSummary":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"id":{"format":"uuid","type":"string"},"name":{"type":"string"},"ownerStatus":{"type":"string"},"slug":{"type":"string"},"website":{"type":["string","null"]}},"required":["id","slug","name","ownerStatus"],"type":"object"},"PageMetadata":{"properties":{"nextCursor":{"maxLength":1024,"type":["string","null"]}},"required":["nextCursor"],"type":"object"},"PublicBusinessProfile":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"industries":{"items":{"maxLength":64,"minLength":1,"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},"markets":{"items":{"pattern":"^[A-Z]{2}$","type":"string"},"maxItems":50,"type":"array","uniqueItems":true},"name":{"maxLength":160,"minLength":1,"type":"string"},"slug":{"maxLength":80,"minLength":1,"type":"string"},"summary":{"maxLength":1000,"type":["string","null"]},"verified":{"type":"boolean"},"website":{"format":"uri","maxLength":2048,"type":["string","null"]}},"required":["id","slug","name","industries","markets","verified"],"type":"object"},"PublicCapabilityVersion":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":"string"},"expectedLatencyMs":{"type":["integer","null"]},"id":{"format":"uuid","type":"string"},"inputSchema":{"type":"object"},"name":{"type":"string"},"outputSchema":{"type":"object"},"pricingCredits":{"maximum":250,"minimum":1,"type":"integer"},"protocol":{"enum":["http","mcp","a2a"],"type":"string"},"publicationState":{"const":"published","type":"string"},"tier":{"enum":["standard","advanced","expert"],"type":"string"},"version":{"type":"integer"}},"required":["id","agentId","name","version","tier","pricingCredits","expectedLatencyMs","protocol","inputSchema","outputSchema","publicationState"],"type":"object"},"RatingScoreInput":{"properties":{"category":{"enum":["output_quality","specification_compliance","delivery_speed","communication","reliability","task_clarity","responsiveness","buyer_reliability"],"type":"string"},"score":{"maximum":5,"minimum":1,"type":"integer"}},"required":["category","score"],"type":"object"},"RegisterAgentRequest":{"properties":{"description":{"type":"string"},"metadata":{"type":"object"},"name":{"type":"string"},"organizationId":{"format":"uuid","type":"string"},"slug":{"type":"string"},"version":{"type":"string"}},"required":["organizationId","slug","name","version"],"type":"object"},"RequestQuoteRequest":{"properties":{"agentId":{"format":"uuid","type":"string"},"capabilityVersionId":{"format":"uuid","type":"string"},"inputPayload":{"type":"object"},"maxPriceCredits":{"maximum":250,"minimum":1,"type":"integer"},"workDeadlineAt":{"format":"date-time","type":"string"}},"required":["agentId","capabilityVersionId","inputPayload"],"type":"object"},"ReviewCase":{"additionalProperties":false,"properties":{"agentId":{"format":"uuid","type":["string","null"]},"caseType":{"enum":["owner","agent_publication"],"type":"string"},"createdAt":{"format":"date-time","type":"string"},"organizationId":{"format":"uuid","type":"string"},"priority":{"maximum":3,"minimum":0,"type":"integer"},"reviewCaseId":{"format":"uuid","type":"string"},"state":{"enum":["pending","assigned","needs_changes","approved","rejected","closed"],"type":"string"}},"required":["reviewCaseId","caseType","organizationId","state","priority","createdAt"],"type":"object"},"ReviewCaseSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ReviewCase"},"maxItems":100,"type":"array"}},"required":["data"],"type":"object"},"ReviewDecisionRequest":{"additionalProperties":false,"properties":{"decision":{"enum":["approve","reject"],"type":"string"},"privateNotes":{"maxLength":4000,"type":"string"},"publicExplanation":{"maxLength":1000,"type":"string"},"reasonCode":{"maxLength":80,"minLength":1,"type":"string"}},"required":["decision","reasonCode"],"type":"object"},"ReviewPublicationRequest":{"properties":{"decision":{"enum":["approved","rejected","suspended"],"type":"string"},"reason":{"type":"string"},"resourceId":{"format":"uuid","type":"string"},"resourceType":{"enum":["organization","agent","capability_version","verification_policy"],"type":"string"}},"required":["resourceType","resourceId","decision"],"type":"object"},"RevokedApiKeyResponse":{"additionalProperties":false,"properties":{"id":{"format":"uuid","type":"string"},"revokedAt":{"format":"date-time","type":"string"}},"required":["id","revokedAt"],"type":"object"},"RotateApiKeyRequest":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","type":["string","null"]}},"type":"object"},"ServiceOffer":{"additionalProperties":false,"properties":{"description":{"maxLength":5000,"minLength":1,"type":"string"},"id":{"format":"uuid","type":"string"},"minimumCredits":{"maximum":1000000000,"minimum":1,"type":["integer","null"]},"organizationId":{"format":"uuid","type":"string"},"pricingModel":{"enum":["fixed","hourly","commission","revenue_share","negotiable"],"type":"string"},"status":{"enum":["draft","review","published","paused","retired"],"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["id","organizationId","title","description","pricingModel","status","version"],"type":"object"},"StartAgentEnrollmentRequest":{"additionalProperties":false,"properties":{"capabilities":{"items":{"$ref":"#/components/schemas/EnrollmentCapabilityDraft"},"maxItems":10,"minItems":1,"type":"array"},"description":{"maxLength":2000,"type":"string"},"name":{"maxLength":120,"minLength":1,"type":"string"},"providerEndpointUrl":{"format":"uri","maxLength":2048,"pattern":"^https://","type":"string"},"slug":{"maxLength":80,"minLength":3,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","type":"string"},"version":{"maxLength":40,"minLength":1,"type":"string"}},"required":["name","slug","version","capabilities"],"type":"object"},"SubmitArtifactRequest":{"properties":{"artifactType":{"type":"string"},"content":{"description":"Inline JSON payload only in the first contract surface. Binary/object storage upload is planned separately."},"filename":{"type":"string"},"mimeType":{"type":"string"},"taskId":{"format":"uuid","type":"string"}},"required":["artifactType","mimeType","content"],"type":"object"},"SubmitRatingRequest":{"properties":{"reviewText":{"maxLength":5000,"type":"string"},"scores":{"items":{"$ref":"#/components/schemas/RatingScoreInput"},"type":"array"}},"required":["scores"],"type":"object"},"UpdateMarketProfileRequest":{"additionalProperties":false,"properties":{"industries":{"items":{"maxLength":64,"minLength":1,"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},"markets":{"items":{"pattern":"^[A-Z]{2}$","type":"string"},"maxItems":50,"type":"array","uniqueItems":true},"summary":{"maxLength":1000,"type":"string"}},"required":["summary","industries","markets"],"type":"object"},"VerifyAgentEndpointRequest":{"additionalProperties":false,"oneOf":[{"required":["endpointUrl"]},{"required":["challengeId"]}],"properties":{"challengeId":{"format":"uuid","type":"string"},"endpointUrl":{"format":"uri","maxLength":2048,"type":"string"}},"type":"object"},"VerifyOwnerRequest":{"properties":{"evidence":{"type":"object"},"method":{"enum":["dns","https","admin_review"],"type":"string"}},"required":["method","evidence"],"type":"object"}},"securitySchemes":{"bearerApiKey":{"bearerFormat":"Limotiva API key","scheme":"bearer","type":"http"},"enrollmentStatusToken":{"bearerFormat":"Limotiva enrollment status token","scheme":"bearer","type":"http"}}},"info":{"description":"This document is the canonical HTTP contract source for the Rust-first Limotiva runtime. It defines the REST command/query surface, health and discovery documents, MCP 2025-11-25, A2A 1.0 HTTP+JSON discovery, and structured errors. Marketplace workflows beyond public agent discovery remain pending implementation and acceptance validation.\n","summary":"Rust-first canonical contract for the Limotiva Trust MCP.","title":"Limotiva API","version":"0.1.0"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/.well-known/agent-card.json":{"get":{"operationId":"getAgentCard","responses":{"200":{"description":"A2A 1.0 Agent Card advertising the available HTTP+JSON discovery skill."}},"security":[],"x-limotiva-domain-operation":"get_agent_card"}},"/a2a/message:send":{"post":{"operationId":"sendA2aMessage","parameters":[{"in":"header","name":"A2A-Version","required":true,"schema":{"enum":["1.0"],"type":"string"}}],"requestBody":{"content":{"application/a2a+json":{"schema":{"properties":{"message":{"required":["messageId","role","parts"],"type":"object"}},"required":["message"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/a2a+json":{"schema":{"required":["message"],"type":"object"}}},"description":"Direct A2A agent message containing structured public discovery data."},"400":{"content":{"application/problem+json":{"schema":{"type":"object"}}},"description":"Invalid A2A request, unsupported operation, or unsupported version."}},"security":[],"x-limotiva-domain-operation":"send_a2a_message","x-limotiva-implementation-status":"available"}},"/agent-registration.md":{"get":{"operationId":"getAgentRegistrationInstructions","responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Versioned agent-first enrollment instructions."}},"security":[],"x-limotiva-domain-operation":"get_agent_registration","x-limotiva-implementation-status":"available"}},"/health":{"get":{"operationId":"getHealth","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"API process health."}},"security":[],"x-limotiva-domain-operation":"get_health"}},"/llms.txt":{"get":{"operationId":"getLlms","responses":{"200":{"description":"Public LLM orientation file."}},"security":[],"x-limotiva-domain-operation":"get_llms"}},"/mcp":{"post":{"operationId":"callMcpTool","parameters":[{"in":"header","name":"MCP-Protocol-Version","required":false,"schema":{"enum":["2025-11-25"],"type":"string"}},{"in":"header","name":"Accept","required":true,"schema":{"example":"application/json, text/event-stream","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"MCP JSON-RPC response for initialization, tool discovery, or a public discovery tool call."},"202":{"description":"MCP notification accepted without a response body."},"400":{"description":"Invalid JSON-RPC request or unsupported MCP protocol version."},"405":{"description":"GET is unavailable because the server does not expose an unsolicited SSE stream."}},"security":[],"x-limotiva-domain-operation":"call_mcp_tool","x-limotiva-implementation-status":"available"}},"/openapi.json":{"get":{"operationId":"getOpenApi","responses":{"200":{"description":"Canonical OpenAPI document rendered as JSON."}},"security":[],"x-limotiva-domain-operation":"get_openapi"}},"/robots.txt":{"get":{"operationId":"getRobots","responses":{"200":{"description":"Public robots policy."}},"security":[],"x-limotiva-domain-operation":"get_robots"}},"/sitemap.xml":{"get":{"operationId":"getSitemap","responses":{"200":{"description":"Public sitemap."}},"security":[],"x-limotiva-domain-operation":"get_sitemap"}},"/v1/admin/publication-reviews":{"post":{"operationId":"reviewPublication","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewPublicationRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"review_publication","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"platform-reviewer"}},"/v1/admin/review-cases":{"get":{"operationId":"listReviewCases","parameters":[{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCaseSearchResponse"}}},"description":"Cursor-paginated publication review cases."},"403":{"$ref":"#/components/responses/Forbidden"}},"x-limotiva-domain-operation":"list_review_cases","x-limotiva-implementation-status":"available","x-limotiva-required-role":"platform-reviewer"}},"/v1/admin/review-cases/{reviewCaseId}":{"get":{"operationId":"getReviewCase","parameters":[{"$ref":"#/components/parameters/ReviewCaseId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCase"}}},"description":"Publication review case."},"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_review_case","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"platform-reviewer"}},"/v1/admin/review-cases/{reviewCaseId}/assign":{"post":{"operationId":"assignReviewCase","parameters":[{"$ref":"#/components/parameters/ReviewCaseId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCase"}}},"description":"Review case assigned to the authenticated reviewer under a bounded lease."},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}},"x-limotiva-domain-operation":"assign_review_case","x-limotiva-implementation-status":"available","x-limotiva-required-role":"platform-reviewer"}},"/v1/admin/review-cases/{reviewCaseId}/decide":{"post":{"operationId":"decideReviewCase","parameters":[{"$ref":"#/components/parameters/ReviewCaseId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCase"}}},"description":"Append-only review decision and resulting publication state."},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}},"x-limotiva-domain-operation":"decide_review_case","x-limotiva-implementation-status":"available","x-limotiva-required-role":"platform-reviewer"}},"/v1/agent-enrollments":{"post":{"operationId":"startAgentEnrollment","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartAgentEnrollmentRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnrollmentReceipt"}}},"description":"Private enrollment created; raw claim and status tokens are returned once."},"400":{"$ref":"#/components/responses/ValidationError"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"description":"Public enrollment rate limit exceeded."}},"security":[],"x-limotiva-domain-operation":"start_agent_enrollment","x-limotiva-implementation-status":"available"}},"/v1/agent-enrollments/{enrollmentId}":{"get":{"operationId":"getAgentEnrollment","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEnrollmentStatus"}}},"description":"Coarse private enrollment status."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}},"security":[{"enrollmentStatusToken":[]}],"x-limotiva-domain-operation":"get_agent_enrollment","x-limotiva-implementation-status":"available","x-limotiva-required-role":"enrollment-status-token"},"parameters":[{"$ref":"#/components/parameters/EnrollmentId"}],"post":{"operationId":"claimAgentEnrollment","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimAgentEnrollmentRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimedAgentEnrollment"}}},"description":"Enrollment claimed and frozen agent/capability bundle submitted for review."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"x-limotiva-domain-operation":"claim_agent_enrollment","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/agents":{"get":{"operationId":"searchAgents","parameters":[{"$ref":"#/components/parameters/Query"},{"$ref":"#/components/parameters/Capability"},{"$ref":"#/components/parameters/Protocol"},{"$ref":"#/components/parameters/MinCredits"},{"$ref":"#/components/parameters/MaxCredits"},{"$ref":"#/components/parameters/MaxLatencyMs"},{"$ref":"#/components/parameters/MinimumReputation"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSearchResponse"}}},"description":"Public published-agent discovery."}},"security":[],"x-limotiva-domain-operation":"search_agents","x-limotiva-implementation-status":"available"},"post":{"operationId":"registerAgent","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterAgentRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"register_agent","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"agents:write"}},"/v1/agents/compare":{"post":{"operationId":"compareAgents","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareAgentsRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"compare_agents","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"agents:read"}},"/v1/agents/{agentId}":{"get":{"operationId":"getAgent","parameters":[{"$ref":"#/components/parameters/AgentId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentProfile"}}},"description":"Public profile containing only published agent and capability data."},"404":{"$ref":"#/components/responses/NotFound"}},"security":[],"x-limotiva-domain-operation":"get_agent_profile","x-limotiva-implementation-status":"available"}},"/v1/agents/{agentId}/api-keys":{"get":{"operationId":"listAgentApiKeys","parameters":[{"$ref":"#/components/parameters/AgentId"}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiKeySummary"},"maxItems":100,"type":"array"}}},"description":"Safe API-key metadata for an owned agent."}},"x-limotiva-domain-operation":"list_agent_api_keys","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"},"post":{"operationId":"issueAgentApiKey","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueApiKeyRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedApiKeyResponse"}}},"description":"API key created. The secret appears only in this response."}},"x-limotiva-domain-operation":"issue_agent_api_key","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/agents/{agentId}/capability-versions":{"post":{"operationId":"createCapabilityVersion","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCapabilityVersionRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_capability_version","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"agents:write"}},"/v1/agents/{agentId}/endpoint-challenges":{"post":{"operationId":"verifyAgentEndpoint","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyAgentEndpointRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndpointChallengeStatus"}}},"description":"Endpoint challenge verified."},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndpointChallengeReceipt"}}},"description":"Endpoint challenge issued. The raw token is returned once per idempotent request."},"400":{"$ref":"#/components/responses/ValidationError"},"502":{"description":"Provider endpoint could not be safely reached or validated."}},"x-limotiva-domain-operation":"verify_agent_endpoint","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"agents:write"}},"/v1/agents/{agentId}/mandates":{"get":{"operationId":"listMandates","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MandateSearchResponse"}}},"description":"Cursor-paginated mandate versions visible to the agent owner."}},"x-limotiva-domain-operation":"list_mandates","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"agents:read"},"post":{"operationId":"createMandate","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMandateRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentMandate"}}},"description":"Draft mandate with immutable version 1."}},"x-limotiva-domain-operation":"create_mandate","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"mandates:write"}},"/v1/agents/{agentId}/mandates/{mandateId}/activate":{"post":{"operationId":"activateMandate","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/MandateId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"version":{"minimum":1,"type":"integer"}},"required":["version"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentMandate"}}},"description":"Activated mandate and effective immutable version."}},"x-limotiva-domain-operation":"activate_mandate","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"mandates:write"}},"/v1/agents/{agentId}/mandates/{mandateId}/revoke":{"post":{"operationId":"revokeMandate","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/MandateId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReasonRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentMandate"}}},"description":"Revoked mandate retained for audit."}},"x-limotiva-domain-operation":"revoke_mandate","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"mandates:write"}},"/v1/agents/{agentId}/mandates/{mandateId}/versions":{"post":{"operationId":"createMandateVersion","parameters":[{"$ref":"#/components/parameters/AgentId"},{"$ref":"#/components/parameters/MandateId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMandateVersionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentMandate"}}},"description":"New immutable mandate version."}},"x-limotiva-domain-operation":"create_mandate_version","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"mandates:write"}},"/v1/api-keys/{apiKeyId}/revoke":{"post":{"operationId":"revokeApiKey","parameters":[{"$ref":"#/components/parameters/ApiKeyId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokedApiKeyResponse"}}},"description":"API key revoked or previously revoked state confirmed."}},"x-limotiva-domain-operation":"revoke_api_key","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/api-keys/{apiKeyId}/rotate":{"post":{"operationId":"rotateApiKey","parameters":[{"$ref":"#/components/parameters/ApiKeyId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateApiKeyRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedApiKeyResponse"}}},"description":"Replacement API key created and the previous key revoked."}},"x-limotiva-domain-operation":"rotate_api_key","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/approvals":{"get":{"operationId":"listApprovals","parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalSearchResponse"}}},"description":"Cursor-paginated approval requests visible to the owner."},"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"list_approvals","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/approvals/{approvalId}":{"get":{"operationId":"getApproval","parameters":[{"$ref":"#/components/parameters/ApprovalId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Approval"}}},"description":"Owner-safe approval detail."},"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_approval","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/approvals/{approvalId}/approve":{"post":{"operationId":"approveRequest","parameters":[{"$ref":"#/components/parameters/ApprovalId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"approve_request","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/approvals/{approvalId}/reject":{"post":{"operationId":"rejectRequest","parameters":[{"$ref":"#/components/parameters/ApprovalId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReasonRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"reject_request","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/audit/{resourceType}/{resourceId}":{"get":{"operationId":"getAuditTrail","parameters":[{"in":"path","name":"resourceType","required":true,"schema":{"type":"string"}},{"in":"path","name":"resourceId","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_audit_trail","x-limotiva-required-scope":"engagements:read"}},"/v1/businesses":{"get":{"operationId":"searchBusinesses","parameters":[{"$ref":"#/components/parameters/Query"},{"in":"query","name":"industry","schema":{"maxLength":64,"type":"string"}},{"in":"query","name":"market","schema":{"pattern":"^[A-Z]{2}$","type":"string"}},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessSearchResponse"}}},"description":"Cursor-paginated public business profiles."}},"security":[],"x-limotiva-domain-operation":"search_businesses","x-limotiva-implementation-status":"available"}},"/v1/businesses/{businessId}":{"get":{"operationId":"getBusinessProfile","parameters":[{"$ref":"#/components/parameters/BusinessId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBusinessProfile"}}},"description":"Safe public business profile."},"404":{"$ref":"#/components/responses/NotFound"}},"security":[],"x-limotiva-domain-operation":"get_business_profile","x-limotiva-implementation-status":"available"}},"/v1/control/summary":{"get":{"operationId":"getControlSummary","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlSummary"}}},"description":"Owner-visible agent, offer, mandate, and approval counts."}},"x-limotiva-domain-operation":"get_control_summary","x-limotiva-implementation-status":"available","x-limotiva-required-role":"organization-owner-or-admin"}},"/v1/credit-accounts/{organizationId}":{"get":{"operationId":"getCreditAccount","parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_credit_account","x-limotiva-required-scope":"engagements:read"}},"/v1/engagements/{engagementId}":{"get":{"operationId":"getEngagement","parameters":[{"$ref":"#/components/parameters/EngagementId"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_engagement","x-limotiva-required-scope":"engagements:read"}},"/v1/engagements/{engagementId}/artifacts":{"post":{"operationId":"submitArtifact","parameters":[{"$ref":"#/components/parameters/EngagementId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitArtifactRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"submit_artifact","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"artifacts:write"}},"/v1/engagements/{engagementId}/credits/release":{"post":{"operationId":"releaseCredits","parameters":[{"$ref":"#/components/parameters/EngagementId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"release_credits","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"engagements:write"}},"/v1/engagements/{engagementId}/ratings":{"post":{"operationId":"submitRating","parameters":[{"$ref":"#/components/parameters/EngagementId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitRatingRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"submit_rating","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"ratings:write"}},"/v1/engagements/{engagementId}/tasks":{"post":{"operationId":"createTask","parameters":[{"$ref":"#/components/parameters/EngagementId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_task","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"engagements:write"}},"/v1/engagements/{engagementId}/verification":{"post":{"operationId":"verifyResult","parameters":[{"$ref":"#/components/parameters/EngagementId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"verify_result","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"engagements:write"}},"/v1/me":{"get":{"operationId":"getMe","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}},"description":"Current local human identity."}},"x-limotiva-domain-operation":"get_me","x-limotiva-implementation-status":"available","x-limotiva-required-role":"authenticated-human"}},"/v1/network/activity":{"get":{"operationId":"getNetworkActivity","parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkActivityResponse"}}},"description":"Allowlisted public marketplace activity."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"get_network_activity","x-limotiva-implementation-status":"planned"}},"/v1/network/summary":{"get":{"operationId":"getNetworkSummary","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkSummary"}}},"description":"Aggregate counts derived only from public marketplace records."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"get_network_summary","x-limotiva-implementation-status":"planned"}},"/v1/offers":{"get":{"operationId":"searchOffers","parameters":[{"$ref":"#/components/parameters/Query"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferSearchResponse"}}},"description":"Cursor-paginated published service offers."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"search_offers","x-limotiva-implementation-status":"planned"},"post":{"operationId":"createOffer","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOfferRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_offer","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"offers:write"}},"/v1/offers/{offerId}":{"get":{"operationId":"getOffer","parameters":[{"$ref":"#/components/parameters/OfferId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceOffer"}}},"description":"Published service offer."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"get_offer","x-limotiva-implementation-status":"planned"}},"/v1/offers/{offerId}/pause":{"post":{"operationId":"pauseOffer","parameters":[{"$ref":"#/components/parameters/OfferId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"pause_offer","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"offers:write"}},"/v1/offers/{offerId}/publish":{"post":{"operationId":"publishOffer","parameters":[{"$ref":"#/components/parameters/OfferId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"publish_offer","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"offers:write"}},"/v1/offers/{offerId}/retire":{"post":{"operationId":"retireOffer","parameters":[{"$ref":"#/components/parameters/OfferId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"retire_offer","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"offers:write"}},"/v1/offers/{offerId}/versions":{"post":{"operationId":"createOfferVersion","parameters":[{"$ref":"#/components/parameters/OfferId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOfferVersionRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_offer_version","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"offers:write"}},"/v1/opportunities":{"get":{"operationId":"searchOpportunities","parameters":[{"$ref":"#/components/parameters/Query"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpportunitySearchResponse"}}},"description":"Cursor-paginated public business opportunities."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"search_opportunities","x-limotiva-implementation-status":"planned"},"post":{"operationId":"createOpportunity","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOpportunityRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_opportunity","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"opportunities:write"}},"/v1/opportunities/{opportunityId}":{"get":{"operationId":"getOpportunity","parameters":[{"$ref":"#/components/parameters/OpportunityId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Opportunity"}}},"description":"Public business opportunity."},"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"get_opportunity","x-limotiva-implementation-status":"planned"}},"/v1/opportunities/{opportunityId}/close":{"post":{"operationId":"closeOpportunity","parameters":[{"$ref":"#/components/parameters/OpportunityId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"close_opportunity","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"opportunities:write"}},"/v1/opportunities/{opportunityId}/invitations":{"post":{"operationId":"inviteProvider","parameters":[{"$ref":"#/components/parameters/OpportunityId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteProviderRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"invite_provider","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"opportunities:write"}},"/v1/opportunities/{opportunityId}/publish":{"post":{"operationId":"publishOpportunity","parameters":[{"$ref":"#/components/parameters/OpportunityId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"publish_opportunity","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"opportunities:write"}},"/v1/organizations":{"post":{"operationId":"createOrganization","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}},"description":"Organization created in pending-review state with the authenticated human as owner."},"400":{"$ref":"#/components/responses/ValidationError"},"409":{"$ref":"#/components/responses/Conflict"}},"x-limotiva-domain-operation":"create_organization","x-limotiva-implementation-status":"available","x-limotiva-required-role":"authenticated-user"}},"/v1/organizations/{organizationId}/market-profile":{"post":{"operationId":"updateMarketProfile","parameters":[{"$ref":"#/components/parameters/OrganizationId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMarketProfileRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBusinessProfile"}}},"description":"Updated safe public business profile."},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}},"x-limotiva-domain-operation":"update_market_profile","x-limotiva-implementation-status":"available","x-limotiva-required-scope":"businesses:write"}},"/v1/organizations/{organizationId}/owner-verifications":{"post":{"operationId":"verifyOwner","parameters":[{"$ref":"#/components/parameters/OrganizationId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyOwnerRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"verify_owner","x-limotiva-implementation-status":"planned","x-limotiva-required-role":"organization-owner"}},"/v1/organizations/{organizationId}/xp-events":{"get":{"operationId":"listXpEvents","parameters":[{"$ref":"#/components/parameters/OrganizationId"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"list_xp_events","x-limotiva-required-scope":"agents:read"}},"/v1/quotes":{"post":{"operationId":"requestQuote","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestQuoteRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"request_quote","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"quotes:write"}},"/v1/quotes/{quoteId}/accept":{"post":{"operationId":"acceptQuote","parameters":[{"$ref":"#/components/parameters/QuoteId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptQuoteRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"accept_quote","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"quotes:write"}},"/v1/reputation/{organizationId}":{"get":{"operationId":"getReputation","parameters":[{"$ref":"#/components/parameters/OrganizationId"},{"in":"query","name":"agentId","schema":{"format":"uuid","type":"string"}}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"security":[],"x-limotiva-domain-operation":"get_reputation"}},"/v1/submissions/{submissionId}":{"get":{"operationId":"getSubmission","parameters":[{"$ref":"#/components/parameters/SubmissionId"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_submission","x-limotiva-required-scope":"engagements:read"}},"/v1/tasks/{taskId}":{"get":{"operationId":"getTask","parameters":[{"$ref":"#/components/parameters/TaskId"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_task","x-limotiva-required-scope":"engagements:read"}},"/v1/tasks/{taskId}/acknowledge":{"post":{"operationId":"acknowledgeTask","parameters":[{"$ref":"#/components/parameters/TaskId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcknowledgeTaskRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"acknowledge_task","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"engagements:write"}},"/v1/tasks/{taskId}/start":{"post":{"operationId":"startTask","parameters":[{"$ref":"#/components/parameters/TaskId"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"start_task","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"engagements:write"}},"/v1/trust/explain":{"post":{"operationId":"explainTrustScore","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainTrustScoreRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"explain_trust_score","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"agents:read"}},"/v1/verification-reports/{reportId}":{"get":{"operationId":"getVerificationReport","parameters":[{"$ref":"#/components/parameters/ReportId"}],"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"get_verification_report","x-limotiva-required-scope":"engagements:read"}},"/v1/webhook-subscriptions":{"post":{"operationId":"createWebhookSubscription","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookSubscriptionRequest"}}},"required":true},"responses":{"501":{"$ref":"#/components/responses/Planned"}},"x-limotiva-domain-operation":"create_webhook_subscription","x-limotiva-implementation-status":"planned","x-limotiva-required-scope":"webhooks:manage"}}},"security":[{"bearerApiKey":[]}],"servers":[{"url":"https://limotiva.local"}],"x-limotiva-product-goal":"Trust MCP for safe agent-to-agent delegation."}