Update folder settings for an owned IMAP mailbox

PATCH /api/v1/accounts/{accountId}/imap/folders

Reference for PATCH /api/v1/accounts/{accountId}/imap/folders.

Authentication

Pass a Fluxmail member session as a bearer token. API keys cannot use this endpoint.

Request

curl 'http://localhost:8977/api/v1/accounts/acct_123/imap/folders' \
  -X PATCH \
  -H "Authorization: Bearer $FLUXMAIL_SESSION" \
  -H "Content-Type: application/json" \
  --data '{}'

Parameters

Name	Location	Required	Type	Details
`accountId`	path	Yes	`string`	Minimum length: 1.

Request body

Content type: application/json

{
  "type": "object",
  "properties": {
    "sent": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 1024
    },
    "drafts": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 1024
    },
    "trash": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 1024
    },
    "archive": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 1024
    },
    "spam": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 1024
    }
  },
  "additionalProperties": false
}

Responses

Status	Description	Content type
`200`	Success	`application/json`
`400`	Invalid request	`application/json`
`401`	Authentication required	`application/json`
`403`	Permission denied	`application/json`
`404`	Not found	`application/json`
`409`	Conflict	`application/json`
`413`	Request body too large	`application/json`
`422`	Unsupported capability	`application/json`
`429`	Too many attempts	`application/json`
`503`	Provider unavailable	`application/json`

200 response

{
  "type": "object",
  "properties": {
    "data": {
      "nullable": true
    }
  }
}