Properties
| Name | Type | Description |
|---|---|---|
| id | string | Folder ID |
| path | string | Full folder path |
| name | string | Folder name (last part of path) |
| parent | stringnull | Parent folder path |
| uid_validity | integer | IMAP UID validity |
| uid_next | integer | Next UID value |
| modify_index | integer | Modification index |
| subscribed | boolean | Whether folder is subscribed |
| flags | array | Folder flags |
| retention | integernull | Message retention period |
| special_use | stringnull | Special use designation |
| created_at | string | |
| updated_at | string | |
| object | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/forward-email/json-schema/forward-email-folder-schema.json",
"title": "Folder",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/forward-email-folders-api-openapi.yml#/components/schemas/Folder",
"type": "object",
"required": [
"id",
"path",
"name",
"parent",
"uid_validity",
"uid_next",
"modify_index",
"subscribed",
"flags",
"retention",
"special_use",
"created_at",
"updated_at",
"object"
],
"properties": {
"id": {
"type": "string",
"description": "Folder ID"
},
"path": {
"type": "string",
"description": "Full folder path"
},
"name": {
"type": "string",
"description": "Folder name (last part of path)"
},
"parent": {
"type": [
"string",
"null"
],
"description": "Parent folder path"
},
"uid_validity": {
"type": "integer",
"description": "IMAP UID validity"
},
"uid_next": {
"type": "integer",
"description": "Next UID value"
},
"modify_index": {
"type": "integer",
"description": "Modification index"
},
"subscribed": {
"type": "boolean",
"description": "Whether folder is subscribed"
},
"flags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Folder flags"
},
"retention": {
"type": [
"integer",
"null"
],
"description": "Message retention period"
},
"special_use": {
"type": [
"string",
"null"
],
"description": "Special use designation"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"object": {
"type": "string",
"enum": [
"folder"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/forward-email-folder"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.