Healthz

GET 
https://$CUSTOM-DOMAIN/auth/v1/healthz

The health endpoint allows an external system to probe if ZITADEL authentication API is alive

Responses

200

A successful response.

application/json

Schema

Schema

object

Example (from schema)

{}

application/grpc

Schema

Schema

object

Example (from schema)

{}

application/grpc-web+proto

Schema

Schema

object

Example (from schema)

{}

default

An unexpected error response.

application/json

Schema

Schema

code int32
message string

details

object[]

Array [

@type string

]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

application/grpc

Schema

Schema

code int32
message string

details

object[]

Array [

@type string

]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

application/grpc-web+proto

Schema

Schema

code int32
message string

details

object[]

Array [

@type string

]

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://$CUSTOM-DOMAIN/auth/v1/healthz' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Base URL

https://$CUSTOM-DOMAIN/auth/v1

Auth

Bearer Token

ResponseClear

Click the Send API Request button above and see the response here!