@ -149,26 +149,26 @@ paths:
application/json : {
application/json : {
"submit_url": "https://example.org/path/to/submitToken"
"submit_url": "https://example.org/path/to/submitToken"
}
}
schema:
schema:
type : object
type : object
properties:
properties:
submit_url:
submit_url:
type : string
type : string
format : uri
format : uri
description : |-
description : |-
An optional field containing a URL where the client must
An optional field containing a URL where the client must
submit the validation token to, with identical parameters
submit the validation token to, with identical parameters
to the Identity Service API's `POST
to the Identity Service API's `POST
/validate/email/submitToken` endpoint (without the requirement
/validate/email/submitToken` endpoint (without the requirement
for an access token). The homeserver must send this token to the
for an access token). The homeserver must send this token to the
user (if applicable), who should then be prompted to provide it
user (if applicable), who should then be prompted to provide it
to the client.
to the client.
If this field is not present, the client can assume that
If this field is not present, the client can assume that
verification will happen without the client's involvement
verification will happen without the client's involvement
provided the homeserver advertises this specification version
provided the homeserver advertises this specification version
in the `/versions` response (ie : r0.5.0).
in the `/versions` response (ie : r0.5.0).
example : "https://example.org/path/to/submitToken"
example : "https://example.org/path/to/submitToken"
403 :
403 :
description : The credentials could not be verified with the identity server.
description : The credentials could not be verified with the identity server.
examples:
examples:
@ -223,8 +223,8 @@ paths:
description : The addition was successful.
description : The addition was successful.
examples:
examples:
application/json : {}
application/json : {}
schema:
schema:
type : object
type : object
401 :
401 :
description : |-
description : |-
The homeserver requires additional authentication information.
The homeserver requires additional authentication information.
@ -282,8 +282,8 @@ paths:
description : The addition was successful.
description : The addition was successful.
examples:
examples:
application/json : {}
application/json : {}
schema:
schema:
type : object
type : object
429 :
429 :
description : This request was rate-limited.
description : This request was rate-limited.
schema:
schema: