Content

Imports / List

Returns all email imports.

Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/imports

Method: GET

Authorisation: Minimum role: USER

Name	Type	Source
filter	DTO_standard_filter	Query

Request body example

Response status: 200 (OK)

Response type: DTO_import[]

Other response statuses: 400 (BadRequest), 403 (Forbidden)

Response body example

Name	Type	Description
sort_by_key	String	Sort by key
response_field_keys	String[]	Only return the fields specified
filters	String[]	Each string needs to be structured: filters=field_key:operator:value1\|value2\|value3 Only used to store filters for passing along as querystring
include_aggregations	Boolean	Include aggregations
include_imported	Boolean	Include imported
search	String	Search
sort_order	ENUM sort_order	Sort order
take	Int32	Take
page	Int32	Page

Name	Type	ReadOnly	Description
created_by	DTO_reference_user	ReadOnly	Created by
last_updated_by	DTO_reference_user	ReadOnly	Last updated by
group	DTO_reference		Group
email	DTO_import_email		Email
data_dump	DTO_import_data_dump		Data dump
id	Int32	ReadOnly	Leave empty on input
friendly_name	String		Friendly name
created	DateTime	ReadOnly	Created
last_updated	DateTime	ReadOnly	Last updated
type	ENUM import_type		Type

Name	Type	ReadOnly	Description
profile_pic	String	ReadOnly	Profile pic
email	String	ReadOnly	Email
id	Int32		Id
label	Object	ReadOnly	Label

Name	Type	ReadOnly	Description
id	Int32		The id of the reference
label	Object	ReadOnly	Name/Label from referenced object.

Name	Type	ReadOnly	Description
imap	DTO_external_auth_imap		Imap
oauth2	DTO_external_auth_oauth2		Oauth2
mailbox	String		Leave empty for current user
mailbox_folder_name	String		Mailbox folder name
total_message_count	Int32	ReadOnly	Total message count
retrieved_count	Int32	ReadOnly	Retrieved count
status	ENUM import_email_status	ReadOnly	Status

Name	Type	Description
hostname	String	Hostname
port	Int32	Port
username	String	Username
password	String	Password

Name	Type	ReadOnly	Description
identifier	String		Identifier
authorized_account	String	ReadOnly	Authorized account

Name	Type	ReadOnly	Description
total_count	Int32		Total count
provider	ENUM import_data_dump_provider		Provider

Value	Name	Description
0	ASC	ASC
1	DESC	DESC

PUT Imports / Update

GET Imports / Get one