List the mailbox's folders

GET/api/v1/mailbox/folders

Requires amailbox token— it acts as one mailbox holder, not as the organization.

Every folder with its message and unread counts plus IMAP's UIDNEXT and UIDVALIDITY. Polling those two is the webmail's delta check: unchanged tokens mean nothing arrived, moved or was deleted, for one request that transfers no messages.

Request

GET/api/v1/mailbox/folders

curl -X GET 'https://app.mailyte.com/api/v1/mailbox/folders' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

const response = await fetch('https://app.mailyte.com/api/v1/mailbox/folders', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer MAILBOX_TOKEN',
  },
});
const { data } = await response.json();

import requests
response = requests.get(
    "https://app.mailyte.com/api/v1/mailbox/folders",
    headers={"Authorization": "Bearer MAILBOX_TOKEN"},
)
data = response.json()["data"]

<?php

$response = Http::withToken('MAILBOX_TOKEN')
    ->get('https://app.mailyte.com/api/v1/mailbox/folders');

$data = $response->json('data');

require "net/http"
require "json"
uri = URI("https://app.mailyte.com/api/v1/mailbox/folders")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer MAILBOX_TOKEN"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

The key names its own organization, so no X-Organization-ID header is needed.

Response

Successful Response

Returned inside the standard envelope.

Errors

Every status, with what causes it and what to do, is on the error reference.