reguscilabs-com Agent tools API

openapi: 3.2.0
info:
  title: RegusciLabs Innovation Lab agent Agent tools API
  version: 1.5.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: []
tags:
- name: Agent tools
paths:
  /api/v1/agent/read_information:
    post:
      operationId: read_information
      tags:
      - Agent tools
      summary: Read published RegusciLabs information about the innovation lab, AI, hardware…
      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, latest-news and curated-social-activity lists may return nextCursor (null at the end); reuse it with unchanged filters. Social activity is editorial, not live, with null dates when unverified. Validation 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.
              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.
              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:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
externalDocs:
  description: RegusciLabs developer documentation and sandbox
  url: https://www.reguscilabs.com/developers