description:The application service doesn't have a URL configured. The errcode is `M_URL_NOT_SET`.
schema:
$ref:"definitions/errors/error.yaml"
examples:
application/json:{
"errcode": "M_URL_NOT_SET",
"error": "Application service doesn't have a URL configured"
}
403:
description:The access token used to authenticate the request doesn't belong to an appservice, or belongs to a different appservice than the one in the path. The errcode is `M_FORBIDDEN`.
schema:
$ref:"definitions/errors/error.yaml"
examples:
application/json:{
"errcode": "M_FORBIDDEN",
"error": "Provided access token is not the appservice's as_token"
}
502:
description:|-
The application service returned a bad status, or the connection failed.
The errcode is `M_BAD_STATUS` or `M_CONNECTION_FAILED`.
For bad statuses, the response may include `status` and `body`
fields containing the HTTP status code and response body text
respectively to aid with debugging.
schema:
type:object
title:Error
description:A Matrix-level Error
properties:
errcode:
type:string
description:An error code.
enum:[M_BAD_STATUS, M_CONNECTION_FAILED]
error:
type:string
description:A human-readable error message.
example:Ping returned status 401
status:
type:integer
description:The HTTP status code returned by the appservice.
example:401
body:
type:string
description:The HTTP response body returned by the appservice.
example:"{\"errcode\": \"M_UNKNOWN_TOKEN\"}"
required:["errcode"]
examples:
application/json:{
"errcode": "M_BAD_STATUS",
"error": "Ping returned status 401",
"status": 401,
"body": "{\"errcode\": \"M_UNKNOWN_TOKEN\"}"
}
504:
description:The connection to the application service timed out. The errcode is `M_CONNECTION_TIMEOUT`.
schema:
$ref:"definitions/errors/error.yaml"
examples:
application/json:{
"errcode": "M_CONNECTION_TIMEOUT",
"error": "Connection to application service timed out"