ReceivedDetail

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cherami-to/json-schema/cherami-to-received-detail-schema.json",
  "title": "ReceivedDetail",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cherami-to-openapi.yml#/components/schemas/ReceivedDetail",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Cherami resource ID."
        },
        "inbox_id": {
          "type": "string",
          "description": "Cherami resource ID."
        },
        "thread_id": {
          "anyOf": [
            {
              "type": "string",
              "description": "Cherami resource ID."
            },
            {
              "type": "null"
            }
          ]
        },
        "envelope_from": {
          "type": "string"
        },
        "envelope_to": {
          "type": "string"
        },
        "subject": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "received_at": {
          "type": "string",
          "description": "UTC timestamp with milliseconds.",
          "format": "date-time",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
        },
        "processing_status": {
          "const": "ready"
        },
        "labels": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "message_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The message's Message-ID header, not a Cherami ID: reply and forward take id."
        },
        "raw_size": {
          "type": "integer",
          "minimum": 0
        },
        "processed_at": {
          "anyOf": [
            {
              "type": "string",
              "description": "UTC timestamp with milliseconds.",
              "format": "date-time",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
            },
            {
              "type": "null"
            }
          ]
        },
        "content": {
          "$ref": "#/$defs/ReceivedContent"
        }
      },
      "required": [
        "id",
        "inbox_id",
        "thread_id",
        "envelope_from",
        "envelope_to",
        "subject",
        "received_at",
        "processing_status",
        "labels",
        "message_id",
        "raw_size",
        "processed_at",
        "content"
      ]
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Cherami resource ID."
        },
        "inbox_id": {
          "type": "string",
          "description": "Cherami resource ID."
        },
        "thread_id": {
          "anyOf": [
            {
              "type": "string",
              "description": "Cherami resource ID."
            },
            {
              "type": "null"
            }
          ]
        },
        "envelope_from": {
          "type": "string"
        },
        "envelope_to": {
          "type": "string"
        },
        "subject": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "received_at": {
          "type": "string",
          "description": "UTC timestamp with milliseconds.",
          "format": "date-time",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
        },
        "processing_status": {
          "type": "string",
          "enum": [
            "pending",
            "processing",
            "failed"
          ]
        },
        "labels": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "message_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The message's Message-ID header, not a Cherami ID: reply and forward take id."
        },
        "raw_size": {
          "type": "integer",
          "minimum": 0
        },
        "processed_at": {
          "anyOf": [
            {
              "type": "string",
              "description": "UTC timestamp with milliseconds.",
              "format": "date-time",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "inbox_id",
        "thread_id",
        "envelope_from",
        "envelope_to",
        "subject",
        "received_at",
        "processing_status",
        "labels",
        "message_id",
        "raw_size",
        "processed_at"
      ]
    }
  ],
  "$defs": {
    "ParsedAddress": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "address": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "address"
          ]
        },
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "group": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "address": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "address"
                ]
              }
            }
          },
          "required": [
            "name",
            "group"
          ]
        }
      ],
      "description": "Mailbox or group from the message headers, written by the sender and not verified."
    },
    "ReceivedAttachment": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "filename": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "size": {
          "type": "integer",
          "minimum": 0
        },
        "mime_type": {
          "type": "string"
        },
        "disposition": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "content_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "related": {
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "filename",
        "size",
        "mime_type",
        "disposition",
        "content_id",
        "related"
      ]
    },
    "ReceivedContent": {
      "type": "object",
      "properties": {
        "from": {
          "anyOf": [
            {
              "$ref": "#/$defs/ParsedAddress"
            },
            {
              "type": "null"
            }
          ]
        },
        "sender": {
          "anyOf": [
            {
              "$ref": "#/$defs/ParsedAddress"
            },
            {
              "type": "null"
            }
          ]
        },
        "reply_to": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ParsedAddress"
          }
        },
        "to": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ParsedAddress"
          }
        },
        "cc": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ParsedAddress"
          }
        },
        "bcc": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ParsedAddress"
          }
        },
        "subject": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "message_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Message-ID header as the sender wrote it."
        },
        "in_reply_to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "references": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The sender's Date header: ISO when it parses, otherwise as written. Use received_at for ordering."
        },
        "reply_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "New text without quoted history. Empty: there is none. Null: it couldn't be extracted."
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "html": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "attachments": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ReceivedAttachment"
          }
        }
      },
      "required": [
        "from",
        "sender",
        "reply_to",
        "to",
        "cc",
        "bcc",
        "subject",
        "message_id",
        "in_reply_to",
        "references",
        "date",
        "reply_text",
        "text",
        "html",
        "attachments"
      ]
    }
  }
}