Unable to find JSON Schema ID /schemas/{id}

[oliverpool]

Where do I find the Schema ID to request its schema?

When I request http://localhost:4433/schemas/loginFlow

• URI according to https://www.ory.sh/kratos/docs/reference/api#getschema
• {id} according to https://www.ory.sh/kratos/docs/reference/api#loginflow

I get a 404:

{
  "error": {
    "code": 404,
    "status": "Not Found",
    "debug": "rid=\nerror=The request was malformed or contained invalid parameters\nreason=Unable to find JSON Schema ID: loginFlow\ndetails=map[]\ndebug=\n\ngithub.com/ory/kratos/schema.Schemas.GetByID\n\t/home/ory/schema/schema.go:38\ngithub.com/ory/kratos/schema.(*Handler).get\n\t/home/ory/schema/handler.go:76\ngithub.com/ory/kratos/x.NoCacheHandler.func1\n\t/home/ory/x/nocache.go:18\ngithub.com/julienschmidt/httprouter.(*Router).ServeHTTP\n\t/go/pkg/mod/github.com/julienschmidt/[email protected]/router.go:387\ngithub.com/ory/nosurf.(*CSRFHandler).handleSuccess\n\t/go/pkg/mod/github.com/ory/[email protected]/handler.go:199\ngithub.com/ory/nosurf.(*CSRFHandler).ServeHTTP\n\t/go/pkg/mod/github.com/ory/[email protected]/handler.go:156\ngithub.com/urfave/negroni.Wrap.func1\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:46\ngithub.com/urfave/negroni.HandlerFunc.ServeHTTP\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:29\ngithub.com/urfave/negroni.middleware.ServeHTTP\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:38\ngithub.com/ory/kratos/x.glob..func1\n\t/home/ory/x/clean_url.go:12\ngithub.com/urfave/negroni.HandlerFunc.ServeHTTP\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:29\ngithub.com/urfave/negroni.middleware.ServeHTTP\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:38\ngithub.com/urfave/negroni.(*Negroni).ServeHTTP\n\t/go/pkg/mod/github.com/urfave/[email protected]/negroni.go:96\ngithub.com/gorilla/context.ClearHandler.func1\n\t/go/pkg/mod/github.com/gorilla/[email protected]/context.go:141\nnet/http.HandlerFunc.ServeHTTP\n\t/usr/local/go/src/net/http/server.go:2069\nnet/http.serverHandler.ServeHTTP\n\t/usr/local/go/src/net/http/server.go:2887\nnet/http.(*conn).serve\n\t/usr/local/go/src/net/http/server.go:1952\nruntime.goexit\n\t/usr/local/go/src/runtime/asm_amd64.s:1371",
    "message": "The requested resource could not be found"
  }
}

What should I use for the schema ID? Or am I misunderstanding something?

Thank you!

kratos version
Version:			v0.6.3-alpha.1
Build Commit:	5edf9524d812795ac5712e4a9541b34359234724
Build Timestamp:	2021-05-17T17:55:23Z

[oliverpool]

I think I found the issue. Requesting http://localhost:4433/schemas/default works.

The schema endpoint returns the stored identities according to the config (identity.default_schema_url in my case).

Maybe the doc could be updated to better explain this 😄

[aeneasr]

Glad you figured it out :) Maybe you habe some pointers which doc pages could be improved? Or even create a PR? :)

[jertel]

Somewhat relates to this discussion: #1373

[TB-Development]

Kratos thinks of identity data model whenever we say identity.

So for the API, you could use default as specified in the identity data model under schema_id. For instance, creating an identity

POST 0.0.0.0:4434/identities

Body

{
  "schema_id": "default",
  "state": "active",
  "traits": {
    "email":"[email protected]"
  }
}

Returns

{
    "id": "06ff0c94-9756-435e-b29f-12db9cbc3b3d",
    "schema_id": "default",
    "schema_url": "http://127.0.0.1:4433/schemas/default",
    "state": "active",
    "state_changed_at": "2022-01-05T18:48:42.5961654Z",
    "traits": {
        "email": "[email protected]"
    },
    "verifiable_addresses": [
        {
            "id": "5d5fdbd6-7ece-45dd-ad4e-83ca2c94e666",
            "value": "[email protected]",
            "verified": false,
            "via": "email",
            "status": "pending",
            "created_at": "2022-01-05T18:48:42.781061Z",
            "updated_at": "2022-01-05T18:48:42.781061Z"
        }
    ],
    "recovery_addresses": [
        {
            "id": "54c2c2e3-66d7-463f-ae04-d8a288702ea8",
            "value": "[email protected]",
            "via": "email",
            "created_at": "2022-01-05T18:48:42.890593Z",
            "updated_at": "2022-01-05T18:48:42.890593Z"
        }
    ],
    "created_at": "2022-01-05T18:48:42.652125Z",
    "updated_at": "2022-01-05T18:48:42.652125Z"
}

Precisely you can see this in the return:

    "schema_id": "default",
    "schema_url": "http://127.0.0.1:4433/schemas/default",

Which is the url oliver mentioned. It is the default schema that Kratos is accessing.