MayleeDevelopers
WebsiteSign up
Inbox filters

Update an inbox filter

PATCH/filters/{filterId}

Changes type and/or value. The resulting filter is validated as a whole, so a new type needs a compatible value.

Authorization

apiKey
AuthorizationBearer <token>

Send your key as Authorization: Bearer mk_…. Session cookies are never accepted on this surface.

In: header

Path Parameters

filterId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/filters/string" \  -H "Authorization: Bearer $MAYLEE_KEY" \  -H "Content-Type: application/json" \  -d '{    "value": "news.example.com"  }'
{  "filter": {    "createdAt": "2026-07-15T08:30:00.000Z",    "id": "cmfl1a2b3c4d5e6f7g8h9i0j",    "label": null,    "type": "domain",    "updatedAt": "2026-07-15T08:30:00.000Z",    "value": "newsletter.example.com"  }}

Create an inbox filter POST

Hides matching emails from the main inbox without moving them: they stay in INBOX, are listed by `GET /emails?filtered=only`, and remain visible in any view whose criteria match them. Addresses and domains are stored lowercase; a leading `@` on a domain is dropped. A `label` filter must reference a label of the workspace.

Delete an inbox filter DELETE

The emails it hid reappear in the main inbox immediately.