article_home_apply

# article_home_apply

Changes home editor in the Article app (pApp B00001, or an instance code of the same family). Another app code is refused before any request. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `action` | Yes | one of: `section-edit`, `section-visibility`, `banner-create`, `class-add`, `slide-edit`, `line-edit`, `banner-image`, `logo-clear`, `banner-class`, `slide-visibility`, `slide-duration-step`, `item-position`, `item-delete`, `restore-edit` (by `kind`) |
| `action.sectionId` | Yes | When `action.kind` is `section-edit`: integer; greater than 0 |
| `action.fields` | Yes | When `action.kind` is `section-edit`: object |
| `action.fields.title` | No | When `action.kind` is `section-edit`: string; max length 40 |
| `action.fields.layout` | No | When `action.kind` is `section-edit`: `3_GRID_HORIZONTAL`, `3_GRID_VERTICAL`, `4_GRID_HORIZONTAL`, `4_GRID_VERTICAL`, `5_GRID_HORIZONTAL`, `5_GRID_VERTICAL` |
| `action.sectionId` | Yes | When `action.kind` is `section-visibility`: integer; greater than 0 |
| `action.visible` | Yes | When `action.kind` is `section-visibility`: boolean |
| `action.sectionId` | Yes | When `action.kind` is `banner-create`: integer; greater than 0 |
| `action.itemType` | Yes | When `action.kind` is `banner-create`: `MAIN_BANNER_SLIDES`, `LINE_BANNER` |
| `action.bannerType` | Yes | When `action.kind` is `banner-create`: `SERIES`, `WEB_LINK` |
| `action.sectionId` | Yes | When `action.kind` is `class-add`: integer; greater than 0 |
| `action.seriesId` | Yes | When `action.kind` is `class-add`: integer; greater than 0 |
| `action.sectionId` | Yes | When `action.kind` is `slide-edit`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `slide-edit`: integer; greater than 0 |
| `action.fields` | Yes | When `action.kind` is `slide-edit`: object |
| `action.fields.title` | No | When `action.kind` is `slide-edit`: string; max length 30 |
| `action.fields.description` | No | When `action.kind` is `slide-edit`: string; max length 50 |
| `action.fields.webLink` | No | When `action.kind` is `slide-edit`: string; max length 4096 |
| `action.sectionId` | Yes | When `action.kind` is `line-edit`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `line-edit`: integer; greater than 0 |
| `action.fields` | Yes | When `action.kind` is `line-edit`: object |
| `action.fields.webLink` | No | When `action.kind` is `line-edit`: string; max length 4096 |
| `action.fields.backgroundColor` | No | When `action.kind` is `line-edit`: string; pattern `^#[0-9a-fA-F]{8}$` |
| `action.sectionId` | Yes | When `action.kind` is `banner-image`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `banner-image`: integer; greater than 0 |
| `action.field` | Yes | When `action.kind` is `banner-image`: `alternativeLogoSrc`, `backgroundDesktopImgSrc`, `backgroundMobileImgSrc`, `bannerImgSrc` |
| `action.imageTaskId` | Yes | When `action.kind` is `banner-image`: string; pattern `^[A-Za-z0-9_-]{8,80}$` |
| `action.sectionId` | Yes | When `action.kind` is `logo-clear`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `logo-clear`: integer; greater than 0 |
| `action.sectionId` | Yes | When `action.kind` is `banner-class`: integer; greater than 0 |
| `action.itemType` | Yes | When `action.kind` is `banner-class`: `MAIN_BANNER_SLIDES`, `LINE_BANNER` |
| `action.itemId` | Yes | When `action.kind` is `banner-class`: integer; greater than 0 |
| `action.seriesId` | Yes | When `action.kind` is `banner-class`: integer; greater than 0 |
| `action.sectionId` | Yes | When `action.kind` is `slide-visibility`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `slide-visibility`: integer; greater than 0 |
| `action.visible` | Yes | When `action.kind` is `slide-visibility`: boolean |
| `action.sectionId` | Yes | When `action.kind` is `slide-duration-step`: integer; greater than 0 |
| `action.itemId` | Yes | When `action.kind` is `slide-duration-step`: integer; greater than 0 |
| `action.seconds` | Yes | When `action.kind` is `slide-duration-step`: `5` or `10` or `15` or `30` |
| `action.sectionId` | Yes | When `action.kind` is `item-position`: integer; greater than 0 |
| `action.itemType` | Yes | When `action.kind` is `item-position`: `MAIN_BANNER_SLIDES`, `LINE_BANNER`, `SERIES_LIST` |
| `action.itemId` | Yes | When `action.kind` is `item-position`: integer; greater than 0 |
| `action.previousItemId` | Yes | When `action.kind` is `item-position`: integer; greater than 0 or null |
| `action.nextItemId` | Yes | When `action.kind` is `item-position`: integer; greater than 0 or null |
| `action.sectionId` | Yes | When `action.kind` is `item-delete`: integer; greater than 0 |
| `action.itemType` | Yes | When `action.kind` is `item-delete`: `MAIN_BANNER_SLIDES`, `LINE_BANNER`, `SERIES_LIST` |
| `action.itemId` | Yes | When `action.kind` is `item-delete`: integer; greater than 0 |
| `action.confirmation` | Yes | When `action.kind` is `item-delete`: `DELETE_HOME_ITEM` |
| `action.sectionId` | Yes | When `action.kind` is `restore-edit`: integer; greater than 0 |
| `action.sourceTaskId` | Yes | When `action.kind` is `restore-edit`: string; pattern `^[A-Za-z0-9_-]{8,80}$` |
| `instanceCode` | No | string; pattern `^B(?:000\|9[0-9]{2})01$`; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list. |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |