{"openapi":"3.1.0","info":{"title":"RegusciLabs Innovation Lab agent API","version":"1.3.0","x-versioning-policy":{"url":"https://www.reguscilabs.com/developers/versioning.md","minimumNoticeDays":90,"deprecationScheduled":false},"description":"Public information and consented inquiries/subscriptions. URL major version: /api/v1. Additive fields remain compatible within v1; breaking changes require a new major route. No deprecation is scheduled. Any future retirement will be documented at /developers/versioning.md with Deprecation and Sunset response headers at least 90 days before removal."},"servers":[{"url":"https://www.reguscilabs.com"}],"security":[],"externalDocs":{"description":"RegusciLabs developer documentation and sandbox","url":"https://www.reguscilabs.com/developers"},"paths":{"/api/v1/agent/read_information":{"post":{"operationId":"read_information","tags":["Agent tools"],"summary":"Read published RegusciLabs information about the innovation lab, AI, hardware, POCs, discovery, cases, Newsroom or policies. No login needed.","description":"Version 1. Anonymous access. See /developers for consent, limits and the versioning policy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"default":"/index.md","description":"Public content path from llms.txt or sitemap.xml, such as /en/index.md. No private paths or external URLs.","type":"string","maxLength":300}},"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string"}},"required":["ok","title","url","markdown"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}},"get":{"operationId":"get_read_information","tags":["Agent tools"],"summary":"Read published RegusciLabs information about the innovation lab, AI, hardware, POCs, discovery, cases, Newsroom or policies. No login needed.","description":"Read-only GET equivalent of POST. Query parameters use the same validation and shared quota. Search returns nextCursor; pass it as cursor with the same query and locale for the next page.","responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string"}},"required":["ok","title","url","markdown"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}},"parameters":[{"name":"path","in":"query","required":false,"schema":{"default":"/index.md","description":"Public content path from llms.txt or sitemap.xml, such as /en/index.md. No private paths or external URLs.","type":"string","maxLength":300}}]}},"/api/agent/read_information":{"post":{"operationId":"legacy_read_information","tags":["Agent tools"],"summary":"Read published RegusciLabs information about the innovation lab, AI, hardware, POCs, discovery, cases, Newsroom or policies. No login needed.","description":"Compatibility alias for the v1 endpoint; no removal is scheduled.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"default":"/index.md","description":"Public content path from llms.txt or sitemap.xml, such as /en/index.md. No private paths or external URLs.","type":"string","maxLength":300}},"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"markdown":{"type":"string"}},"required":["ok","title","url","markdown"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/v1/agent/search_information":{"post":{"operationId":"search_information","tags":["Agent tools"],"summary":"Search public RegusciLabs content in Spanish or English. Returns source links and excerpts, not generated claims.","description":"Version 1. Anonymous access. See /developers for consent, limits and the versioning policy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"locale":{"default":"es","type":"string","enum":["es","en"]},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10},"cursor":{"description":"Use nextCursor from the previous response with the same query and locale.","type":"string","pattern":"^\\d{1,7}$"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"}},"required":["title","url","excerpt"]}},"nextCursor":{"type":["string","null"]}},"required":["ok","results","nextCursor"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}},"get":{"operationId":"get_search_information","tags":["Agent tools"],"summary":"Search public RegusciLabs content in Spanish or English. Returns source links and excerpts, not generated claims.","description":"Read-only GET equivalent of POST. Query parameters use the same validation and shared quota. Search returns nextCursor; pass it as cursor with the same query and locale for the next page.","responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"}},"required":["title","url","excerpt"]}},"nextCursor":{"type":["string","null"]}},"required":["ok","results","nextCursor"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}},"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"locale","in":"query","required":false,"schema":{"default":"es","type":"string","enum":["es","en"]}},{"name":"limit","in":"query","required":false,"schema":{"default":5,"type":"integer","minimum":1,"maximum":10}},{"name":"cursor","in":"query","required":false,"schema":{"description":"Use nextCursor from the previous response with the same query and locale.","type":"string","pattern":"^\\d{1,7}$"}}]}},"/api/agent/search_information":{"post":{"operationId":"legacy_search_information","tags":["Agent tools"],"summary":"Search public RegusciLabs content in Spanish or English. Returns source links and excerpts, not generated claims.","description":"Compatibility alias for the v1 endpoint; no removal is scheduled.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"locale":{"default":"es","type":"string","enum":["es","en"]},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10},"cursor":{"description":"Use nextCursor from the previous response with the same query and locale.","type":"string","pattern":"^\\d{1,7}$"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"excerpt":{"type":"string"}},"required":["title","url","excerpt"]}},"nextCursor":{"type":["string","null"]}},"required":["ok","results","nextCursor"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/v1/agent/submit_inquiry":{"post":{"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse one key with identical input for retries for 7 days. The JSON idempotencyKey argument is equivalent (MCP/WebMCP). If both are provided they must match. Legacy calls without a key are accepted but are not safe to automatically retry. Cached outcomes replay; changed input or a pending outcome returns 409.","schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"}}],"operationId":"submit_inquiry","tags":["Agent tools"],"summary":"Send a project idea to RegusciLabs to start discovery. Requires the person's explicit approval and contact details. Validate with dryRun:true first. Does not subscribe the person. Live submissions send a team notification and attempt CRM storage. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.","description":"Version 1. Anonymous access. See /developers for consent, limits and the versioning policy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"company":{"type":"string","minLength":1,"maxLength":160},"role":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","minLength":1,"maxLength":40},"challengeType":{"type":"string","minLength":1,"maxLength":120,"description":"The kind of idea: AI, software, hardware or an unusual experiment."},"stage":{"type":"string","minLength":1,"maxLength":120},"timeline":{"type":"string","minLength":1,"maxLength":120},"budget":{"type":"string","minLength":1,"maxLength":120,"description":"Budget status from the person, e.g. to be defined. Do not invent an amount."},"challenge":{"type":"string","minLength":1,"maxLength":2000,"description":"The idea, the problem and what the person wants to test."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","company","role","email","whatsapp","challengeType","stage","timeline","budget","challenge"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":false},"submitted":{"type":"boolean","const":true},"receivedByTeam":{"type":"boolean","const":true},"replayed":{"type":"boolean"},"stored":{"type":"boolean"},"message":{"type":"string"}},"required":["ok","dryRun","submitted","receivedByTeam","stored","message"]}]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/agent/submit_inquiry":{"post":{"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse one key with identical input for retries for 7 days. The JSON idempotencyKey argument is equivalent (MCP/WebMCP). If both are provided they must match. Legacy calls without a key are accepted but are not safe to automatically retry. Cached outcomes replay; changed input or a pending outcome returns 409.","schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"}}],"operationId":"legacy_submit_inquiry","tags":["Agent tools"],"summary":"Send a project idea to RegusciLabs to start discovery. Requires the person's explicit approval and contact details. Validate with dryRun:true first. Does not subscribe the person. Live submissions send a team notification and attempt CRM storage. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.","description":"Compatibility alias for the v1 endpoint; no removal is scheduled.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"company":{"type":"string","minLength":1,"maxLength":160},"role":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","minLength":1,"maxLength":40},"challengeType":{"type":"string","minLength":1,"maxLength":120,"description":"The kind of idea: AI, software, hardware or an unusual experiment."},"stage":{"type":"string","minLength":1,"maxLength":120},"timeline":{"type":"string","minLength":1,"maxLength":120},"budget":{"type":"string","minLength":1,"maxLength":120,"description":"Budget status from the person, e.g. to be defined. Do not invent an amount."},"challenge":{"type":"string","minLength":1,"maxLength":2000,"description":"The idea, the problem and what the person wants to test."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","company","role","email","whatsapp","challengeType","stage","timeline","budget","challenge"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":false},"submitted":{"type":"boolean","const":true},"receivedByTeam":{"type":"boolean","const":true},"replayed":{"type":"boolean"},"stored":{"type":"boolean"},"message":{"type":"string"}},"required":["ok","dryRun","submitted","receivedByTeam","stored","message"]}]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/sandbox/submit_inquiry":{"post":{"operationId":"sandbox_submit_inquiry","tags":["Sandbox"],"summary":"Validate submit_inquiry without delivery or storage","description":"The server forces dryRun:true and confirmed:false, regardless of input. No providers are called.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"company":{"type":"string","minLength":1,"maxLength":160},"role":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","minLength":1,"maxLength":40},"challengeType":{"type":"string","minLength":1,"maxLength":120,"description":"The kind of idea: AI, software, hardware or an unusual experiment."},"stage":{"type":"string","minLength":1,"maxLength":120},"timeline":{"type":"string","minLength":1,"maxLength":120},"budget":{"type":"string","minLength":1,"maxLength":120,"description":"Budget status from the person, e.g. to be defined. Do not invent an amount."},"challenge":{"type":"string","minLength":1,"maxLength":2000,"description":"The idea, the problem and what the person wants to test."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","company","role","email","whatsapp","challengeType","stage","timeline","budget","challenge"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/v1/agent/subscribe_pulse":{"post":{"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse one key with identical input for retries for 7 days. The JSON idempotencyKey argument is equivalent (MCP/WebMCP). If both are provided they must match. Legacy calls without a key are accepted but are not safe to automatically retry. Cached outcomes replay; changed input or a pending outcome returns 409.","schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"}}],"operationId":"subscribe_pulse","tags":["Agent tools"],"summary":"Subscribe a person to The Pulse by email with their explicit newsletter consent and chosen format, frequency and language. Validate with dryRun:true first. Live calls store a subscription, send a confirmation email and notify the team. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.","description":"Version 1. Anonymous access. See /developers for consent, limits and the versioning policy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","maxLength":40},"deliveryFormat":{"type":"string","enum":["audio","text","both"]},"cadence":{"type":"string","enum":["daily","weekly"]},"consent":{"type":"boolean","const":true,"description":"The person explicitly opted into The Pulse. An inquiry does not imply newsletter consent."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","email","deliveryFormat","cadence","consent"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":false},"submitted":{"type":"boolean","const":true},"subscribed":{"type":"boolean","const":true},"replayed":{"type":"boolean"},"confirmationEmailSent":{"type":"boolean"},"message":{"type":"string"}},"required":["ok","dryRun","submitted","subscribed","confirmationEmailSent","message"]}]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/agent/subscribe_pulse":{"post":{"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse one key with identical input for retries for 7 days. The JSON idempotencyKey argument is equivalent (MCP/WebMCP). If both are provided they must match. Legacy calls without a key are accepted but are not safe to automatically retry. Cached outcomes replay; changed input or a pending outcome returns 409.","schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"}}],"operationId":"legacy_subscribe_pulse","tags":["Agent tools"],"summary":"Subscribe a person to The Pulse by email with their explicit newsletter consent and chosen format, frequency and language. Validate with dryRun:true first. Live calls store a subscription, send a confirmation email and notify the team. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.","description":"Compatibility alias for the v1 endpoint; no removal is scheduled.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","maxLength":40},"deliveryFormat":{"type":"string","enum":["audio","text","both"]},"cadence":{"type":"string","enum":["daily","weekly"]},"consent":{"type":"boolean","const":true,"description":"The person explicitly opted into The Pulse. An inquiry does not imply newsletter consent."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","email","deliveryFormat","cadence","consent"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]},{"type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":false},"submitted":{"type":"boolean","const":true},"subscribed":{"type":"boolean","const":true},"replayed":{"type":"boolean"},"confirmationEmailSent":{"type":"boolean"},"message":{"type":"string"}},"required":["ok","dryRun","submitted","subscribed","confirmationEmailSent","message"]}]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}},"/api/sandbox/subscribe_pulse":{"post":{"operationId":"sandbox_subscribe_pulse","tags":["Sandbox"],"summary":"Validate subscribe_pulse without delivery or storage","description":"The server forces dryRun:true and confirmed:false, regardless of input. No providers are called.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"whatsapp":{"type":"string","maxLength":40},"deliveryFormat":{"type":"string","enum":["audio","text","both"]},"cadence":{"type":"string","enum":["daily","weekly"]},"consent":{"type":"boolean","const":true,"description":"The person explicitly opted into The Pulse. An inquiry does not imply newsletter consent."},"idempotencyKey":{"description":"Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.","type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"locale":{"default":"es","type":"string","enum":["es","en"]},"dryRun":{"default":true,"description":"Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.","type":"boolean"},"confirmed":{"default":false,"description":"Set true only after the person explicitly approves sending these details to RegusciLabs.","type":"boolean"}},"required":["name","email","deliveryFormat","cadence","consent"],"additionalProperties":false}}}},"responses":{"200":{"description":"Typed result. Search returns nextCursor (null at the end); reuse it with the same query and locale. A validation result always has submitted:false.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}},"Idempotency-Replayed":{"description":"true when a saved live result is returned. Only present for live actions.","schema":{"type":"string","enum":["true","false"]}},"API-Version":{"description":"Contract major version","schema":{"type":"string","const":"1"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"dryRun":{"type":"boolean","const":true},"submitted":{"type":"boolean","const":false},"message":{"type":"string"}},"required":["ok","dryRun","submitted","message"]}}}},"400":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"403":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"404":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"405":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"409":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"413":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"415":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"429":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"502":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}},"503":{"description":"Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.","headers":{"RateLimit-Limit":{"description":"Maximum requests in the reported window (120/minute for requests; 5/hour for new live actions).","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Remaining requests in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait after 429 or temporary unavailability; present only when applicable.","schema":{"type":"integer"}},"Deprecation":{"description":"Sent only once a deprecation is scheduled; at least 90 days' notice is provided.","schema":{"type":"string"}},"Sunset":{"description":"HTTP date of a scheduled retirement. Absent when no retirement is scheduled.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentError"}}}}}}}},"components":{"schemas":{"AgentError":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"resolution":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}},"submitted":{"type":"boolean","const":false},"retryable":{"type":"boolean","const":false},"index":{"type":"string"},"replayed":{"type":"boolean"},"retryAfterSeconds":{"type":"number"}},"required":["ok","error","code","message","resolution"]}}}}