{"openapi":"3.1.0","info":{"title":"Agent Resources API","version":"1.0.0","description":"The universal management, certification, and intelligence layer for AI agents. Scanning, KYA certification, Skill Library, memory, fleet management, and x402 autonomous agent payments.","contact":{"name":"Agent Resources","url":"https://agentresources.xyz","email":"support@agentresources.xyz"},"license":{"name":"Proprietary","url":"https://agentresources.xyz/legal/terms"},"x-logo":{"url":"https://agentresources.xyz/logo.png"}},"servers":[{"url":"https://api.agentresources.xyz/api/v1","description":"Production"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Agents","description":"Agent CRUD and management"},{"name":"Scanning","description":"8-layer security and behavioral scanning"},{"name":"KYA","description":"Know Your Agent certification"},{"name":"Memory","description":"Persistent semantic memory (pgvector)"},{"name":"Skills","description":"Skill Library browsing and installation"},{"name":"Metrics","description":"Performance metrics ingestion"},{"name":"LLM","description":"LLM router with tier-based model access"},{"name":"x402","description":"Autonomous agent payments (USDC on Base)"},{"name":"Dashboard","description":"Workspace dashboard data"},{"name":"Fleet","description":"Fleet management and monitoring"},{"name":"Billing","description":"Subscription and billing management"},{"name":"Reports","description":"Report generation"},{"name":"Discovery","description":"Service discovery endpoints"},{"name":"Telemetry","description":"SDK telemetry ingestion and status"},{"name":"Policy","description":"Agent policy declaration and skill registration"},{"name":"Transfer","description":"Agent ownership transfer and wallet verification"},{"name":"Notifications","description":"Alert channels and notification management"},{"name":"Privacy","description":"GDPR data export and account deletion"},{"name":"Referrals","description":"Referral program and commissions"},{"name":"Marketplace","description":"Marketplace referral token issuance"},{"name":"Trust","description":"Public trust profiles and attestation verification"},{"name":"Retraining","description":"Agent retraining directives and dispute resolution"},{"name":"Admin","description":"Administrative operations (requires admin role)"},{"name":"Snapshots","description":"Agent configuration snapshots and rollback"},{"name":"API Keys","description":"API key management"},{"name":"Workspaces","description":"Workspace management and settings"}],"paths":{"/agents":{"get":{"tags":["Agents"],"summary":"List agents","description":"Returns all agents in the current workspace.","operationId":"listAgents","responses":{"200":{"description":"Array of agents","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Agent"}}}}}}},"post":{"tags":["Agents"],"summary":"Create agent","description":"Register a new agent in the workspace.","operationId":"createAgent","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentInput"}}}},"responses":{"201":{"description":"Created agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}}}}},"/agents/{id}":{"get":{"tags":["Agents"],"summary":"Get agent","description":"Returns a single agent by ID.","operationId":"getAgent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Agent details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}}}},"patch":{"tags":["Agents"],"summary":"Update agent","description":"Update agent properties.","operationId":"updateAgent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentInput"}}}},"responses":{"200":{"description":"Updated agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete agent","description":"Remove an agent from the workspace.","operationId":"deleteAgent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"}}}},"/kya/agents/{id}":{"get":{"tags":["KYA"],"summary":"Get KYA status","description":"Returns the current KYA certification status for an agent.","operationId":"getKYA","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"KYA badge status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KYABadge"}}}}}}},"/kya/agents/{id}/assess":{"post":{"tags":["KYA"],"summary":"Start KYA assessment","description":"Begin a Know Your Agent certification assessment. Tiers: Basic, Verified, Trusted.","operationId":"startKYA","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Assessment result"}}}},"/kya/agents/{id}/attest":{"post":{"tags":["KYA"],"summary":"Submit KYA attestation","description":"Submit on-chain attestation for an agent's KYA tier.","operationId":"submitAttestation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"networks":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Attestation submissions"}}}},"/kya/agents/{id}/history":{"get":{"tags":["KYA"],"summary":"KYA history","description":"Returns attestation and scan history for an agent.","operationId":"getKYAHistory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"History entries"}}}},"/kya/workspace":{"get":{"tags":["KYA"],"summary":"Workspace KYA summary","description":"Returns KYA summary across all agents in the workspace.","operationId":"getWorkspaceKYA","responses":{"200":{"description":"Workspace KYA data"}}}},"/networks/attestation-capabilities":{"get":{"tags":["KYA"],"summary":"Get attestation network capabilities","description":"Returns supported attestation networks and whether each network is currently configured for submission and fee estimation.","operationId":"getAttestationNetworkCapabilities","responses":{"200":{"description":"Network capability set"}}}},"/networks/fee-estimates":{"get":{"tags":["KYA"],"summary":"Get attestation network fee estimates","description":"Returns estimated submission fees for one or more requested attestation networks.","operationId":"getAttestationFeeEstimates","parameters":[{"name":"networks","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated network list (base,cdp,billions,eigencloud,erc8004)"}],"responses":{"200":{"description":"Fee estimate result"}}}},"/memory/write":{"post":{"tags":["Memory"],"summary":"Write memory","description":"Store a memory entry with automatic vector embedding.","operationId":"writeMemory","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id","content"],"properties":{"agent_id":{"type":"string","format":"uuid"},"content":{"type":"string"},"metadata":{"type":"object"}}}}}},"responses":{"201":{"description":"Memory stored"}}}},"/memory/search":{"post":{"tags":["Memory"],"summary":"Search memory","description":"Semantic similarity search across agent memory using pgvector.","operationId":"searchMemory","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"agent_id":{"type":"string","format":"uuid"},"limit":{"type":"integer","default":10}}}}}},"responses":{"200":{"description":"Memory search results"}}}},"/library/skills":{"get":{"tags":["Skills"],"summary":"Browse skills","description":"Browse the Skill Library. Supports search, category filter, and pagination.","operationId":"listSkills","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Array of skills"}}}},"/library/skills/{id}/install":{"post":{"tags":["Skills"],"summary":"Install skill","description":"Install a skill from the Skill Library to an agent.","operationId":"installSkill","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id"],"properties":{"agent_id":{"type":"string","format":"uuid"}}}}}},"responses":{"200":{"description":"Skill installed"}}}},"/ingest":{"post":{"tags":["Metrics"],"summary":"Ingest metrics","description":"Submit agent performance metrics — task success/failure, latency, token usage, cost.","operationId":"ingestMetrics","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id","event"],"properties":{"agent_id":{"type":"string","format":"uuid"},"event":{"type":"string","description":"Event type (e.g., task_complete, task_fail)"},"success":{"type":"boolean"},"latency_ms":{"type":"number"},"tokens_used":{"type":"integer"},"cost_usd":{"type":"number"},"metadata":{"type":"object"}}}}}},"responses":{"202":{"description":"Metrics accepted"}}}},"/llm/chat":{"post":{"tags":["LLM"],"summary":"Execute LLM request","description":"Route an LLM request through the 3-tier model router.","operationId":"executeLLM","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["messages"],"properties":{"messages":{"type":"array","items":{"type":"object"}},"tier":{"type":"string","enum":["fast","balanced","premium"],"default":"fast"}}}}}},"responses":{"200":{"description":"LLM response"}}}},"/llm/models":{"get":{"tags":["LLM"],"summary":"List models","description":"Returns available LLM models and their tier requirements.","operationId":"listModels","responses":{"200":{"description":"Array of models"}}}},"/llm/providers":{"get":{"tags":["LLM"],"summary":"List providers","description":"Returns configured LLM providers.","operationId":"listProviders","responses":{"200":{"description":"Array of providers"}}}},"/sdk/heartbeat":{"post":{"tags":["Telemetry"],"summary":"SDK heartbeat","description":"Report SDK heartbeat with version, uptime, and integrity hash.","operationId":"sdkHeartbeat","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id"],"properties":{"agent_id":{"type":"string","format":"uuid"},"sdk_version":{"type":"string"},"uptime_ms":{"type":"integer"},"version_hash":{"type":"string"}}}}}},"responses":{"202":{"description":"Heartbeat accepted"}}}},"/sdk/telemetry/task":{"post":{"tags":["Telemetry"],"summary":"Report task event","description":"Submit a task execution telemetry event.","operationId":"reportTaskEvent","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_id","task_type"],"properties":{"agent_id":{"type":"string","format":"uuid"},"task_type":{"type":"string"},"success":{"type":"boolean"},"duration_ms":{"type":"integer"},"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"}}}}}},"responses":{"202":{"description":"Event accepted"}}}},"/sdk/telemetry/network":{"post":{"tags":["Telemetry"],"summary":"Report network event","description":"Submit a network access telemetry event.","operationId":"reportNetworkEvent","responses":{"202":{"description":"Event accepted"}}}},"/sdk/telemetry/permission":{"post":{"tags":["Telemetry"],"summary":"Report permission event","description":"Submit a permission usage telemetry event.","operationId":"reportPermissionEvent","responses":{"202":{"description":"Event accepted"}}}},"/sdk/telemetry/data-access":{"post":{"tags":["Telemetry"],"summary":"Report data access event","description":"Submit a data access (PII, sensitive data) telemetry event.","operationId":"reportDataAccessEvent","responses":{"202":{"description":"Event accepted"}}}},"/sdk/telemetry/dependency":{"post":{"tags":["Telemetry"],"summary":"Report dependency","description":"Submit a dependency report for supply chain tracking.","operationId":"reportDependency","responses":{"202":{"description":"Report accepted"}}}},"/sdk/telemetry/environment":{"post":{"tags":["Telemetry"],"summary":"Report environment","description":"Submit an environment report (runtime, OS, Node version).","operationId":"reportEnvironment","responses":{"202":{"description":"Report accepted"}}}},"/sdk/telemetry/output-sample":{"post":{"tags":["Telemetry"],"summary":"Report output sample","description":"Submit an output quality sample for behavioral analysis.","operationId":"reportOutputSample","responses":{"202":{"description":"Sample accepted"}}}},"/sdk/challenge/response":{"post":{"tags":["Telemetry"],"summary":"Respond to SDK challenge","description":"Submit response to an SDK integrity challenge.","operationId":"respondToChallenge","responses":{"200":{"description":"Challenge response verified"}}}},"/sdk/status":{"get":{"tags":["Telemetry"],"summary":"Get SDK status","description":"Returns the current SDK registration and telemetry status for an agent.","operationId":"getSdkStatus","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"SDK status"}}}},"/agents/{id}/policy":{"get":{"tags":["Policy"],"summary":"Get agent policy","description":"Returns the current declared policy for an agent.","operationId":"getPolicy","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Agent policy"}}}},"/agents/{id}/skills":{"post":{"tags":["Policy"],"summary":"Register agent skill","description":"Register a skill declaration for an agent (v2 skill system).","operationId":"registerSkill","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Skill registered"}}},"get":{"tags":["Policy"],"summary":"List agent skills","description":"Returns all declared skills for an agent.","operationId":"listAgentSkills","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Array of agent skills"}}}},"/agents/{id}/telemetry-status":{"get":{"tags":["Policy"],"summary":"Get telemetry status","description":"Returns aggregated telemetry status and event counts for an agent.","operationId":"getTelemetryStatus","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Telemetry status summary"}}}},"/notifications/channels":{"get":{"tags":["Notifications"],"summary":"List alert channels","description":"Returns all configured notification channels for the workspace.","operationId":"listChannels","responses":{"200":{"description":"Array of channels"}}},"post":{"tags":["Notifications"],"summary":"Create alert channel","description":"Configure a new notification channel (Slack, Telegram, webhook, or email).","operationId":"createChannel","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["channelType","config","alertTypes"],"properties":{"channelType":{"type":"string","enum":["slack","telegram","webhook","email"]},"label":{"type":"string"},"config":{"type":"object"},"alertTypes":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Channel created"}}}},"/notifications/channels/{id}":{"patch":{"tags":["Notifications"],"summary":"Update alert channel","description":"Update an existing notification channel.","operationId":"updateChannel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Channel updated"}}},"delete":{"tags":["Notifications"],"summary":"Delete alert channel","description":"Remove a notification channel.","operationId":"deleteChannel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"}}}},"/notifications/test":{"post":{"tags":["Notifications"],"summary":"Test notification","description":"Send a test notification to verify channel configuration.","operationId":"testNotification","responses":{"200":{"description":"Test sent"}}}},"/alerts/logs":{"get":{"tags":["Notifications"],"summary":"Get alert logs","description":"Returns recent alert log entries for the workspace.","operationId":"getAlertLogs","responses":{"200":{"description":"Alert log entries"}}}},"/trust/agents/{id}":{"get":{"tags":["Trust"],"summary":"Get trust profile","description":"Returns the public trust profile for an agent. No authentication required.","operationId":"getTrustProfile","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Trust profile"}}}},"/trust/agents/{id}/history":{"get":{"tags":["Trust"],"summary":"Get trust history","description":"Returns trust score history for an agent. No authentication required.","operationId":"getTrustHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Trust score history"}}}},"/trust/agents/{id}/attestations":{"get":{"tags":["Trust"],"summary":"Get attestations","description":"Returns on-chain attestation records for an agent. No authentication required.","operationId":"getAttestations","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Attestation records"}}}},"/trust/agents/{id}/attestations/{attestationId}":{"get":{"tags":["Trust"],"summary":"Get attestation detail","description":"Returns full detail of a specific attestation. No authentication required.","operationId":"getAttestationDetail","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"attestationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Attestation detail"}}}},"/trust/agents/{id}/verify":{"get":{"tags":["Trust"],"summary":"Public verification","description":"Publicly verify any agent's trust status. No authentication required.","operationId":"verifyTrust","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Verification result"}}}},"/retraining/agents/{id}/suggestions":{"get":{"tags":["Retraining"],"summary":"Get retraining suggestions","description":"Returns retraining suggestions based on the latest scan.","operationId":"getRetrainingSuggestions","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Retraining suggestions"}}}},"/retraining/agents/{id}/execute":{"post":{"tags":["Retraining"],"summary":"Execute retraining","description":"Execute a retraining suggestion on an agent.","operationId":"executeRetraining","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Retraining executed"}}}},"/retraining/agents/{id}/pipeline":{"post":{"tags":["Retraining"],"summary":"Full retraining pipeline","description":"Chains scan → derive suggestions → auto-apply → re-scan. Returns before/after scores.","operationId":"runRetrainingPipeline","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Pipeline result"}}}},"/agents/{id}/violations":{"get":{"tags":["Retraining"],"summary":"List violations","description":"Returns derived violations from the latest scan for an agent.","operationId":"listViolations","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Array of violations"}}}},"/agents/{id}/retraining-directives":{"get":{"tags":["Retraining"],"summary":"List retraining directives","description":"Returns active retraining directives for an agent.","operationId":"listRetrainingDirectives","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Array of directives"}}}},"/agents/{id}/disputes":{"get":{"tags":["Retraining"],"summary":"List disputes","description":"Returns all disputes filed by the agent owner.","operationId":"listDisputes","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Array of disputes"}}}},"/agents/{id}/disputes/{disputeId}":{"get":{"tags":["Retraining"],"summary":"Get dispute detail","description":"Returns a single dispute by ID.","operationId":"getDispute","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"disputeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Dispute detail"}}}},"/agents/{id}/violations/{violationId}/dispute":{"post":{"tags":["Retraining"],"summary":"File dispute","description":"File a dispute against a specific violation.","operationId":"fileDispute","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"violationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Dispute filed"}}}},"/agents/{id}/retraining-directives/{directiveId}/acknowledge":{"post":{"tags":["Retraining"],"summary":"Acknowledge directive","description":"Acknowledge a retraining directive.","operationId":"acknowledgeDirective","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"directiveId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Directive acknowledged"}}}},"/retraining/agents/{id}/history":{"get":{"tags":["Retraining"],"summary":"Retraining history","description":"Returns past retraining executions for an agent.","operationId":"getRetrainingHistory","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Retraining history"}}}},"/agents/{id}/skills/{skillKey}":{"delete":{"tags":["Policy"],"summary":"Remove agent skill","description":"Unregister a skill from an agent.","operationId":"removeAgentSkill","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"skillKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Skill removed"}}}},"/agents/{id}/activity":{"get":{"tags":["Agents"],"summary":"Get agent activity","description":"Returns recent activity log for an agent.","operationId":"getAgentActivity","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Activity entries"}}}},"/agents/{id}/metrics":{"get":{"tags":["Agents"],"summary":"Get agent metrics","description":"Returns performance metrics for an agent.","operationId":"getAgentMetrics","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Agent metrics"}}}},"/agents/{id}/export":{"post":{"tags":["Agents"],"summary":"Export agent data","description":"Export all data for a specific agent (GDPR-compliant).","operationId":"exportAgent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Export data"}}}},"/agents/{id}/snapshots":{"get":{"tags":["Agents"],"summary":"List snapshots","description":"Returns configuration snapshots for an agent.","operationId":"listSnapshots","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Array of snapshots"}}},"post":{"tags":["Agents"],"summary":"Create snapshot","description":"Create a configuration snapshot for an agent.","operationId":"createSnapshot","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Snapshot created"}}}},"/billing/status":{"get":{"tags":["Billing"],"summary":"Get billing status","description":"Returns current subscription status and plan details.","operationId":"getBillingStatus","responses":{"200":{"description":"Billing status"}}}},"/billing/portal":{"post":{"tags":["Billing"],"summary":"Create billing portal session","description":"Create a Stripe billing portal session for managing subscriptions.","operationId":"createPortal","responses":{"200":{"description":"Portal URL"}}}},"/admin/overview":{"get":{"tags":["Admin"],"summary":"Admin overview","description":"Returns platform-wide statistics (tenants, agents, scans, revenue).","operationId":"getAdminOverview","responses":{"200":{"description":"Platform overview"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key from workspace settings"},"x402Auth":{"type":"apiKey","in":"header","name":"X-402-Payment","description":"x402 USDC payment header (wallet signature + payment proof)"}},"schemas":{"Agent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string"},"framework":{"type":"string"},"status":{"type":"string","enum":["active","inactive","quarantined"]},"trust_score":{"type":"number","minimum":0,"maximum":100},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CreateAgentInput":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"type":{"type":"string"},"framework":{"type":"string"},"description":{"type":"string"},"config":{"type":"object"}}},"UpdateAgentInput":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"config":{"type":"object"}}},"Scan":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"agent_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","running","completed","failed"]},"scan_type":{"type":"string","enum":["basic","full"]},"trust_score":{"type":"number","minimum":0,"maximum":100},"layers":{"type":"object","description":"Per-layer scores and findings"},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"}}},"KYABadge":{"type":"object","properties":{"agent_id":{"type":"string","format":"uuid"},"level":{"type":"string","enum":["basic","verified","trusted"]},"score":{"type":"number"},"valid_until":{"type":"string","format":"date-time"},"attestation_tx":{"type":"string","description":"On-chain attestation transaction hash"}}}}},"externalDocs":{"description":"Agent Resources Documentation","url":"https://agentresources.xyz/docs"}}