2023-06-15 19:20:09 +02:00
openapi : 3.1 .0
2020-06-07 20:46:17 +02:00
info :
description : >-
mailcow is complete e-mailing solution with advanced antispam, antivirus,
nice UI and API.
In order to use this API you have to create a API key and add your IP
address to the whitelist of allowed IPs this can be done by logging into the
Mailcow UI using your admin account, then go to Configuration > Access >
Edit administrator details > API. There you will find a collapsed API menu.
There are two types of API keys
- The read only key can only be used for all get endpoints
- The read write key can be used for all endpoints
title : mailcow API
2020-09-17 20:35:13 +02:00
version : "1.0.0"
2020-06-07 20:46:17 +02:00
servers :
- url : /
components :
securitySchemes :
ApiKeyAuth :
type : apiKey
in : header
name : X-API-Key
responses :
Unauthorized :
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
type :
type : string
example : error
msg :
type : string
example : authentication failed
required :
2020-09-17 20:35:13 +02:00
- type
- msg
2020-06-07 20:46:17 +02:00
security :
- ApiKeyAuth : [ ]
paths :
/api/v1/add/alias :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- add
- alias
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
address : alias@domain.tld
goto : destination@domain.tld
- null
msg :
- alias_added
- alias@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Aliases
description : >-
You may create your own mailbox alias using this action. It takes a JSON
object containing a domain informations.
Only one `goto*` option can be used, for ex. if you want learn as spam,
then send just `goto_spam = 1` in request body.
operationId : Create alias
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
address : alias@domain.tld
goto : destination@domain.tld
properties :
active :
description : is alias active or not
type : boolean
address :
description : 'alias address, for catchall use "@domain.tld"'
type : string
goto :
2020-09-17 20:35:13 +02:00
description : "destination address, comma separated"
2020-06-07 20:46:17 +02:00
type : string
goto_ham :
description : learn as ham
type : boolean
goto_null :
description : silently ignore
type : boolean
goto_spam :
description : learn as spam
type : boolean
2021-01-30 15:48:31 +01:00
sogo_visible :
description : toggle visibility as selectable sender in SOGo
type : boolean
2020-06-07 20:46:17 +02:00
type : object
summary : Create alias
2021-11-12 12:22:15 +01:00
/api/v1/add/time_limited_alias :
post :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- add
- time_limited_alias
- address : info@domain.tld
domain : domain.tld
- null
msg :
- mailbox_modified
- info@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Aliases
description : >-
You may create a time limited alias using this action. It takes a JSON
object containing a domain and mailbox informations.
Mailcow will generate a random alias.
operationId : Create time limited alias
requestBody :
content :
application/json :
schema :
example :
username : info@domain.tld
domain : domain.tld
properties :
username :
description : 'the mailbox an alias should be created for'
type : string
domain :
description : "the domain"
type : string
type : object
summary : Create time limited alias
2020-06-07 20:46:17 +02:00
/api/v1/add/app-passwd :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- app_passwd
- add
2020-09-17 20:35:13 +02:00
- active : "1"
2022-05-17 07:03:33 +02:00
username : info@domain.tld
app_name : wordpress
2020-06-07 20:46:17 +02:00
app_passwd : keyleudecticidechothistishownsan31
app_passwd2 : keyleudecticidechothistishownsan31
2022-05-17 07:03:33 +02:00
protocols :
- imap_access
- dav_access
- smtp_access
- eas_access
- pop3_access
- sieve_access
2020-06-07 20:46:17 +02:00
msg : app_passwd_added
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- App Passwords
description : >-
Using this endpoint you can create a new app password for a specific
mailbox.
operationId : Create App Password
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
username : info@domain.tld
app_name : wordpress
app_passwd : keyleudecticidechothistishownsan31
app_passwd2 : keyleudecticidechothistishownsan31
2022-05-17 07:03:33 +02:00
protocols :
- imap_access
- dav_access
- smtp_access
- eas_access
- pop3_access
- sieve_access
2020-06-07 20:46:17 +02:00
properties :
active :
description : is alias active or not
type : boolean
username :
description : mailbox for which the app password should be created
type : string
app_name :
description : name of your app password
type : string
app_passwd :
description : your app password
type : string
app_passwd2 :
2020-09-17 20:35:13 +02:00
description : your app password
type : string
2020-06-07 20:46:17 +02:00
type : object
summary : Create App Password
/api/v1/add/bcc :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- bcc
- add
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
bcc_dest : bcc@awesomecow.tld
local_dest : mailcow.tld
type : sender
- null
msg : bcc_saved
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Address Rewriting
description : >-
Using this endpoint you can create a BCC map to forward all mails via a
bcc for a given domain.
operationId : Create BCC Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
bcc_dest : bcc@awesomecow.tld
local_dest : mailcow.tld
type : sender
properties :
active :
description : 1 for a active user account 0 for a disabled user account
type : number
bcc_dest :
description : the email address where all mails should be send to
type : string
local_dest :
description : the domain which emails should be forwarded
type : string
type :
description : the type of bcc map can be `sender` or `recipient`
type : string
type : object
summary : Create BCC Map
/api/v1/add/dkim :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- dkim
- add
- dkim_selector : dkim
domains : hanspeterlol.de
2020-09-17 20:35:13 +02:00
key_size : "2048"
2020-06-07 20:46:17 +02:00
msg :
- dkim_added
- hanspeterlol.de
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- DKIM
description : Using this endpoint you can generate new DKIM keys.
operationId : Generate DKIM Key
requestBody :
content :
application/json :
schema :
example :
dkim_selector : dkim
domains : mailcow.tld
2020-09-17 20:35:13 +02:00
key_size : "2048"
2020-06-07 20:46:17 +02:00
properties :
dkim_selector :
description : the DKIM selector default dkim
type : string
2020-07-18 19:37:48 +02:00
domains :
description : a list of domains for which a dkim key should be generated
2020-06-07 20:46:17 +02:00
type : string
key_size :
description : the key size (1024 or 2048)
type : number
type : object
summary : Generate DKIM Key
/api/v1/add/dkim_duplicate :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- dkim
- duplicate
- from_domain : mailcow.tld
to_domain : awesomecow.tld
msg :
- dkim_duplicated
- mailcow.tld
- awesomecow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- DKIM
description : Using this endpoint you can duplicate the DKIM Key of one domain.
operationId : Duplicate DKIM Key
requestBody :
content :
application/json :
schema :
example :
from_domain : mailcow.tld
to_domain : awesomecow.tld
properties :
fron_domain :
description : the domain where the dkim key should be copied from
type : string
to_domain :
description : the domain where the dkim key should be copied to
type : string
type : object
summary : Duplicate DKIM Key
/api/v1/add/domain :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- ratelimit
- edit
- domain
- object : domain.tld
rl_frame : s
2020-09-17 20:35:13 +02:00
rl_value : "10"
2020-06-07 20:46:17 +02:00
msg :
- rl_saved
- domain.tld
type : success
- log :
- mailbox
- add
- domain
2020-09-17 20:35:13 +02:00
- active : "1"
aliases : "400"
2021-03-24 10:13:41 +01:00
restart_sogo : "1"
2020-09-17 20:35:13 +02:00
backupmx : "0"
defquota : "3072"
2020-06-07 20:46:17 +02:00
description : some decsription
domain : domain.tld
2020-09-17 20:35:13 +02:00
mailboxes : "10"
maxquota : "10240"
quota : "10240"
relay_all_recipients : "0"
2020-06-07 20:46:17 +02:00
rl_frame : s
2020-09-17 20:35:13 +02:00
rl_value : "10"
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-06-07 20:46:17 +02:00
- null
msg :
- domain_added
- domain.tld
type : success
schema :
2022-07-19 20:22:45 +02:00
type : array
items :
type : object
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domains
description : >-
You may create your own domain using this action. It takes a JSON object
containing a domain informations.
operationId : Create domain
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
aliases : "400"
backupmx : "0"
defquota : "3072"
2020-06-07 20:46:17 +02:00
description : some decsription
domain : domain.tld
2020-09-17 20:35:13 +02:00
mailboxes : "10"
maxquota : "10240"
quota : "10240"
relay_all_recipients : "0"
2020-06-07 20:46:17 +02:00
rl_frame : s
2020-09-17 20:35:13 +02:00
rl_value : "10"
2021-03-24 10:13:41 +01:00
restart_sogo : "10"
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-06-07 20:46:17 +02:00
properties :
active :
description : is domain active or not
type : boolean
aliases :
description : limit count of aliases associated with this domain
type : number
backupmx :
description : relay domain or not
type : boolean
defquota :
description : predefined mailbox quota in `add mailbox` form
type : number
description :
description : Description of domain
type : string
domain :
description : Fully qualified domain name
type : string
2022-07-19 20:22:45 +02:00
gal :
description : >-
is domain global address list active or not, it enables
shared contacts accross domain in SOGo webmail
type : boolean
2020-06-07 20:46:17 +02:00
mailboxes :
description : limit count of mailboxes associated with this domain
type : number
maxquota :
description : maximum quota per mailbox
type : number
quota :
description : maximum quota for this domain (for all mailboxes in sum)
type : number
2021-03-24 10:13:41 +01:00
restart_sogo :
description : restart SOGo to activate the domain in SOGo
type : number
2020-06-07 20:46:17 +02:00
relay_all_recipients :
description : >-
if not, them you have to create "dummy" mailbox for each
address to relay
type : boolean
2022-07-19 20:22:45 +02:00
relay_unknown_only :
description : Relay non-existing mailboxes only. Existing mailboxes will be delivered locally.
type : boolean
2020-06-07 20:46:17 +02:00
rl_frame :
enum :
- s
- m
- h
2020-12-22 20:45:49 +01:00
- d
2020-06-07 20:46:17 +02:00
type : string
rl_value :
description : rate limit value
type : number
2022-07-19 20:22:45 +02:00
tags :
description : tags for this Domain
type : array
items :
type : string
2020-06-07 20:46:17 +02:00
type : object
summary : Create domain
/api/v1/add/domain-admin :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- domain_admin
- add
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
domains : mailcow.tld
2020-09-17 20:35:13 +02:00
password : "*"
password2 : "*"
2020-06-07 20:46:17 +02:00
username : testadmin
msg :
- domain_admin_added
- testadmin
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domain admin
description : >-
Using this endpoint you can create a new Domain Admin user. This user
has full control over a domain, and can create new mailboxes and
aliases.
operationId : Create Domain Admin user
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
domains : mailcow.tld
password : supersecurepw
password2 : supersecurepw
username : testadmin
properties :
active :
description : 1 for a active user account 0 for a disabled user account
type : number
domains :
description : the domains the user should be a admin of
type : string
password :
description : domain admin user password
type : string
password2 :
description : domain admin user password
type : string
username :
description : the username for the admin user
type : string
type : object
summary : Create Domain Admin user
2023-01-06 19:25:23 +01:00
/api/v1/add/sso/domain-admin :
post :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
token : "591F6D-5C3DD2-7455CD-DAF1C1-AA4FCC"
description : OK
headers : { }
tags :
- Single Sign-On
description : >-
Using this endpoint you can issue a token for Domain Admin user. This token can be used for
autologin Domain Admin user by using query_string var sso_token={token}. Token expiration time is 30s
operationId : Issue Domain Admin SSO token
requestBody :
content :
application/json :
schema :
example :
username : testadmin
properties :
username :
description : the username for the admin user
type : object
type : object
summary : Issue Domain Admin SSO token
2020-10-11 08:38:16 +02:00
/api/v1/edit/da-acl :
post :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- type : success
log :
2021-11-12 12:22:15 +01:00
- acl
- edit
2020-10-11 08:38:16 +02:00
- testadmin
2021-11-12 12:22:15 +01:00
- username :
- testadmin
da_acl :
- syncjobs
- quarantine
- login_as
- sogo_access
- app_passwds
- bcc_maps
- pushover
- filters
- ratelimit
- spam_policy
- extend_sender_acl
- unlimited_quota
- protocol_access
- smtp_ip_access
- alias_domains
- domain_desc
2020-10-11 08:38:16 +02:00
msg :
2021-11-12 12:22:15 +01:00
- acl_saved
- testadmin
2020-10-11 08:38:16 +02:00
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domain admin
description : >-
Using this endpoint you can edit the ACLs of a Domain Admin user. This user
has full control over a domain, and can create new mailboxes and
aliases.
2020-10-11 09:24:14 +02:00
operationId : Edit Domain Admin ACL
2020-10-11 08:38:16 +02:00
requestBody :
content :
application/json :
schema :
example :
items :
2021-11-12 12:22:15 +01:00
- testadmin
2020-10-11 08:38:16 +02:00
attr :
da_acl :
2021-11-12 12:22:15 +01:00
- syncjobs
- quarantine
- login_as
- sogo_access
- app_passwds
- bcc_maps
- pushover
- filters
- ratelimit
- spam_policy
- extend_sender_acl
- unlimited_quota
- protocol_access
- smtp_ip_access
- alias_domains
- domain_desc
2020-10-11 08:38:16 +02:00
properties :
items :
description : contains the domain admin username you want to edit
type : object
attr :
properties :
da_acl :
description : contains the list of acl names that are active for this user
type : object
type : object
summary : Edit Domain Admin ACL
2020-10-11 09:24:14 +02:00
/api/v1/edit/domain-admin :
post :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- type : success
log :
- domain_admin
- edit
- username : testadmin
active : [ "0" , "1" ]
username_new : testadmin
domains : [ "domain.tld" ]
password : "*"
password2 : "*"
msg :
- domain_admin_modified
- testadmin
schema :
properties :
type :
enum :
- success
- danger
- error
type : string
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type : object
description : OK
headers : {}
tags :
- Domain admin
description : >-
Using this endpoint you can edit a existing Domain Admin user. This user
has full control over a domain, and can create new mailboxes and
aliases.
operationId : Edit Domain Admin user
requestBody :
content :
application/json :
schema :
example :
items :
2021-11-12 12:22:15 +01:00
- testadmin
2020-10-11 09:24:14 +02:00
attr :
active :
2021-11-12 12:22:15 +01:00
- '0'
- '1'
2020-10-11 09:24:14 +02:00
username_new : testadmin
domains : [ "domain.tld" ]
password : supersecurepassword
password2 : supersecurepassword
properties :
attr :
properties :
active :
description : is the domain admin active or not
2020-11-30 16:29:21 +01:00
type : boolean
2020-10-11 09:24:14 +02:00
username_new :
description : the username of the domain admin, change this to change the username
type : string
domains :
description : a list of all domains managed by this domain admin
type : array
2020-11-30 16:29:21 +01:00
items :
type : string
2020-10-11 09:24:14 +02:00
password :
description : the new domain admin user password
type : string
password2 :
description : the new domain admin user password for confirmation
type : string
type : object
items :
description : contains the domain admin username you want to edit
type : object
summary : Edit Domain Admin user
2020-06-07 20:46:17 +02:00
/api/v1/add/domain-policy :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- policy
- add
- domain
- domain : domain.tld
2020-09-17 20:35:13 +02:00
object_from : "*@baddomain.tld"
2020-06-07 20:46:17 +02:00
object_list : bl
msg :
- domain_modified
- domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domain antispam policies
description : >-
You may create your own domain policy using this action. It takes a JSON
object containing a domain informations.
operationId : Create domain policy
requestBody :
content :
application/json :
schema :
example :
domain : domain.tld
2020-09-17 20:35:13 +02:00
object_from : "*@baddomain.tld"
2020-06-07 20:46:17 +02:00
object_list : bl
properties :
domain :
description : domain name to which policy is associated to
type : string
object_from :
description : exact address or use wildcard to match whole domain
type : string
object_list :
enum :
- wl
- bl
type : string
type : object
summary : Create domain policy
/api/v1/add/fwdhost :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- fwdhost
- add
2020-09-17 20:35:13 +02:00
- filter_spam : "0"
2020-06-07 20:46:17 +02:00
hostname : hosted.mailcow.de
msg :
- forwarding_host_added
2020-09-17 20:35:13 +02:00
- "5.1.76.202, 2a00:f820:417::202"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Fordwarding Hosts
description : >-
Add a new Forwarding host to mailcow. You can chose to enable or disable
spam filtering of incoming emails by specifing `filter_spam` 0 =
inactive, 1 = active.
operationId : Add Forward Host
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
filter_spam : "0"
2020-06-07 20:46:17 +02:00
hostname : hosted.mailcow.de
properties :
filter_spam :
2020-09-17 20:35:13 +02:00
description : "1 to enable spam filter, 0 to disable spam filter"
2020-06-07 20:46:17 +02:00
type : number
hostname :
description : contains the hostname you want to add
type : string
type : object
summary : Add Forward Host
/api/v1/add/mailbox :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- add
- mailbox
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
domain : domain.tld
local_part : info
name : Full name
2020-09-17 20:35:13 +02:00
password : "*"
password2 : "*"
quota : "3072"
force_pw_update : "1"
tls_enforce_in : "1"
tls_enforce_out : "1"
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-06-07 20:46:17 +02:00
- null
msg :
- mailbox_added
- info@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : >-
You may create your own mailbox using this action. It takes a JSON
object containing a domain informations.
operationId : Create mailbox
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
domain : domain.tld
local_part : info
name : Full name
password : atedismonsin
password2 : atedismonsin
2020-09-17 20:35:13 +02:00
quota : "3072"
force_pw_update : "1"
tls_enforce_in : "1"
tls_enforce_out : "1"
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-06-07 20:46:17 +02:00
properties :
active :
description : is mailbox active or not
type : boolean
domain :
description : domain name
type : string
local_part :
description : left part of email address
type : string
name :
description : Full name of the mailbox user
type : string
password2 :
description : mailbox password for confirmation
type : string
2021-04-04 20:22:34 +02:00
password :
2020-06-07 20:46:17 +02:00
description : mailbox password
type : string
quota :
description : mailbox quota
type : number
2020-08-25 13:16:59 +02:00
force_pw_update :
description : forces the user to update its password on first login
type : boolean
tls_enforce_in :
description : force inbound email tls encryption
type : boolean
tls_enforce_out :
description : force oubound tmail tls encryption
type : boolean
2020-06-07 20:46:17 +02:00
type : object
summary : Create mailbox
2020-06-12 07:26:48 +02:00
2020-06-07 20:46:17 +02:00
/api/v1/add/oauth2-client :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- oauth2
- add
- client
2020-09-17 20:35:13 +02:00
- redirect_uri : "https://mailcow.tld"
2020-06-07 20:46:17 +02:00
msg : Added client access
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- oAuth Clients
description : Using this endpoint you can create a oAuth clients.
operationId : Create oAuth Client
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
redirect_uri : "https://mailcow.tld"
2020-06-07 20:46:17 +02:00
properties :
redirect_uri :
description : the uri where you should be redirected after oAuth
type : string
type : object
summary : Create oAuth Client
/api/v1/add/recipient_map :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- recipient_map
- add
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
recipient_map_new : target@mailcow.tld
recipient_map_old : recipient@mailcow.tld
- null
msg :
- recipient_map_entry_saved
- recipient@mailcow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Address Rewriting
description : >-
Using this endpoint you can create a recipient map to forward all mails
from one email address to another.
operationId : Create Recipient Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
recipient_map_new : target@mailcow.tld
recipient_map_old : recipient@mailcow.tld
properties :
active :
description : 1 for a active user account 0 for a disabled user account
type : number
recipient_map_new :
description : the email address that should receive the forwarded emails
type : string
recipient_map_old :
description : the email address which emails should be forwarded
type : string
type : object
summary : Create Recipient Map
/api/v1/add/relayhost :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- relayhost
- add
2020-09-17 20:35:13 +02:00
- hostname : "mailcow.tld:25"
2020-06-07 20:46:17 +02:00
password : supersecurepassword
username : testuser
msg :
- relayhost_added
2020-09-17 20:35:13 +02:00
- ""
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Routing
description : Using this endpoint you can create Sender-Dependent Transports.
operationId : Create Sender-Dependent Transports
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
hostname : "mailcow.tld:25"
2020-06-07 20:46:17 +02:00
password : supersecurepassword
username : testuser
properties :
hostname :
description : the hostname of the smtp server with port
type : string
password :
description : the password for the smtp user
type : string
username :
description : the username used to authenticate
type : string
type : object
summary : Create Sender-Dependent Transports
/api/v1/add/resource :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- add
- resource
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
description : test
domain : mailcow.tld
kind : location
2020-09-17 20:35:13 +02:00
multiple_bookings : "0"
multiple_bookings_custom : ""
multiple_bookings_select : "0"
2020-06-07 20:46:17 +02:00
- null
msg :
- resource_added
- mailcow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Resources
description : Using this endpoint you can create Resources.
operationId : Create Resources
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
description : test
domain : mailcow.tld
kind : location
2020-09-17 20:35:13 +02:00
multiple_bookings : "0"
multiple_bookings_custom : ""
multiple_bookings_select : "0"
2020-06-07 20:46:17 +02:00
properties :
active :
description : 1 for a active transport map 0 for a disabled transport map
type : number
description :
description : a description of the resource
type : string
domain :
description : the domain for which the resource should be
type : string
kind :
description : the kind of recouse
enum :
- location
- group
- thing
type : string
multiple_bookings :
enum :
2020-09-17 20:35:13 +02:00
- "-1"
- "1"
2020-06-07 20:46:17 +02:00
- custom
type : string
multiple_bookings_custom :
description : always empty
type : number
multiple_bookings_select :
enum :
2020-09-17 20:35:13 +02:00
- "-1"
- "1"
2020-06-07 20:46:17 +02:00
- custom
type : string
type : object
summary : Create Resources
/api/v1/add/syncjob :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- add
- syncjob
2020-09-17 20:35:13 +02:00
- active : "1"
automap : "1"
custom_params : ""
delete1 : "0"
delete2 : "0"
delete2duplicates : "1"
2020-06-07 20:46:17 +02:00
enc1 : SSL
exclude : (?i)spam|(?i)junk
host1 : imap.server.tld
2020-09-17 20:35:13 +02:00
maxage : "0"
maxbytespersecond : "0"
mins_interval : "20"
2020-06-07 20:46:17 +02:00
password1 : supersecret
port1 : 993
2020-09-17 20:35:13 +02:00
skipcrossduplicates : "0"
2020-06-07 20:46:17 +02:00
subfolder2 : External
2020-09-17 20:35:13 +02:00
subscribeall : "1"
timeout1 : "600"
timeout2 : "600"
2020-06-07 20:46:17 +02:00
user1 : username
username : mailbox@domain.tld
- null
msg :
- mailbox_modified
- mailbox@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Sync jobs
description : >-
You can create new sync job using this action. It takes a JSON object
containing a domain informations.
operationId : Create sync job
summary : Create sync job
2020-08-14 21:00:14 +02:00
requestBody :
content :
application/json :
schema :
example :
username : lisa@mailcow.tld
host1 : mail.mailcow.tld
2020-09-17 20:35:13 +02:00
port1 : "143"
2020-08-14 21:00:14 +02:00
user1 : demo@mailcow.tld
password1 : supersecretpw
enc1 : TLS
2020-09-17 20:35:13 +02:00
mins_interval : "20"
2020-08-14 21:00:14 +02:00
subfolder2 : "/SyncIntoSubfolder"
2020-09-17 20:35:13 +02:00
maxage : "0"
maxbytespersecond : "0"
timeout1 : "600"
timeout2 : "600"
2020-08-14 21:00:14 +02:00
exclude : "(?i)spam|(?i)junk"
custom_params : "--dry"
2020-09-17 20:35:13 +02:00
delete2duplicates : "1"
delete1 : "1"
delete2 : "0"
automap : "1"
skipcrossduplicates : "0"
subscribeall : "0"
active : "1"
2020-08-14 21:00:14 +02:00
properties :
parameters :
description : your local mailcow mailbox
type : string
host1 :
description : the smtp server where mails should be synced from
type : string
port1 :
description : the smtp port of the target mail server
type : string
password :
description : the password of the mailbox
type : string
enc1 :
description : the encryption method used to connect to the mailserver
type : string
mins_internal :
description : the interval in which messages should be syned
type : number
subfolder2 :
description : sync into subfolder on destination (empty = do not use subfolder)
type : string
maxage :
description : only sync messages up to this age in days
type : number
maxbytespersecond :
description : max speed transfer limit for the sync
type : number
timeout1 :
description : timeout for connection to remote host
type : number
timeout2 :
description : timeout for connection to local host
type : number
exclude :
description : exclude objects (regex)
type : string
custom_params :
description : custom parameters
type : string
delete2duplicates :
description : delete duplicates on destination (--delete2duplicates)
type : boolean
delete1 :
description : delete from source when completed (--delete1)
type : boolean
delete2 :
description : delete messages on destination that are not on source (--delete2)
type : boolean
automap :
description : try to automap folders ("Sent items", "Sent" => "Sent" etc.) (--automap)
type : boolean
skipcrossduplicates :
description : skip duplicate messages across folders (first come, first serve) (--skipcrossduplicates)
type : boolean
subscribeall :
description : subscribe all folders (--subscribeall)
type : boolean
active :
description : enables or disables the sync job
type : boolean
type : object
2020-06-07 20:46:17 +02:00
/api/v1/add/tls-policy-map :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- tls_policy_maps
- add
2020-09-17 20:35:13 +02:00
- parameters : ""
active : "1"
2020-06-07 20:46:17 +02:00
dest : mailcow.tld
policy : encrypt
- null
msg :
- tls_policy_map_entry_saved
- mailcow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Outgoing TLS Policy Map Overrides
description : Using this endpoint you can create a TLS policy map override.
operationId : Create TLS Policy Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
parameters : ""
active : "1"
2020-06-07 20:46:17 +02:00
dest : mailcow.tld
policy : encrypt
properties :
parameters :
description : >-
custom parameters you find out more about them
[ here](http://www.postfix.org/postconf.5.html#smtp_tls_policy_maps)
type : string
active :
description : 1 for a active user account 0 for a disabled user account
type : number
dest :
description : the target domain or email address
type : string
policy :
description : the policy
enum :
- none
- may
- encrypt
- dane
2020-09-17 20:35:13 +02:00
- "'dane"
2020-06-07 20:46:17 +02:00
- fingerprint
- verify
- secure
type : string
type : object
summary : Create TLS Policy Map
2021-11-27 13:25:06 +01:00
/api/v1/add/transport :
2020-06-07 20:46:17 +02:00
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- transport
- add
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
destination : example2.org
2020-09-17 20:35:13 +02:00
nexthop : "host:25"
2020-06-07 20:46:17 +02:00
password : supersecurepw
username : testuser
msg :
- relayhost_added
2020-09-17 20:35:13 +02:00
- ""
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Routing
description : Using this endpoint you can create Sender-Dependent Transports.
operationId : Create Transport Maps
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
destination : example.org
2020-09-17 20:35:13 +02:00
nexthop : "host:25"
2020-06-07 20:46:17 +02:00
password : supersecurepw
username : testuser
properties :
active :
description : 1 for a active transport map 0 for a disabled transport map
type : number
destination :
type : string
nexthop :
type : string
password :
description : the password for the smtp user
type : string
username :
description : the username used to authenticate
type : string
type : object
summary : Create Transport Maps
/api/v1/delete/alias :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- alias
- id :
2020-09-17 20:35:13 +02:00
- "6"
- "9"
2020-06-07 20:46:17 +02:00
- null
msg :
- alias_removed
- alias@domain.tld
type : success
- log :
- mailbox
- delete
- alias
- id :
2020-09-17 20:35:13 +02:00
- "6"
- "9"
2020-06-07 20:46:17 +02:00
- null
msg :
- alias_removed
- alias2@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Aliases
description : You can delete one or more aliases.
operationId : Delete alias
requestBody :
content :
application/json :
schema :
items :
2020-10-04 21:42:16 +02:00
example : "6"
2020-06-07 20:46:17 +02:00
type : string
type : array
summary : Delete alias
/api/v1/delete/app-passwd :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- app_passwd
- delete
- id :
2020-09-17 20:35:13 +02:00
- "2"
2020-06-07 20:46:17 +02:00
msg :
- app_passwd_removed
2020-09-17 20:35:13 +02:00
- "2"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- App Passwords
description : Using this endpoint you can delete a single app password.
operationId : Delete App Password
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of app passwords you want to delete
type : object
type : object
summary : Delete App Password
/api/v1/delete/bcc :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- bcc
- delete
- id :
2020-09-17 20:35:13 +02:00
- "4"
2020-06-07 20:46:17 +02:00
- null
msg :
- bcc_deleted
2020-09-17 20:35:13 +02:00
- "4"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Address Rewriting
description : >-
Using this endpoint you can delete a BCC map, for this you have to know
its ID. You can get the ID using the GET method.
operationId : Delete BCC Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "3"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of bcc maps you want to delete
type : object
type : object
summary : Delete BCC Map
/api/v1/delete/dkim :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- dkim
- delete
- domains :
- mailcow.tld
msg :
- dkim_removed
- mailcow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- DKIM
description : Using this endpoint a existing DKIM Key can be deleted
operationId : Delete DKIM Key
requestBody :
content :
application/json :
schema :
items :
example :
- mailcow.tld
type : string
type : array
summary : Delete DKIM Key
/api/v1/delete/domain :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- domain
- domain :
- domain.tld
- domain2.tld
- null
msg :
- domain_removed
- domain.tld
type : success
- log :
- mailbox
- delete
- domain
- domain :
- domain.tld
- domain2.tld
- null
msg :
- domain_removed
- domain2.tld
type : success
schema :
2022-07-19 20:22:45 +02:00
type : array
items :
type : object
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domains
description : You can delete one or more domains.
operationId : Delete domain
requestBody :
content :
application/json :
schema :
2022-07-19 20:22:45 +02:00
type : object
2020-06-07 20:46:17 +02:00
example :
- domain.tld
- domain2.tld
properties :
2023-01-06 19:25:23 +01:00
items :
2022-07-19 20:22:45 +02:00
type : array
items :
type : string
2020-06-07 20:46:17 +02:00
summary : Delete domain
/api/v1/delete/domain-admin :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- domain_admin
- delete
- username :
- testadmin
msg :
- domain_admin_removed
- testadmin
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domain admin
description : Using this endpoint a existing Domain Admin user can be deleted.
operationId : Delete Domain Admin
requestBody :
content :
application/json :
schema :
example :
- testadmin
properties :
items :
description : contains list of usernames of the users you want to delete
type : object
type : object
summary : Delete Domain Admin
/api/v1/delete/domain-policy :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- policy
- delete
- domain
- prefid :
2020-09-17 20:35:13 +02:00
- "1"
- "2"
2020-06-07 20:46:17 +02:00
msg :
- item_deleted
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
- log :
- policy
- delete
- domain
- prefid :
2020-09-17 20:35:13 +02:00
- "1"
- "2"
2020-06-07 20:46:17 +02:00
msg :
- item_deleted
2020-09-17 20:35:13 +02:00
- "2"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domain antispam policies
description : You can delete one o more domain policies.
operationId : Delete domain policy
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "1"
- "2"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of domain policys you want to delete
type : object
type : object
summary : Delete domain policy
/api/v1/delete/fwdhost :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- fwdhost
- delete
- forwardinghost :
- 5.1 .76 .202
2020-09-17 20:35:13 +02:00
- "2a00:f820:417::202"
2020-06-07 20:46:17 +02:00
msg :
- forwarding_host_removed
- 5.1 .76 .202
type : success
- log :
- fwdhost
- delete
- forwardinghost :
- 5.1 .76 .202
2020-09-17 20:35:13 +02:00
- "2a00:f820:417::202"
2020-06-07 20:46:17 +02:00
msg :
- forwarding_host_removed
2020-09-17 20:35:13 +02:00
- "2a00:f820:417::202"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Fordwarding Hosts
description : >-
Using this endpoint you can delete a forwarding host, in order to do so
you need to know the IP of the host.
operationId : Delete Forward Host
requestBody :
content :
application/json :
schema :
example :
- 5.1 .76 .202
2020-09-17 20:35:13 +02:00
- "2a00:f820:417::202"
2020-06-07 20:46:17 +02:00
properties :
ip :
description : contains the ip of the fowarding host you want to delete
type : string
type : object
summary : Delete Forward Host
/api/v1/delete/mailbox :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- mailbox
- username :
- info@domain.tld
- sales@domain.tld
- null
msg :
- mailbox_removed
- info@domain.tld
type : success
- log :
- mailbox
- delete
- mailbox
- username :
- info@domain.tld
- sales@domain.tld
- null
msg :
- mailbox_removed
- sales@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : You can delete one or more mailboxes.
operationId : Delete mailbox
requestBody :
content :
application/json :
schema :
example :
- info@domain.tld
- sales@domain.tld
properties :
items :
description : contains list of mailboxes you want to delete
type : object
type : object
summary : Delete mailbox
/api/v1/delete/mailq :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
msg : Task completed
type : success
description : OK
headers : {}
tags :
- Queue Manager
description : >-
Using this API you can delete the current mail queue. This will delete
all mails in it.
This API uses the command : `postsuper -d`
operationId : Delete Queue
requestBody :
content :
application/json :
schema :
example :
action : super_delete
properties :
action :
description : use super_delete to delete the mail queue
type : string
type : object
summary : Delete Queue
/api/v1/delete/oauth2-client :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- oauth2
- delete
- client
- id :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
msg :
- items_deleted
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- oAuth Clients
description : >-
Using this endpoint you can delete a oAuth client, for this you have to
know its ID. You can get the ID using the GET method.
operationId : Delete oAuth Client
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "3"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of oAuth clients you want to delete
type : object
type : object
summary : Delete oAuth Client
/api/v1/delete/qitem :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- quarantine
- delete
- id :
2020-09-17 20:35:13 +02:00
- "33"
2020-06-07 20:46:17 +02:00
msg :
- item_deleted
2020-09-17 20:35:13 +02:00
- "33"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Quarantine
description : >-
Using this endpoint you can delete a email from quarantine, for this you
have to know its ID. You can get the ID using the GET method.
operationId : Delete mails in Quarantine
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "33"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of emails you want to delete
type : object
type : object
summary : Delete mails in Quarantine
/api/v1/delete/recipient_map :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- recipient_map
- delete
- id :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
- null
msg :
- recipient_map_entry_deleted
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Address Rewriting
description : >-
Using this endpoint you can delete a recipient map, for this you have to
know its ID. You can get the ID using the GET method.
operationId : Delete Recipient Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of recipient maps you want to delete
type : object
type : object
summary : Delete Recipient Map
/api/v1/delete/relayhost :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- relayhost
- delete
- id :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
msg :
- relayhost_removed
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Routing
description : >-
Using this endpoint you can delete a Sender-Dependent Transport, for
this you have to know its ID. You can get the ID using the GET method.
operationId : Delete Sender-Dependent Transports
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
properties :
items :
description : >-
contains list of Sender-Dependent Transport you want to
delete
type : object
type : object
summary : Delete Sender-Dependent Transports
/api/v1/delete/resource :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- resource
- name :
- test@mailcow.tld
- null
msg :
- resource_removed
- test@mailcow.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Resources
description : >-
Using this endpoint you can delete a Resources, for this you have to
know its ID. You can get the ID using the GET method.
operationId : Delete Resources
requestBody :
content :
application/json :
schema :
example :
- test@mailcow.tld
properties :
items :
description : contains list of Resources you want to delete
type : object
type : object
summary : Delete Resources
/api/v1/delete/syncjob :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
log :
- entity
- action
- object
msg :
- message
- entity name
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Sync jobs
description : You can delete one or more sync jobs.
operationId : Delete sync job
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "6"
- "9"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of aliases you want to delete
type : object
type : object
summary : Delete sync job
/api/v1/delete/tls-policy-map :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- tls_policy_maps
- delete
- id :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
- null
msg :
- tls_policy_map_entry_deleted
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Outgoing TLS Policy Map Overrides
description : >-
Using this endpoint you can delete a TLS Policy Map, for this you have
to know its ID. You can get the ID using the GET method.
operationId : Delete TLS Policy Map
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "3"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of tls policy maps you want to delete
type : object
type : object
summary : Delete TLS Policy Map
/api/v1/delete/transport :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- transport
- delete
- id :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
msg :
- relayhost_removed
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Routing
description : >-
Using this endpoint you can delete a Transport Maps, for this you have
to know its ID. You can get the ID using the GET method.
operationId : Delete Transport Maps
requestBody :
content :
application/json :
schema :
example :
2020-09-17 20:35:13 +02:00
- "1"
2020-06-07 20:46:17 +02:00
properties :
items :
description : contains list of transport maps you want to delete
type : object
type : object
summary : Delete Transport Maps
2022-05-05 08:25:01 +02:00
"/api/v1/delete/mailbox/tag/{mailbox}" :
post :
parameters :
- description : name of mailbox
in : path
name : mailbox
example : info@domain.tld
required : true
schema :
type : string
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- tags_mailbox
- tags :
- tag1
- tag2
mailbox : info@domain.tld
- null
msg :
- mailbox_modified
- info@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : You can delete one or more mailbox tags.
operationId : Delete mailbox tags
requestBody :
content :
application/json :
schema :
example :
- tag1
- tag2
properties :
items :
description : contains list of mailboxes you want to delete
type : object
type : object
summary : Delete mailbox tags
"/api/v1/delete/domain/tag/{domain}" :
post :
parameters :
- description : name of domain
in : path
name : domain
example : domain.tld
required : true
schema :
type : string
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- delete
- tags_domain
- tags :
- tag1
- tag2
domain : domain.tld
- null
msg :
- domain_modified
- domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Domains
description : You can delete one or more domain tags.
operationId : Delete domain tags
requestBody :
content :
application/json :
schema :
example :
- tag1
- tag2
properties :
items :
description : contains list of domains you want to delete
type : object
type : object
summary : Delete domain tags
2020-06-07 20:46:17 +02:00
/api/v1/edit/alias :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- edit
- alias
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
address : alias@domain.tld
goto : destination@domain.tld
id :
2020-09-17 20:35:13 +02:00
- "6"
2020-06-07 20:46:17 +02:00
private_comment : private comment
public_comment : public comment
- null
msg :
- alias_modified
- alias@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Aliases
description : >-
You can update one or more aliases per request. You can also send just
attributes you want to change
operationId : Update alias
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
active : "1"
2020-06-07 20:46:17 +02:00
address : alias@domain.tld
goto : destination@domain.tld
private_comment : private comment
public_comment : public comment
2020-10-04 21:42:16 +02:00
items : [ "6" ]
2020-06-07 20:46:17 +02:00
properties :
attr :
properties :
active :
description : is alias active or not
type : boolean
address :
description : 'alias address, for catchall use "@domain.tld"'
type : string
goto :
2020-09-17 20:35:13 +02:00
description : "destination address, comma separated"
2020-06-07 20:46:17 +02:00
type : string
goto_ham :
description : learn as ham
type : boolean
goto_null :
description : silently ignore
type : boolean
goto_spam :
description : learn as spam
type : boolean
private_comment :
type : string
public_comment :
type : string
2021-01-30 15:48:31 +01:00
sogo_visible :
description : toggle visibility as selectable sender in SOGo
type : boolean
2020-06-07 20:46:17 +02:00
type : object
items :
description : contains list of aliases you want update
type : object
type : object
summary : Update alias
/api/v1/edit/domain :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
2022-07-19 20:22:45 +02:00
application/json :
2020-06-07 20:46:17 +02:00
schema :
2022-07-19 20:22:45 +02:00
type : array
2023-01-06 19:25:23 +01:00
items :
2022-07-19 20:22:45 +02:00
type : object
properties :
log :
type : array
description : contains request object
items : {}
msg :
type : array
items : {}
type :
enum :
- success
- danger
- error
type : string
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domains
description : >-
You can update one or more domains per request. You can also send just
attributes you want to change.
Example : You can add domain names to items list and in attr object just
include `"active": "0"` to deactivate domains.
operationId : Update domain
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
active : "1"
aliases : "400"
backupmx : "1"
defquota : "3072"
2020-06-07 20:46:17 +02:00
description : domain description
2020-09-17 20:35:13 +02:00
gal : "1"
mailboxes : "10"
maxquota : "10240"
quota : "10240"
relay_all_recipients : "0"
relayhost : "2"
2022-05-05 08:25:01 +02:00
tags : [ "tag3" , "tag4" ]
2020-06-07 20:46:17 +02:00
items : domain.tld
properties :
attr :
properties :
active :
description : is domain active or not
type : boolean
aliases :
description : limit count of aliases associated with this domain
type : number
backupmx :
description : relay domain or not
type : boolean
defquota :
description : predefined mailbox quota in `add mailbox` form
type : number
description :
description : Description of domain
type : string
gal :
description : >-
is domain global address list active or not, it enables
shared contacts accross domain in SOGo webmail
type : boolean
mailboxes :
description : limit count of mailboxes associated with this domain
type : number
maxquota :
description : maximum quota per mailbox
type : number
quota :
description : maximum quota for this domain (for all mailboxes in sum)
type : number
relay_all_recipients :
description : >-
if not, them you have to create "dummy" mailbox for each
address to relay
type : boolean
2022-07-19 20:22:45 +02:00
relay_unknown_only :
description : Relay non-existing mailboxes only. Existing mailboxes will be delivered locally.
type : boolean
2020-06-07 20:46:17 +02:00
relayhost :
description : id of relayhost
type : number
2022-07-19 20:22:45 +02:00
rl_frame :
enum :
- s
- m
- h
- d
type : string
rl_value :
description : rate limit value
type : number
tags :
description : tags for this Domain
type : array
items :
type : string
2020-06-07 20:46:17 +02:00
type : object
items :
description : contains list of domain names you want update
2022-07-19 20:22:45 +02:00
type : array
items :
type : string
2020-06-07 20:46:17 +02:00
type : object
summary : Update domain
/api/v1/edit/fail2ban :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
2020-09-17 20:35:13 +02:00
"*/*" :
2020-06-07 20:46:17 +02:00
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Fail2Ban
description : >-
Using this endpoint you can edit the Fail2Ban config and black or
whitelist new ips.
operationId : Edit Fail2Ban
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
ban_time : "86400"
2023-03-17 18:22:16 +01:00
ban_time_increment : "1"
2020-09-17 20:35:13 +02:00
blacklist : "10.100.6.5/32,10.100.8.4/32"
max_attempts : "5"
2023-03-17 18:22:16 +01:00
max_ban_time : "86400"
2020-09-17 20:35:13 +02:00
netban_ipv4 : "24"
netban_ipv6 : "64"
retry_window : "600"
2020-06-07 20:46:17 +02:00
whitelist : mailcow.tld
items : none
properties :
attr :
description : array containing the fail2ban settings
properties :
backlist :
description : the backlisted ips or hostnames separated by comma
type : string
ban_time :
2023-03-17 18:22:16 +01:00
description : the time an ip should be banned
2020-06-07 20:46:17 +02:00
type : number
2023-03-17 18:22:16 +01:00
ban_time_increment :
description : if the time of the ban should increase each time
type : boolean
2020-06-07 20:46:17 +02:00
max_attempts :
description : the maximum numbe of wrong logins before a ip is banned
type : number
2023-03-17 18:22:16 +01:00
max_ban_time :
description : the maximum time an ip should be banned
type : number
2020-06-07 20:46:17 +02:00
netban_ipv4 :
description : the networks mask to ban for ipv4
type : number
netban_ipv6 :
description : the networks mask to ban for ipv6
type : number
retry_window :
description : >-
the maximum time in which a ip as to login with false
credentials to be banned
type : number
whitelist :
description : whitelisted ips or hostnames sepereated by comma
type : string
type : object
items :
description : has to be none
type : object
summary : Edit Fail2Ban
/api/v1/edit/mailbox :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- mailbox
- edit
- mailbox
2020-09-17 20:35:13 +02:00
- active : "1"
force_pw_update : "0"
2020-06-07 20:46:17 +02:00
name : Full name
2020-09-17 20:35:13 +02:00
password : "*"
password2 : "*"
quota : "3072"
2020-06-07 20:46:17 +02:00
sender_acl :
- default
- info@domain2.tld
- domain3.tld
2020-09-17 20:35:13 +02:00
- "*"
sogo_access : "1"
2020-06-07 20:46:17 +02:00
username :
- info@domain.tld
2022-05-05 08:25:01 +02:00
tags : [ "tag3" , "tag4" ]
2020-06-07 20:46:17 +02:00
- null
msg :
- mailbox_modified
- info@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : >-
You can update one or more mailboxes per request. You can also send just
attributes you want to change
operationId : Update mailbox
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
active : "1"
force_pw_update : "0"
2020-06-07 20:46:17 +02:00
name : Full name
2020-09-17 20:35:13 +02:00
password : ""
password2 : ""
quota : "3072"
2020-06-07 20:46:17 +02:00
sender_acl :
- default
- info@domain2.tld
- domain3.tld
2020-09-17 20:35:13 +02:00
- "*"
sogo_access : "1"
2022-05-05 08:25:01 +02:00
tags : [ "tag3" , "tag4" ]
2021-02-07 00:16:27 +01:00
items :
- info@domain.tld
2020-06-07 20:46:17 +02:00
properties :
attr :
properties :
active :
description : is mailbox active or not
type : boolean
force_pw_update :
description : force user to change password on next login
type : boolean
name :
description : Full name of the mailbox user
type : string
password2 :
description : new mailbox password for confirmation
type : string
2021-04-04 20:22:34 +02:00
password :
2020-06-07 20:46:17 +02:00
description : new mailbox password
type : string
quota :
description : mailbox quota
type : number
sender_acl :
description : list of allowed send from addresses
type : object
sogo_access :
description : is access to SOGo webmail active or not
type : boolean
type : object
items :
description : contains list of mailboxes you want update
type : object
type : object
summary : Update mailbox
/api/v1/edit/mailq :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
msg : Task completed
type : success
description : OK
headers : {}
tags :
- Queue Manager
description : >-
Using this API you can flush the current mail queue. This will try to
deliver all mails currently in it.
This API uses the command : `postqueue -f`
operationId : Flush Queue
requestBody :
content :
application/json :
schema :
example :
action : flush
properties :
action :
description : use flush to flush the mail queue
type : string
type : object
summary : Flush Queue
/api/v1/edit/pushover :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- pushover
- edit
2020-09-17 20:35:13 +02:00
- active : "0"
evaluate_x_prio : "0"
2020-06-07 20:46:17 +02:00
key : 21e8918e1jksdjcpis712
2020-09-17 20:35:13 +02:00
only_x_prio : "0"
2022-11-17 14:30:06 +01:00
sound : "pushover"
2020-09-17 20:35:13 +02:00
senders : ""
senders_regex : ""
text : ""
2020-06-07 20:46:17 +02:00
title : Mail
token : 9023e2ohcwed27d1idu2
username :
- info@domain.tld
msg : pushover_settings_edited
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : >-
Using this endpoint it is possible to update the pushover settings for
mailboxes
operationId : Update Pushover settings
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
active : "0"
evaluate_x_prio : "0"
2020-06-07 20:46:17 +02:00
key : 21e8918e1jksdjcpis712
2020-09-17 20:35:13 +02:00
only_x_prio : "0"
2022-11-17 14:30:06 +01:00
sound : "pushover"
2020-09-17 20:35:13 +02:00
senders : ""
senders_regex : ""
text : ""
2020-06-07 20:46:17 +02:00
title : Mail
token : 9023e2ohcwed27d1idu2
items : info@domain.tld
properties :
attr :
properties :
active :
description : Enables pushover 1 disable pushover 0
type : number
evaluate_x_prio :
description : Send the Push with High priority
type : number
key :
description : Pushover key
type : string
only_x_prio :
description : Only send push for prio mails
type : number
2022-11-17 14:30:06 +01:00
sound :
description : Set notification sound
type : string
2020-06-07 20:46:17 +02:00
senders :
description : Only send push for emails from these senders
type : string
senders_regex :
description : Regex to match senders for which a push will be send
type : string
text :
description : Custom push noficiation text
type : string
title :
description : Push title
type : string
token :
description : Pushover token
type : string
type : object
items :
description : contains list of mailboxes you want to delete
type : object
type : object
summary : Update Pushover settings
/api/v1/edit/quarantine_notification :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Mailboxes
description : You can update one or more mailboxes per request.
operationId : Quarantine Notifications
requestBody :
content :
application/json :
schema :
example :
attr :
quarantine_notification : hourly
items :
anyOf :
- mailbox1@domain.tld
- mailbox2@domain.tld
properties :
attr :
properties :
quarantine_notification :
description : recurrence
enum :
- hourly
- daily
- weekly
- never
type : string
type : object
items :
description : >-
contains list of mailboxes you want set qurantine
notifications
type : object
type : object
summary : Quarantine Notifications
/api/v1/edit/syncjob :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
log :
- entity
- action
- object
msg :
- message
- entity name
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Sync jobs
description : >-
You can update one or more sync jobs per request. You can also send just
attributes you want to change.
operationId : Update sync job
requestBody :
content :
application/json :
schema :
example :
attr :
2020-09-17 20:35:13 +02:00
active : "1"
automap : "1"
custom_params : ""
delete1 : "0"
delete2 : "0"
delete2duplicates : "1"
2020-06-07 20:46:17 +02:00
enc1 : SSL
exclude : (?i)spam|(?i)junk
host1 : imap.server.tld
2020-09-17 20:35:13 +02:00
maxage : "0"
maxbytespersecond : "0"
mins_interval : "20"
2020-06-07 20:46:17 +02:00
password1 : supersecret
2020-09-17 20:35:13 +02:00
port1 : "993"
skipcrossduplicates : "0"
2020-06-07 20:46:17 +02:00
subfolder2 : External
2020-09-17 20:35:13 +02:00
subscribeall : "1"
timeout1 : "600"
timeout2 : "600"
2020-06-07 20:46:17 +02:00
user1 : username
2020-09-17 20:35:13 +02:00
items : "1"
2020-06-07 20:46:17 +02:00
properties :
attr :
properties :
active :
description : Is sync job active
type : boolean
automap :
description : >-
Try to automap folders ("Sent items", "Sent" => "Sent"
etc.)
type : boolean
custom_params :
description : Custom parameters passed to imapsync command
type : string
delete1 :
description : Delete from source when completed
type : boolean
delete2 :
description : Delete messages on destination that are not on source
type : boolean
delete2duplicates :
description : Delete duplicates on destination
type : boolean
enc1 :
description : Encryption
enum :
- TLS
- SSL
- PLAIN
type : string
exclude :
description : Exclude objects (regex)
type : string
host1 :
description : Hostname
type : string
maxage :
description : >-
Maximum age of messages in days that will be polled from
remote (0 = ignore age)
type : number
maxbytespersecond :
description : Max. bytes per second (0 = unlimited)
type : number
mins_interval :
description : Interval (min)
type : number
password1 :
description : Password
type : string
port1 :
description : Port
type : string
skipcrossduplicates :
description : >-
Skip duplicate messages across folders (first come,
first serve)
type : boolean
subfolder2 :
description : >-
Sync into subfolder on destination (empty = do not use
subfolder)
type : string
subscribeall :
description : Subscribe all folders
type : boolean
timeout1 :
description : Timeout for connection to remote host
type : number
timeout2 :
description : Timeout for connection to local host
type : number
user1 :
description : Username
type : string
type : object
items :
description : contains list of aliases you want update
type : object
type : object
summary : Update sync job
/api/v1/edit/user-acl :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- log :
- acl
- edit
- user
- user_acl :
- spam_alias
- tls_policy
- spam_score
- spam_policy
- delimiter_action
- syncjobs
- eas_reset
- quarantine
- sogo_profile_reset
- quarantine_attachments
- quarantine_notification
- app_passwds
- pushover
username :
- info@domain.tld
msg :
- acl_saved
- info@domain.tld
type : success
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : Using this endpoints its possible to update the ACL's for mailboxes
operationId : Update mailbox ACL
requestBody :
content :
application/json :
schema :
example :
attr :
user_acl :
- spam_alias
- tls_policy
- spam_score
- spam_policy
- delimiter_action
- syncjobs
- eas_reset
- quarantine
- sogo_profile_reset
- quarantine_attachments
- quarantine_notification
- app_passwds
- pushover
items : info@domain.tld
properties :
attr :
properties :
user_acl :
description : contains a list of active user acls
type : object
type : object
items :
description : contains list of mailboxes you want to delete
type : object
type : object
summary : Update mailbox ACL
2020-09-17 20:35:13 +02:00
"/api/v1/get/alias/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
address : alias@domain.tld
2020-09-17 20:35:13 +02:00
created : "2019-04-04 19:29:49"
2020-06-07 20:46:17 +02:00
domain : domain.tld
goto : destination@domain.tld
id : 6
2020-09-17 20:35:13 +02:00
in_primary_domain : ""
2020-06-07 20:46:17 +02:00
is_catch_all : 0
modified : null
private_comment : null
public_comment : null
2020-09-17 20:35:13 +02:00
- active : "1"
address : "@domain.tld"
created : "2019-04-27 13:42:39"
2020-06-07 20:46:17 +02:00
domain : domain.tld
goto : destination@domain.tld
id : 10
2020-09-17 20:35:13 +02:00
in_primary_domain : ""
2020-06-07 20:46:17 +02:00
is_catch_all : 1
modified : null
private_comment : null
public_comment : null
description : OK
headers : {}
tags :
- Aliases
description : You can list mailbox aliases existing in system.
operationId : Get aliases
summary : Get aliases
2021-11-12 12:53:31 +01:00
"/api/v1/get/time_limited_aliases/{mailbox}" :
get :
parameters :
- description : mailbox you want to get aliasses from
example : domain.tld
in : path
schema :
type : string
name : mailbox
required : true
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- address : alias@domain.tld
goto : destination@domain.tld
validity : 1668251246
created : "2021-11-12 12:07:26"
modified : null
description : OK
headers : {}
tags :
- Aliases
description : You can list time limited mailbox aliases existing in system.
operationId : Get time limited aliases
summary : Get time limited aliases
2020-09-17 20:35:13 +02:00
"/api/v1/get/app-passwd/all/{mailbox}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : mailbox of entry you want to get
example : hello@mailcow.email
in : path
name : mailbox
required : true
schema :
enum :
- hello@mailcow.email
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
created : "2019-12-21 16:04:55"
2020-06-07 20:46:17 +02:00
domain : mailcow.email
id : 2
mailbox : hello@mailcow.email
modified : null
name : emclient
description : OK
headers : {}
tags :
- App Passwords
description : >-
Using this endpoint you can get all app passwords from a specific
mailbox.
operationId : Get App Password
summary : Get App Password
2020-09-17 20:35:13 +02:00
"/api/v1/get/bcc/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
bcc_dest : bcc@awesomecow.tld
2020-09-17 20:35:13 +02:00
created : "2019-10-02 21:44:34"
2020-06-07 20:46:17 +02:00
domain : mailcow.tld
id : 3
2020-09-17 20:35:13 +02:00
local_dest : "@mailcow.tld"
2020-06-07 20:46:17 +02:00
modified : null
type : sender
description : OK
headers : {}
tags :
- Address Rewriting
description : Using this endpoint you can get all BCC maps.
operationId : Get BCC Map
summary : Get BCC Map
2020-09-17 20:35:13 +02:00
"/api/v1/get/dkim/{domain}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : name of domain
in : path
name : domain
required : true
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
dkim_selector : dkim
dkim_txt : >-
v=DKIM1;k=rsa;t=s;s=email;p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA21tUSjyasQy/hJmVjPnlRGfzx6TPhYj8mXY9DVOzSAE64Gddw/GnE/GcCR6WXNT23u9q4zPnz1IPoNt5kFOps8vg/iNqrcH++494noaZuYyFPPFnebkfryO4EvEyxC/c66qts+gnOUml+M8uv5WObBJld2gG12jLwFM0263J/N6J8LuUsaXOB2uCIfx8Nf4zjuJ6Ieez2uyHNK5dXjDLfKA4mTr+EEK6W6e34M4KN1liWM6r9Oy5S1FlLrD42VpURxxBZtBiEtaJPEKSQuk6GQz8ihu7W20Yr53tyCdaORu8dhxXVUWVf+GjuuMEdAmQCjYkarXdYCrt56Psw703kwIDAQAB
2020-09-17 20:35:13 +02:00
length : "2048"
privkey : ""
2020-06-07 20:46:17 +02:00
pubkey : >-
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA21tUSjyasQy/hJmVjPnlRGfzx6TPhYj8mXY9DVOzSAE64Gddw/GnE/GcCR6WXNT23u9q4zPnz1IPoNt5kFOps8vg/iNqrcH++494noaZuYyFPPFnebkfryO4EvEyxC/c66qts+gnOUml+M8uv5WObBJld2gG12jLwFM0263J/N6J8LuUsaXOB2uCIfx8Nf4zjuJ6Ieez2uyHNK5dXjDLfKA4mTr+EEK6W6e34M4KN1liWM6r9Oy5S1FlLrD42VpURxxBZtBiEtaJPEKSQuk6GQz8ihu7W20Yr53tyCdaORu8dhxXVUWVf+GjuuMEdAmQCjYkarXdYCrt56Psw703kwIDAQAB
description : OK
headers : {}
tags :
- DKIM
description : >-
Using this endpoint you can get the DKIM public key for a specific
domain.
operationId : Get DKIM Key
summary : Get DKIM Key
/api/v1/get/domain-admin/all :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
created : "2019-10-02 10:29:41"
2020-06-07 20:46:17 +02:00
selected_domains :
- mailcow.tld
2020-09-17 20:59:27 +02:00
tfa_active : "0"
2020-06-07 20:46:17 +02:00
unselected_domains :
- awesomemailcow.de
- mailcowisgreat.de
username : testadmin
description : OK
headers : {}
tags :
- Domain admin
2020-09-17 20:35:13 +02:00
description : ""
2020-06-07 20:46:17 +02:00
operationId : Get Domain Admins
summary : Get Domain Admins
2020-09-17 20:35:13 +02:00
"/api/v1/get/domain/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
- mailcow.tld
type : string
2022-05-05 08:25:01 +02:00
- description : comma seperated list of tags to filter by
example : "tag1,tag2"
in : query
name : tags
required : false
2022-07-08 20:47:28 +02:00
schema :
type : string
2020-06-07 20:46:17 +02:00
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
aliases_in_domain : 0
aliases_left : 400
2020-09-17 20:59:27 +02:00
backupmx : "0"
2020-09-17 20:35:13 +02:00
bytes_total : "5076666944"
2020-06-07 20:46:17 +02:00
def_new_mailbox_quota : 3221225472
def_quota_for_mbox : 3221225472
description : Some description
domain_name : domain.tld
2020-09-17 20:59:27 +02:00
gal : "0"
2020-06-07 20:46:17 +02:00
max_new_mailbox_quota : 10737418240
max_num_aliases_for_domain : 400
max_num_mboxes_for_domain : 10
max_quota_for_domain : 10737418240
max_quota_for_mbox : 10737418240
mboxes_in_domain : 0
mboxes_left : 10
2020-09-17 20:35:13 +02:00
msgs_total : "172440"
quota_used_in_domain : "0"
2020-09-17 20:59:27 +02:00
relay_all_recipients : "0"
2020-09-17 20:35:13 +02:00
relayhost : "0"
2020-06-07 20:46:17 +02:00
rl : false
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
aliases_in_domain : 0
aliases_left : 400
2020-09-17 20:35:13 +02:00
backupmx : "1"
bytes_total : "5076666944"
2020-06-07 20:46:17 +02:00
def_new_mailbox_quota : 3221225472
def_quota_for_mbox : 3221225472
description : domain description
domain_name : domain2.tld
2020-09-17 20:59:27 +02:00
gal : "0"
2020-06-07 20:46:17 +02:00
max_new_mailbox_quota : 10737418240
max_num_aliases_for_domain : 400
max_num_mboxes_for_domain : 10
max_quota_for_domain : 10737418240
max_quota_for_mbox : 10737418240
mboxes_in_domain : 0
mboxes_left : 10
2020-09-17 20:35:13 +02:00
msgs_total : "172440"
quota_used_in_domain : "0"
2020-09-17 20:59:27 +02:00
relay_all_recipients : "0"
2020-09-17 20:35:13 +02:00
relayhost : "0"
2020-06-07 20:46:17 +02:00
rl : false
2022-05-05 08:25:01 +02:00
tags : [ "tag3" , "tag4" ]
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domains
description : You can list all domains existing in system.
operationId : Get domains
summary : Get domains
/api/v1/get/fail2ban :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
ban_time : 604800
2023-03-17 18:22:16 +01:00
ban_time_increment : 1
2020-06-07 20:46:17 +02:00
blacklist : |-
45.82 .153 .37 /32
92.118 .38 .52 /32
max_attempts : 1
2023-03-17 18:22:16 +01:00
max_ban_time : 604800
2020-06-07 20:46:17 +02:00
netban_ipv4 : 32
netban_ipv6 : 128
perm_bans :
- 45.82 .153 .37 /32
- 92.118 .38 .52 /32
retry_window : 7200
whitelist : 1.1 .1 .1
description : OK
headers : {}
tags :
- Fail2Ban
description : Gets the current Fail2Ban configuration.
operationId : Get Fail2Ban Config
summary : Get Fail2Ban Config
/api/v1/get/fwdhost/all :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- host : 5.1 .76 .202
2020-09-17 20:35:13 +02:00
keep_spam : "yes"
2020-06-07 20:46:17 +02:00
source : hosted.mailcow.de
2020-09-17 20:35:13 +02:00
- host : "2a00:f820:417::202"
keep_spam : "yes"
2020-06-07 20:46:17 +02:00
source : hosted.mailcow.de
description : OK
headers : {}
tags :
- Fordwarding Hosts
description : You can list all Forwarding Hosts in your mailcow.
operationId : Get Forwarding Hosts
summary : Get Forwarding Hosts
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/acme/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- message : >-
Certificate validation done, neither changed nor due for
renewal, sleeping for another day.
2020-09-17 20:35:13 +02:00
time : "1569927728"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all ACME logs from issued Lets Enctypts
certificates.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get ACME logs
summary : Get ACME logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/api/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- data : ""
2020-06-07 20:46:17 +02:00
method : GET
remote : 1.1 .1 .1
time : 1569939001
uri : /api/v1/get/logs/api/2
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Api logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Api logs
summary : Get Api logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/autodiscover/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- service : activesync
time : 1569684212
ua : >-
Microsoft Office/16.0 (Windows NT 6.2; MAPICPL
16.0 .11328 ; Pro)
user : awesome@mailcow.de
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Autodiscover logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Autodiscover logs
summary : Get Autodiscover logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/dovecot/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- message : >-
managesieve-login : Disconnected (no auth attempts in 0
secs) : user=<>, rip=172.22.1.3, lip=172.22.1.250
priority : info
program : dovecot
2020-09-17 20:35:13 +02:00
time : "1569938740"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Dovecot logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Dovecot logs
summary : Get Dovecot logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/netfilter/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- message : "Whitelist was changed, it has 1 entries"
2020-06-07 20:46:17 +02:00
priority : info
time : 1569754911
- message : Add host/network 1.1.1.1/32 to blacklist
priority : crit
time : 1569754911
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Netfilter logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Netfilter logs
summary : Get Netfilter logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/postfix/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- message : "EF1711500458: removed"
2020-06-07 20:46:17 +02:00
priority : info
program : postfix/qmgr
2020-09-17 20:35:13 +02:00
time : "1569937433"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Postfix logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Postfix logs
summary : Get Postfix logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/ratelimited/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- from : awesome@mailcow.email
header_from : '"Awesome" <awesome@mailcow.email>'
header_subject : Mailcow is amazing
ip : 172.22 .1 .248
message_id : 6a-5d892500-7-240abd80@90879116
qid : E3CF91500458
rcpt : hello@mailcow.email
rl_hash : RLsdz3tuabozgd4oacbdh8kc78
rl_info : mailcow(RLsdz3tuabozgd4oacbdh8kc78)
rl_name : mailcow
time : 1569269003
user : awesome@mailcow.email
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Ratelimit logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Ratelimit logs
summary : Get Ratelimit logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/rspamd-history/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Rspamd logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Rspamd logs
summary : Get Rspamd logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/sogo/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- message : >-
[109] :
mailcowdockerized_watchdog-mailcow_1.mailcowdockerized_mailcow-network
"GET /SOGo.index/ HTTP/1.1" 200 2531 /0 0.005 - - 0
priority : notice
program : sogod
2020-09-17 20:35:13 +02:00
time : "1569938874"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all SOGo logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get SOGo logs
summary : Get SOGo logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/logs/watchdog/{count}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : Number of logs to return
in : path
name : count
required : true
schema :
type : number
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- hpdiff : "0"
hpnow : "1"
hptotal : "1"
lvl : "100"
2020-06-07 20:46:17 +02:00
service : Fail2ban
2020-09-17 20:35:13 +02:00
time : "1569938958"
- hpdiff : "0"
hpnow : "5"
hptotal : "5"
lvl : "100"
2020-06-07 20:46:17 +02:00
service : Rspamd
2020-09-17 20:35:13 +02:00
time : "1569938956"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Logs
description : >-
This Api endpoint lists all Watchdog logs.
Tip : You can limit how many logs you want to get by using `/<count>` at
the end of the api url.
operationId : Get Watchdog logs
summary : Get Watchdog logs
2020-09-17 20:35:13 +02:00
"/api/v1/get/mailbox/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
- user@domain.tld
type : string
2022-05-05 08:25:01 +02:00
- description : comma seperated list of tags to filter by
example : "tag1,tag2"
in : query
name : tags
required : false
2022-07-08 20:47:28 +02:00
schema :
type : string
2020-06-07 20:46:17 +02:00
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
attributes :
2020-09-17 20:35:13 +02:00
force_pw_update : "0"
mailbox_format : "maildir:"
2020-06-07 20:46:17 +02:00
quarantine_notification : never
2020-09-17 20:35:13 +02:00
sogo_access : "1"
tls_enforce_in : "0"
tls_enforce_out : "0"
2020-06-07 20:46:17 +02:00
domain : doman3.tld
is_relayed : 0
local_part : info
max_new_quota : 10737418240
messages : 0
name : Full name
percent_class : success
percent_in_use : 0
quota : 3221225472
quota_used : 0
rl : false
spam_aliases : 0
username : info@doman3.tld
2022-05-05 08:25:01 +02:00
tags : [ "tag1" , "tag2" ]
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Mailboxes
description : You can list all mailboxes existing in system.
operationId : Get mailboxes
summary : Get mailboxes
/api/v1/get/mailq/all :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- arrival_time : 1570091234
message_size : 1848
queue_id : B98C6260CA1
queue_name : incoming
recipients :
- recipient@awesomecow.tld
sender : sender@mailcow.tld
description : OK
headers : {}
tags :
- Queue Manager
description : Get the current mail queue and everything it contains.
operationId : Get Queue
summary : Get Queue
2020-09-17 20:35:13 +02:00
"/api/v1/get/oauth2-client/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- client_id : 17c76aaa88c0
client_secret : 73fc668a88147e32a31ff80c
grant_types : null
id : 1
2020-09-17 20:35:13 +02:00
redirect_uri : "https://mailcow.tld"
2020-06-07 20:46:17 +02:00
scope : profile
user_id : null
description : OK
headers : {}
tags :
- oAuth Clients
description : Using this endpoint you can get all oAuth clients.
operationId : Get oAuth Clients
summary : Get oAuth Clients
2020-09-17 20:35:13 +02:00
"/api/v1/get/policy_bl_domain/{domain}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : name of domain
in : path
name : domain
required : true
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- object : domain.tld
prefid : 2
2020-09-17 20:35:13 +02:00
value : "*@baddomain.tld"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domain antispam policies
description : You can list all blacklist policies per domain.
operationId : List blacklist domain policy
summary : List blacklist domain policy
2020-09-17 20:35:13 +02:00
"/api/v1/get/policy_wl_domain/{domain}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : name of domain
in : path
name : domain
required : true
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- object : domain.tld
prefid : 1
2020-09-17 20:35:13 +02:00
value : "*@gooddomain.tld"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Domain antispam policies
description : You can list all whitelist policies per domain.
operationId : List whitelist domain policy
summary : List whitelist domain policy
/api/v1/get/quarantine/all :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
created : 1572688831
id : 33
notified : 1
qid : 8224615004C1
rcpt : admin@domain.tld
score : 15.48
sender : bounces@send.domain.tld
subject : mailcow is awesome
virus_flag : 0
description : OK
headers : {}
tags :
- Quarantine
description : Get all mails that are currently in Quarantine.
operationId : Get mails in Quarantine
summary : Get mails in Quarantine
2020-09-17 20:35:13 +02:00
"/api/v1/get/recipient_map/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
created : "2019-10-02 22:06:29"
2020-06-07 20:46:17 +02:00
id : 3
modified : null
recipient_map_new : target@mailcow.tld
recipient_map_old : recipient@mailcow.tld
description : OK
headers : {}
tags :
- Address Rewriting
description : Using this endpoint you can get all recipient maps.
operationId : Get Recipient Map
summary : Get Recipient Map
2020-09-17 20:35:13 +02:00
"/api/v1/get/relayhost/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
hostname : "mailcow.tld:25"
2020-06-07 20:46:17 +02:00
id : 1
password : supersecurepassword
password_short : tes...
2020-09-17 20:35:13 +02:00
used_by_domains : ""
2020-06-07 20:46:17 +02:00
username : testuser
description : OK
headers : {}
tags :
- Routing
description : Using this endpoint you can get all Sender-Dependent Transports.
operationId : Get Sender-Dependent Transports
summary : Get Sender-Dependent Transports
/api/v1/get/resource/all :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
description : test
domain : mailcow.tld
kind : location
local_part : test
multiple_bookings : 0
name : test@mailcow.tld
description : OK
headers : {}
tags :
- Resources
description : Using this endpoint you can get all Resources.
operationId : Get Resources
summary : Get Resources
2020-09-17 20:35:13 +02:00
"/api/v1/get/rl-mbox/{mailbox}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : name of mailbox or all
in : path
name : mailbox
required : true
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- frame : s
mailbox : leon@mailcow.tld
2020-09-17 20:35:13 +02:00
value : "5"
2020-06-07 20:46:17 +02:00
- frame : s
mailbox : lisa@mailcow.tld
2020-09-17 20:35:13 +02:00
value : "3"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Ratelimits
description : >-
Using this endpoint you can get the ratelimits for a certain mailbox.
You can use all for all mailboxes.
operationId : Get mailbox ratelimits
summary : Get mailbox ratelimits
2020-09-17 20:35:13 +02:00
"/api/v1/get/rl-domain/{domain}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : name of domain or all
in : path
name : domain
required : true
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- frame : s
domain : domain.tld
2020-09-17 20:35:13 +02:00
value : "5"
2020-06-07 20:46:17 +02:00
- frame : s
mailbox : domain2.tld
2020-09-17 20:35:13 +02:00
value : "3"
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Ratelimits
description : >-
Using this endpoint you can get the ratelimits for a certain domains.
You can use all for all domain.
operationId : Get domain ratelimits
summary : Get domain ratelimits
/api/v1/edit/rl-mbox/ :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-06-12 07:26:48 +02:00
- type : success
log :
2020-09-17 20:35:13 +02:00
- ratelimit
- edit
- mailbox
- object :
- info@domain.tld
rl_value : "10"
rl_frame : h
2020-06-12 07:26:48 +02:00
msg :
2020-09-17 20:35:13 +02:00
- rl_saved
- info@domain.tld
2020-06-12 07:26:48 +02:00
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
2020-06-07 20:46:17 +02:00
description : OK
headers : {}
tags :
- Ratelimits
description : >-
Using this endpoint you can edit the ratelimits for a certain mailbox.
operationId : Edit mailbox ratelimits
requestBody :
content :
application/json :
schema :
example :
attr :
2022-02-01 15:26:48 +01:00
rl_value : "10"
2020-11-30 16:29:21 +01:00
rl_frame : "h"
items :
- info@domain.tld
2020-06-07 20:46:17 +02:00
properties :
attr :
properties :
rl_frame :
description : contains the frame for the ratelimit h,s,m
type : string
2022-02-01 15:26:48 +01:00
rl_value :
2020-06-07 20:46:17 +02:00
description : contains the rate for the ratelimit 10,20,50,1
type : number
type : object
items :
description : contains list of mailboxes you want to edit the ratelimit of
type : object
type : object
summary : Edit mailbox ratelimits
/api/v1/edit/rl-domain/ :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
- type : success
- log :
- ratelimit
- edit
- domain
2020-08-14 21:00:14 +02:00
- object :
2020-09-17 20:35:13 +02:00
- domain.tld
2020-06-12 07:26:48 +02:00
rl_value : "50"
rl_frame : "h"
2020-06-07 20:46:17 +02:00
msg :
- rl_saved
- domain.tld
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Ratelimits
description : >-
Using this endpoint you can edit the ratelimits for a certain domains.
operationId : Edit domain ratelimits
requestBody :
content :
application/json :
schema :
example :
attr :
2022-02-01 15:26:48 +01:00
rl_value : "10"
2020-11-30 16:29:21 +01:00
rl_frame : "h"
items :
- domain.tld
2020-06-07 20:46:17 +02:00
properties :
attr :
properties :
rl_frame :
description : contains the frame for the ratelimit h,s,m
type : string
2022-02-01 15:26:48 +01:00
rl_value :
2020-06-07 20:46:17 +02:00
description : contains the rate for the ratelimit 10,20,50,1
type : number
type : object
items :
description : contains list of domains you want to edit the ratelimit of
type : object
type : object
2020-08-14 21:00:14 +02:00
summary : Edit domain ratelimits
2020-06-07 20:46:17 +02:00
/api/v1/get/status/containers :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
acme-mailcow :
container : acme-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/acme:1.63"
started_at : "2019-12-22T21:00:08.270660275Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
clamd-mailcow :
container : clamd-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/clamd:1.35"
started_at : "2019-12-22T21:00:01.622856172Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
dockerapi-mailcow :
container : dockerapi-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/dockerapi:1.36"
started_at : "2019-12-22T20:59:59.984797808Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
dovecot-mailcow :
container : dovecot-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/dovecot:1.104"
started_at : "2019-12-22T21:00:08.988680259Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
ipv6nat-mailcow :
container : ipv6nat-mailcow
image : robbertkl/ipv6nat
2020-09-17 20:35:13 +02:00
started_at : "2019-12-22T21:06:37.273225445Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
memcached-mailcow :
container : memcached-mailcow
2020-09-17 20:35:13 +02:00
image : "memcached:alpine"
started_at : "2019-12-22T20:59:58.0907785Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
mysql-mailcow :
container : mysql-mailcow
2020-09-17 20:35:13 +02:00
image : "mariadb:10.3"
started_at : "2019-12-22T21:00:02.201937528Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
netfilter-mailcow :
container : netfilter-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/netfilter:1.31"
started_at : "2019-12-22T21:00:09.851559297Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
nginx-mailcow :
container : nginx-mailcow
2020-09-17 20:35:13 +02:00
image : "nginx:mainline-alpine"
started_at : "2019-12-22T21:00:12.9843038Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
olefy-mailcow :
container : olefy-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/olefy:1.2"
started_at : "2019-12-22T20:59:59.676259274Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
php-fpm-mailcow :
container : php-fpm-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/phpfpm:1.55"
started_at : "2019-12-22T21:00:00.955808957Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
postfix-mailcow :
container : postfix-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/postfix:1.44"
started_at : "2019-12-22T21:00:07.186717617Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
redis-mailcow :
container : redis-mailcow
2020-09-17 20:35:13 +02:00
image : "redis:5-alpine"
started_at : "2019-12-22T20:59:56.827166834Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
rspamd-mailcow :
container : rspamd-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/rspamd:1.56"
started_at : "2019-12-22T21:00:12.456075355Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
sogo-mailcow :
container : sogo-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/sogo:1.65"
started_at : "2019-12-22T20:59:58.382274592Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
solr-mailcow :
container : solr-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/solr:1.7"
started_at : "2019-12-22T20:59:59.635413798Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
unbound-mailcow :
container : unbound-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/unbound:1.10"
started_at : "2019-12-22T20:59:58.760595825Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
watchdog-mailcow :
container : watchdog-mailcow
2020-09-17 20:35:13 +02:00
image : "mailcow/watchdog:1.65"
started_at : "2019-12-22T20:59:56.028660382Z"
2020-06-07 20:46:17 +02:00
state : running
type : info
description : OK
headers : {}
tags :
- Status
description : >-
Using this endpoint you can get the status of all containers and when
hey where started and a few other details.
operationId : Get container status
summary : Get container status
/api/v1/get/status/solr :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
solr_documents : null
solr_enabled : false
solr_size : null
type : info
description : OK
headers : {}
tags :
- Status
description : >-
Using this endpoint you can get the status of all containers and when
hey where started and a few other details.
operationId : Get solr status
summary : Get solr status
/api/v1/get/status/vmail :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
disk : /dev/mapper/mail--vg-root
total : 41G
type : info
used : 11G
used_percent : 28 %
description : OK
headers : {}
tags :
- Status
description : >-
Using this endpoint you can get the status of the vmail and the amount
of used storage.
operationId : Get vmail status
summary : Get vmail status
2022-04-25 22:44:41 +02:00
/api/v1/get/status/version :
get :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
version : "2022-04"
description : OK
headers : {}
tags :
- Status
description : >-
Using this endpoint you can get the current running release of this
instance.
operationId : Get version status
summary : Get version status
2020-06-07 20:46:17 +02:00
/api/v1/get/syncjobs/all/no_log :
get :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
authmd51 : 0
authmech1 : PLAIN
automap : 1
2020-09-17 20:35:13 +02:00
created : "2019-05-22 11:37:25"
custom_params : ""
2020-06-07 20:46:17 +02:00
delete1 : 0
delete2 : 0
delete2duplicates : 1
2020-09-17 20:35:13 +02:00
domain2 : ""
2020-06-07 20:46:17 +02:00
enc1 : TLS
exclude : (?i)spam|(?i)junk
host1 : imap.server.tld
id : 1
is_running : 0
2020-09-17 20:35:13 +02:00
last_run : "2019-05-22 11:40:02"
log : ""
2020-06-07 20:46:17 +02:00
maxage : 0
2020-09-17 20:35:13 +02:00
maxbytespersecond : "0"
mins_interval : "20"
modified : "2019-05-22 11:40:02"
2020-06-07 20:46:17 +02:00
port1 : 993
2020-09-17 20:35:13 +02:00
regextrans2 : ""
2020-06-07 20:46:17 +02:00
skipcrossduplicates : 0
subfolder2 : External
subscribeall : 1
timeout1 : 600
timeout2 : 600
user1 : username
user2 : mailbox@domain.tld
description : OK
headers : {}
tags :
- Sync jobs
description : You can list all syn jobs existing in system.
operationId : Get sync jobs
summary : Get sync jobs
2020-09-17 20:35:13 +02:00
"/api/v1/get/tls-policy-map/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- parameters : ""
active : "1"
created : "2019-10-03 08:42:12"
2020-06-07 20:46:17 +02:00
dest : mailcow.tld
id : 1
modified : null
policy : encrypt
description : OK
headers : {}
tags :
- Outgoing TLS Policy Map Overrides
description : Using this endpoint you can get all TLS policy map override maps.
operationId : Get TLS Policy Map
summary : Get TLS Policy Map
2020-09-17 20:35:13 +02:00
"/api/v1/get/transport/{id}" :
2020-06-07 20:46:17 +02:00
get :
parameters :
- description : id of entry you want to get
example : all
in : path
name : id
required : true
schema :
enum :
- all
2020-09-17 20:35:13 +02:00
- "1"
- "2"
- "5"
- "10"
2020-06-07 20:46:17 +02:00
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-07 20:46:17 +02:00
content :
application/json :
examples :
response :
value :
2020-09-17 20:35:13 +02:00
- active : "1"
2020-06-07 20:46:17 +02:00
destination : example.org
id : 1
2020-09-17 20:59:27 +02:00
lookup_mx : "0"
2020-09-17 20:35:13 +02:00
nexthop : "host:25"
2020-06-07 20:46:17 +02:00
password : supersecurepw
password_short : sup...
username : testuser
description : OK
headers : {}
tags :
- Routing
description : Using this endpoint you can get all Transport Maps.
operationId : Get Transport Maps
summary : Get Transport Maps
2020-06-12 07:26:48 +02:00
/api/v1/edit/spam-score/ :
post :
responses :
2020-09-17 20:35:13 +02:00
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
2020-06-12 07:26:48 +02:00
content :
application/json :
examples :
response :
value :
- type : success
log :
2020-09-17 20:35:13 +02:00
- mailbox
- edit
- spam_score
- username :
- info@domain.tld
spam_score : "8,15"
2020-06-12 07:26:48 +02:00
msg :
2020-09-17 20:35:13 +02:00
- mailbox_modified
- info@domain.tld
2020-06-12 07:26:48 +02:00
schema :
properties :
log :
description : contains request object
items : {}
type : array
msg :
items : {}
type : array
type :
enum :
- success
- danger
- error
type : string
type : object
description : OK
headers : {}
tags :
- Mailboxes
description : >-
Using this endpoint you can edit the spam filter score for a certain mailbox.
operationId : Edit mailbox spam filter score
requestBody :
content :
application/json :
schema :
example :
- items :
2020-09-17 20:35:13 +02:00
- info@domain.tld
2020-06-12 07:26:48 +02:00
attr :
2020-09-17 20:35:13 +02:00
spam_score : "8,15"
2020-06-12 07:26:48 +02:00
summary : Edit mailbox spam filter score
2022-11-06 00:25:38 +01:00
"/api/v1/get/mailbox/all/{domain}" :
get :
parameters :
- description : name of domain
in : path
name : domain
required : false
schema :
type : string
- description : e.g. api-key-string
example : api-key-string
in : header
name : X-API-Key
required : false
schema :
type : string
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- active : "1"
attributes :
force_pw_update : "0"
mailbox_format : "maildir:"
quarantine_notification : never
sogo_access : "1"
tls_enforce_in : "0"
tls_enforce_out : "0"
domain : domain3.tld
is_relayed : 0
local_part : info
max_new_quota : 10737418240
messages : 0
name : Full name
percent_class : success
percent_in_use : 0
quota : 3221225472
quota_used : 0
rl : false
spam_aliases : 0
username : info@domain3.tld
tags : [ "tag1" , "tag2" ]
description : OK
headers : {}
tags :
- Mailboxes
description : You can list all mailboxes existing in system for a specific domain.
operationId : Get mailboxes of a domain
summary : Get mailboxes of a domain
2023-07-27 13:45:57 +02:00
/api/v1/edit/cors :
post :
responses :
"401" :
$ref : "#/components/responses/Unauthorized"
"200" :
content :
application/json :
examples :
response :
value :
- type : "success"
log : [ "cors", "edit", {"allowed_origins": ["*", "mail.mailcow.tld"], "allowed_methods": [ "POST" , "GET" , "DELETE" , "PUT" ] }]
msg : "cors_headers_edited"
description : OK
headers : { }
tags :
- Cross-Origin Resource Sharing (CORS)
description : >-
This endpoint allows you to manage Cross-Origin Resource Sharing (CORS) settings for the API.
CORS is a security feature implemented by web browsers to prevent unauthorized cross-origin requests.
By editing the CORS settings, you can specify which domains and which methods are permitted to access the API resources from outside the mailcow domain.
operationId : Edit Cross-Origin Resource Sharing (CORS) settings
requestBody :
content :
application/json :
schema :
example :
attr :
allowed_origins : [ "*" , "mail.mailcow.tld" ]
allowed_methods : [ "POST" , "GET" , "DELETE" , "PUT" ]
properties :
attr :
type : object
properties :
allowed_origins :
type : array
items :
type : string
allowed_methods :
type : array
items :
type : string
summary : Edit Cross-Origin Resource Sharing (CORS) settings
2020-06-07 20:46:17 +02:00
tags :
- name : Domains
description : You can create antispam whitelist and blacklist policies
- name : Domain antispam policies
description : You can edit the Domain Antispam policies
- name : Mailboxes
description : You can manage mailboxes
- name : Aliases
description : You can manage aliases
- name : Sync jobs
description : Using Syncjobs you can sync your mails with other email servers
- name : Fordwarding Hosts
description : Forwarding Hosts enable you to send mail using a relay
- name : Logs
2020-10-04 21:42:16 +02:00
description : Get all mailcow system logs
2020-06-07 20:46:17 +02:00
- name : Queue Manager
2020-10-04 21:42:16 +02:00
description : Manage the postfix mail queue
2020-06-07 20:46:17 +02:00
- name : Quarantine
description : Check what emails went to quarantine
- name : Fail2Ban
description : Manage the Netfilter fail2ban options
- name : DKIM
description : Manage DKIM keys
- name : Domain admin
description : Create or udpdate domain admin users
2023-01-06 19:25:23 +01:00
- name : Single Sign-On
description : Issue tokens for users
2020-06-07 20:46:17 +02:00
- name : Address Rewriting
2020-10-04 21:42:16 +02:00
description : Create BCC maps or recipient maps
2020-06-07 20:46:17 +02:00
- name : Outgoing TLS Policy Map Overrides
description : Force global TLS policys
- name : oAuth Clients
description : Use mailcow as a oAuth server
- name : Routing
description : Define your own email routes
- name : Resources
description : Manage ressources
- name : App Passwords
description : Create mailbox app passwords
- name : Status
description : Get the status of your cow
- name : Ratelimits
description : Edit domain ratelimits
2023-07-27 13:45:57 +02:00
- name : Cross-Origin Resource Sharing (CORS)
description : Manage Cross-Origin Resource Sharing (CORS) settings
