Revision control
Copy as Markdown
Other Tools
[
{
"namespace": "manifest",
"types": [
{
"$extend": "OptionalPermission",
"choices": [
{
"type": "string",
"enum": ["accountsIdentities"]
}
]
}
]
},
{
"namespace": "identities",
"permissions": ["accountsRead"],
"types": [
{
"id": "EncryptionCapabilities",
"type": "object",
"properties": {
"canEncrypt": {
"type": "boolean",
"description": "Whether the encryption technology is configured to support message encryption."
},
"canSign": {
"type": "boolean",
"description": "Whether the encryption technology is configured to support message signing."
}
}
},
{
"id": "MailIdentity",
"type": "object",
"properties": {
"accountId": {
"$ref": "accounts.MailAccountId",
"optional": true,
"description": "The id of the $(ref:accounts.MailAccount) this identity belongs to. The <var>accountId</var> property is read-only."
},
"composeHtml": {
"type": "boolean",
"optional": true,
"description": "If the identity uses HTML as the default compose format."
},
"email": {
"type": "string",
"optional": true,
"description": "The user's email address as used when messages are sent from this identity."
},
"id": {
"type": "string",
"optional": true,
"description": "A unique identifier for this identity. The <var>id</var> property is read-only."
},
"label": {
"type": "string",
"optional": true,
"description": "A user-defined label for this identity."
},
"name": {
"type": "string",
"optional": true,
"description": "The user's name as used when messages are sent from this identity."
},
"replyTo": {
"type": "string",
"optional": true,
"description": "The reply-to email address associated with this identity."
},
"organization": {
"type": "string",
"optional": true,
"description": "The organization associated with this identity."
},
"signature": {
"type": "string",
"optional": true,
"description": "The signature of the identity."
},
"signatureIsPlainText": {
"type": "boolean",
"optional": true,
"description": "If the signature should be interpreted as plain text or as HTML."
},
"encryptionCapabilities": {
"type": "object",
"optional": true,
"description": "The encryption capabilities of this identity. Read only.",
"properties": {
"OpenPGP": {
"$ref": "identities.EncryptionCapabilities",
"description": "The capabilities of this identity for the OpenPGP encryption technology."
},
"S/MIME": {
"$ref": "identities.EncryptionCapabilities",
"description": "The capabilities of this identity for the S/MIME encryption technology."
}
}
}
}
}
],
"functions": [
{
"name": "list",
"type": "function",
"description": "Returns the identities of the specified account, or all identities if no account is specified. Do not expect the returned identities to be in any specific order. Use $(ref:identities.getDefault) to get the default identity of an account.",
"async": "callback",
"parameters": [
{
"name": "accountId",
"$ref": "accounts.MailAccountId",
"optional": true
},
{
"type": "function",
"name": "callback",
"optional": true,
"parameters": [
{
"type": "array",
"items": {
"$ref": "identities.MailIdentity"
}
}
]
}
]
},
{
"name": "get",
"type": "function",
"description": "Returns details of the requested identity, or <var>null</var> if it doesn't exist.",
"async": "callback",
"parameters": [
{
"name": "identityId",
"type": "string"
},
{
"type": "function",
"name": "callback",
"optional": true,
"parameters": [
{
"choices": [
{
"$ref": "identities.MailIdentity"
},
{
"type": "null"
}
]
}
]
}
]
},
{
"name": "create",
"permissions": ["accountsIdentities"],
"type": "function",
"description": "Create a new identity in the specified account.",
"async": "callback",
"parameters": [
{
"name": "accountId",
"$ref": "accounts.MailAccountId"
},
{
"name": "details",
"$ref": "identities.MailIdentity"
},
{
"type": "function",
"name": "callback",
"optional": true,
"parameters": [
{
"$ref": "identities.MailIdentity"
}
]
}
]
},
{
"name": "delete",
"permissions": ["accountsIdentities"],
"type": "function",
"description": "Attempts to delete the requested identity. Default identities cannot be deleted.",
"async": true,
"parameters": [
{
"name": "identityId",
"type": "string"
}
]
},
{
"name": "update",
"permissions": ["accountsIdentities"],
"type": "function",
"description": "Updates the details of an identity.",
"async": "callback",
"parameters": [
{
"name": "identityId",
"type": "string"
},
{
"name": "details",
"$ref": "identities.MailIdentity"
},
{
"type": "function",
"name": "callback",
"optional": true,
"parameters": [
{
"$ref": "identities.MailIdentity"
}
]
}
]
},
{
"name": "getDefault",
"type": "function",
"description": "Returns the default identity for the requested account, or <var>null</var> if it is not defined.",
"async": "callback",
"parameters": [
{
"name": "accountId",
"$ref": "accounts.MailAccountId"
},
{
"type": "function",
"name": "callback",
"optional": true,
"parameters": [
{
"choices": [
{
"$ref": "identities.MailIdentity"
},
{
"type": "null"
}
]
}
]
}
]
},
{
"name": "setDefault",
"type": "function",
"description": "Sets the default identity for the requested account.",
"async": true,
"parameters": [
{
"name": "accountId",
"$ref": "accounts.MailAccountId"
},
{
"name": "identityId",
"type": "string"
}
]
}
],
"events": [
{
"name": "onCreated",
"type": "function",
"description": "Fired when a new identity has been created and added to an account. The event also fires for default identities that are created when a new account is added.",
"parameters": [
{
"name": "identityId",
"type": "string"
},
{
"name": "identity",
"$ref": "MailIdentity"
}
]
},
{
"name": "onDeleted",
"type": "function",
"description": "Fired when an identity has been removed from an account.",
"parameters": [
{
"name": "identityId",
"type": "string"
}
]
},
{
"name": "onUpdated",
"type": "function",
"description": "Fired when one or more properties of an identity have been modified. The returned $(ref:identities.MailIdentity) includes only the changed values.",
"parameters": [
{
"name": "identityId",
"type": "string"
},
{
"name": "changedValues",
"$ref": "MailIdentity"
}
]
}
]
}
]