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-8isk2

EVENT-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-8isk2

EVENT-8isk2

) in order to serve a specific user-facing error message (i.e. something like "Invalid TOTP code")

ZITADEL•7d ago•

6 replies

Isaac

API Error Codes

🏬Self-hosted❓Question❌Unsolved

EVENT-8isk2

EVENT-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-8isk2

EVENT-8isk2

) in order to serve a specific user-facing error message (i.e. something like "Invalid TOTP code")

API Error Codes

Similar Threads

API Error Codes

Similar Threads

Similar Threads

Similar Threads