Email-domain-usernames-mailboxName-secrets:GET
From Hostway API Documentation
GET /email/{domain}/usernames/{mailboxName}/secrets
Retrieves a list of text keys for all mailbox(alias) secret questions.
Contents |
Request
GET /email/{domain}/usernames/{mailboxName}/secrets
Request Parameters
- domain - string
- The specific domain for which the call will retrieve the list
- maiboxName - string
- The name of the mailbox
Request Headers
- Content-Type
- Required. Set this header to
application/json; charset=UTF-8
Response
Status Code
- 200 OK
- Success
- 404 Not Found
- The domain name or mailbox does not exist.
Response Body
{ "list": [ "{tk}", "{tk}", "{tk}" ], "links": [ { "href": "https://api.hostway.com/email/{domain}/usernames/{mailboxName}/secrets", "rel": "self" } ] }
Parameters
- list - 'list'
- A list of secret questions of the account
- tk - string (Unique)
- Unique secret question text key.
- links - 'list'
- Hypermedia to the account secret questions resource
Examples
Success scenario
Request
GET /email/test.com/usernames/test-mailbox/secrets
Response
{ "list": [ "tk1", "tk2", "tk3" ], "links": [ { "href": "https://api.hostway.com/email/test.com/usernames/test-mailbox/secrets", "rel": "self" } ] }
See also