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

# Check daemon health

> Answers as soon as the daemon is up and serving requests. It checks nothing else (not
the database, not CliqHub); use Diagnose this daemon for readiness. No credential is
needed, from any host.

No authentication: any caller that can reach the daemon may call this.



## OpenAPI

````yaml /openapi/daemon-by-tag/daemon-system.yaml get /v1/system/health
openapi: 3.1.0
info:
  title: cliqd API
  version: 1.9.48
  description: >-
    HTTP API of `cliqd`, the local Cliq daemon. Generated from the daemon source
    by `scripts/generate_daemon_openapi.mjs` — do not edit by hand. See the
    [overview](/daemon-api/overview).
servers:
  - url: http://127.0.0.1:4900
    description: Local daemon (default port; `CLIQ_DAEMON_PORT` changes it)
security: []
tags:
  - name: Daemon System
    description: >-
      Liveness of the daemon process, for load balancers, container probes and
      scripts that

      wait for cliqd to come up.
paths:
  /v1/system/health:
    get:
      tags:
        - Daemon System
      summary: Check daemon health
      description: >-
        Answers as soon as the daemon is up and serving requests. It checks
        nothing else (not

        the database, not CliqHub); use Diagnose this daemon for readiness. No
        credential is

        needed, from any host.


        No authentication: any caller that can reach the daemon may call this.
      operationId: daemon_get_system_health
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - data
                properties:
                  ok:
                    type: boolean
                    const: true
                  data:
                    $ref: '#/components/schemas/Health'
              example:
                ok: true
                data:
                  timestamp: 1759834200000
        '500':
          description: >-
            `INTERNAL_ERROR` — An unexpected daemon fault. The message names the
            request id; the cause is in the cliqd log.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorReply'
              examples:
                INTERNAL_ERROR:
                  summary: INTERNAL_ERROR
                  value:
                    ok: false
                    error:
                      code: INTERNAL_ERROR
                      message: >-
                        cliqd hit an unexpected error (request 7f3a…). Details
                        are in the cliqd log.
      security: []
components:
  schemas:
    Health:
      type: object
      required:
        - timestamp
      properties:
        timestamp:
          type: integer
          format: int64
          description: The daemon's clock (epoch milliseconds) when it answered.
          example: 1759834200000
    ErrorReply:
      type: object
      description: >-
        Every failure. Switch on `error.code` — it is stable; `message` is for
        people and may change.
      required:
        - ok
        - error
      properties:
        ok:
          type: boolean
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Stable error code. See [Errors](/daemon-api/errors).
              example: TEAM_NOT_FOUND
            message:
              type: string
              description: What went wrong and, where possible, what to do.
              example: Team 'acme/code-review' not found
            details:
              description: >-
                Structured detail when there is some: the list of schema issues
                for `PAYLOAD_INVALID`, the agent problems for
                `TEAM_AGENT_CONFIG_REQUIRED`, …

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.