> ## Documentation Index
> Fetch the complete documentation index at: https://actelos.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh a registry

> Re-fetches the registry's well-known document to confirm it is reachable and still advertises a supported capability, then stamps lastSyncedAt. The stored id is never changed, even if the registry now advertises a different one.



## OpenAPI

````yaml /openapi.json post /registries/{id}/refresh
openapi: 3.0.0
info:
  title: Cyrnel API
  description: >-
    Cyrnel is a universal layer that connects AI agents and LLM applications to
    any external service, API, or device regardless of protocol or standard. It
    acts as an adaptive bridge between your AI and the outside world, enabling
    seamless integrations through code execution, async operation handling, and
    built-in observability and security controls.
  version: 1.0.0
servers:
  - url: http://localhost:9371
security: []
paths:
  /registries/{id}/refresh:
    post:
      tags:
        - Registries
      summary: Refresh a registry
      description: >-
        Re-fetches the registry's well-known document to confirm it is reachable
        and still advertises a supported capability, then stamps lastSyncedAt.
        The stored id is never changed, even if the registry now advertises a
        different one.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Registry slug identifying the registry.
          required: true
          description: Registry slug identifying the registry.
          name: id
          in: path
      responses:
        '200':
          description: The updated registry record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Registry'
        '400':
          description: The id path parameter was invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: A bearer token was required but missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '404':
          description: The registry could not be found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '429':
          description: >-
            Rate limit exceeded. The request was throttled. Check Retry-After
            header.
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Maximum requests allowed in the current window.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            X-RateLimit-Reset:
              schema:
                type: integer
              description: Unix timestamp when the window resets.
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
        '500':
          description: The registry could not be refreshed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '502':
          description: >-
            The registry could not be reached, responded with a non-2xx status,
            or no longer advertises a supported capability.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    Registry:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Registry slug matching /^[A-Za-z0-9_-]+$/ used as the primary key.
        baseUrl:
          type: string
          description: Normalized absolute http(s) URL of the registry.
        lastSyncedAt:
          type: string
          nullable: true
          description: >-
            ISO-8601 timestamp of the last successful sync with the registry, or
            null when it has never been synced.
        createdAt:
          type: string
          description: ISO-8601 timestamp of when the registry was registered.
        updatedAt:
          type: string
          description: ISO-8601 timestamp of the last mutation to the record.
        authType:
          type: string
          nullable: true
          enum:
            - apiKey
            - oauth2
            - null
          description: >-
            Authentication method configured for this registry, or null when
            none is set.
        tokenExpiresAt:
          type: number
          nullable: true
          description: >-
            Epoch-ms timestamp when the cached OAuth2 access token expires, or
            null for api key auth or when no token has been fetched.
      required:
        - id
        - baseUrl
        - lastSyncedAt
        - createdAt
        - updatedAt
        - authType
        - tokenExpiresAt
      description: Record of a registered registry.
    ApiErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message returned by the API.
        code:
          type: string
          description: >-
            Stable machine-readable error code (e.g. invalid_cursor,
            cursor_expired).
      required:
        - error
      description: Standard error envelope returned by the HTTP error middleware.
    RateLimitErrorResponse:
      type: object
      properties:
        error:
          type: string
          enum:
            - rate_limit_exceeded
          description: Error code identifying rate-limit rejection.
        message:
          type: string
          description: Human-readable message with retry instructions.
        retryAfter:
          type: integer
          minimum: 0
          exclusiveMinimum: true
          description: Number of seconds to wait before retrying.
      required:
        - error
        - message
        - retryAfter
      description: Error body returned when a request is rate-limited (HTTP 429).

````