Summary
Insert a new table-of-authorities block at a target location.- Operation ID:
authorities.insert - API member path:
editor.doc.authorities.insert(...) - Mutates document:
yes - Idempotency:
non-idempotent - Supports tracked mode:
no - Supports dry run:
yes - Deterministic target resolution:
yes
Expected result
Returns an AuthoritiesMutationResult indicating success with the TOA address or a failure.Input fields
| Field | Type | Required | Description |
|---|---|---|---|
at | object(kind=“documentStart”) | object(kind=“documentEnd”) | object(kind=“before”) | object(kind=“after”) | yes | One of: object(kind=“documentStart”), object(kind=“documentEnd”), object(kind=“before”), object(kind=“after”) |
config | object | no | |
config.category | integer | no | |
config.entryPageSeparator | string | no | |
config.includeHeadings | boolean | no | |
config.pageRangeSeparator | string | no | |
config.tabLeader | string | no | |
config.usePassim | boolean | no |
Example request
{
"at": {
"kind": "documentStart"
},
"config": {
"category": 1,
"entryPageSeparator": "example"
}
}
Output fields
Variant 1 (success=true)
| Field | Type | Required | Description |
|---|---|---|---|
authorities | object(kind=“block”) | yes | |
authorities.kind | "block" | yes | Constant: "block" |
authorities.nodeId | string | yes | |
authorities.nodeType | "tableOfAuthorities" | yes | Constant: "tableOfAuthorities" |
success | true | yes | Constant: true |
Variant 2 (success=false)
| Field | Type | Required | Description |
|---|---|---|---|
failure | object | yes | |
failure.code | string | yes | |
failure.details | any | no | |
failure.message | string | yes | |
success | false | yes | Constant: false |
Example response
{
"authorities": {
"kind": "block",
"nodeId": "node-def456",
"nodeType": "tableOfAuthorities"
},
"success": true
}
Pre-apply throws
TARGET_NOT_FOUNDINVALID_TARGETINVALID_INPUTCAPABILITY_UNAVAILABLE
Non-applied failure codes
- None
Raw schemas
Raw input schema
Raw input schema
{
"additionalProperties": false,
"properties": {
"at": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "documentStart"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "documentEnd"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "before"
},
"target": {
"$ref": "#/$defs/BlockNodeAddress"
}
},
"required": [
"kind",
"target"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "after"
},
"target": {
"$ref": "#/$defs/BlockNodeAddress"
}
},
"required": [
"kind",
"target"
],
"type": "object"
}
]
},
"config": {
"additionalProperties": false,
"properties": {
"category": {
"type": "integer"
},
"entryPageSeparator": {
"type": "string"
},
"includeHeadings": {
"type": "boolean"
},
"pageRangeSeparator": {
"type": "string"
},
"tabLeader": {
"type": "string"
},
"usePassim": {
"type": "boolean"
}
},
"type": "object"
}
},
"required": [
"at"
],
"type": "object"
}
Raw output schema
Raw output schema
{
"oneOf": [
{
"additionalProperties": false,
"properties": {
"authorities": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "block"
},
"nodeId": {
"type": "string"
},
"nodeType": {
"const": "tableOfAuthorities"
}
},
"required": [
"kind",
"nodeType",
"nodeId"
],
"type": "object"
},
"success": {
"const": true
}
},
"required": [
"success",
"authorities"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"failure": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"success": {
"const": false
}
},
"required": [
"success",
"failure"
],
"type": "object"
}
]
}
Raw success schema
Raw success schema
{
"additionalProperties": false,
"properties": {
"authorities": {
"additionalProperties": false,
"properties": {
"kind": {
"const": "block"
},
"nodeId": {
"type": "string"
},
"nodeType": {
"const": "tableOfAuthorities"
}
},
"required": [
"kind",
"nodeType",
"nodeId"
],
"type": "object"
},
"success": {
"const": true
}
},
"required": [
"success",
"authorities"
],
"type": "object"
}
Raw failure schema
Raw failure schema
{
"additionalProperties": false,
"properties": {
"failure": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"success": {
"const": false
}
},
"required": [
"success",
"failure"
],
"type": "object"
}