API Error Codes

🏬Self-hosted❓Question❌Unsolved

Heya, I want to know if there is a handy reference for Zitadel's "API error codes" (I'm unsure if I'm using the right terminolgy).
And also if its reasonable for me to rely on these codes being consistent in future updates.

For my case, I was looking the code EVENT-8isk2EVENT-8isk2, which is returned when an incorrect TOTP code is provided when calling /zitadel.session.v2.SessionService/CreateSession/zitadel.session.v2.SessionService/CreateSession

Here's the JSON error from where I saw that code

{
    "code": "invalid_argument",
    "message": "Invalid code (EVENT-8isk2)",
    "details": [
        {
            "type": "zitadel.v1.ErrorDetail",
            "value": "CgtFVkVOVC04aXNrMhIMSW52YWxpZCBjb2Rl",
            "debug": {
                "id": "EVENT-8isk2",
                "message": "Invalid code"
            }
        }
    ]
}

{
    "code": "invalid_argument",
    "message": "Invalid code (EVENT-8isk2)",
    "details": [
        {
            "type": "zitadel.v1.ErrorDetail",
            "value": "CgtFVkVOVC04aXNrMhIMSW52YWxpZCBjb2Rl",
            "debug": {
                "id": "EVENT-8isk2",
                "message": "Invalid code"
            }
        }
    ]
}

I also saw that error code referenced in github

For more context, I intend to detect this specific error (EVENT-8isk2EVENT-8isk2) in order to serve a specific user-facing error message (i.e. something like "Invalid TOTP code")

GitHub

zitadel/internal/domain/human_otp.go at de1cab9976843163b221516b24c...

ZITADEL - Identity infrastructure, simplified for you. - zitadel/zitadel

API Error Codes

🏬Self-hosted❓Question❌Unsolved

{
    "code": "invalid_argument",
    "message": "Invalid code (EVENT-8isk2)",
    "details": [
        {
            "type": "zitadel.v1.ErrorDetail",
            "value": "CgtFVkVOVC04aXNrMhIMSW52YWxpZCBjb2Rl",
            "debug": {
                "id": "EVENT-8isk2",
                "message": "Invalid code"
            }
        }
    ]
}

{
    "code": "invalid_argument",
    "message": "Invalid code (EVENT-8isk2)",
    "details": [
        {
            "type": "zitadel.v1.ErrorDetail",
            "value": "CgtFVkVOVC04aXNrMhIMSW52YWxpZCBjb2Rl",
            "debug": {
                "id": "EVENT-8isk2",
                "message": "Invalid code"
            }
        }
    ]
}

GitHub

zitadel/internal/domain/human_otp.go at de1cab9976843163b221516b24c...

ZITADEL - Identity infrastructure, simplified for you. - zitadel/zitadel

API Error Codes

API Error Codes

Continue the conversation

ZITADEL

Continue the conversation

ZITADEL

Similar Threads