> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft To Do

> Microsoft To Do is a cloud-based task management application that lets users create, organize, and track task lists, tasks, checklist items, and reminders across devices via Microsoft Graph

![Microsoft To Do logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/microsoft_todo.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=41451ffaa6fb908191fffbab6ffb305d)

* **Category:** task management
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 25
* **Triggers:** 0
* **Slug:** `MICROSOFT_TODO`
* **Version:** 20261101\_00

## Tools

> [accordion] Complete Task
>
> **Slug:** `MICROSOFT_TODO_COMPLETE_TASK`
>
> Mark a Microsoft To Do task as completed. Convenience wrapper that always PATCHes status='completed'; the server auto-sets completedDateTime. Use Update Task to reopen a task (status='notStarted') or to change other fields.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list that contains the task.
>
> **task\_id** `string` *required*
>
> Id of the task to mark as completed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Checklist Item
>
> **Slug:** `MICROSOFT_TODO_CREATE_CHECKLIST_ITEM`
>
> Add a checklist item (subtask) to a Microsoft To Do task in a specified task list. The created item is returned with its ID, display name, checked state, and creation time.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task (path param todoTaskListId).
>
> **task\_id** `string` *required*
>
> Id of the task to add the subtask to (path param taskId).
>
> **is\_checked** `boolean`
>
> Whether the item starts checked (completed). Defaults server-side to false.
>
> **display\_name** `string` *required*
>
> Text of the checklist item / subtask. Required — maps to the 'displayName' body field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Linked Resource
>
> **Slug:** `MICROSOFT_TODO_CREATE_LINKED_RESOURCE`
>
> Attach a partner-application link to an existing Microsoft To Do task.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task to attach the linked resource to.
>
> **web\_url** `string` *required*
>
> Deep link to the item in the source application.
>
> **external\_id** `string` *required*
>
> Id of the item in the source application.
>
> **display\_name** `string` *required*
>
> Title of the linked item.
>
> **application\_name** `string` *required*
>
> Name of the source application.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `MICROSOFT_TODO_CREATE_TASK`
>
> Create a task in a Microsoft To Do task list. Only title is required. Dates are passed as flat ISO-8601 strings plus a shared timezone; the tool builds the Graph dateTimeTimeZone objects. Notes are passed as body\_content (+ body\_content\_type). NOTE: To Do treats due dates as whole days — the time component of due\_date\_time is normalized to midnight on save.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Task title. Required — omitting it returns HTTP 400 'The property title is required'.
>
> **status** `string ("notStarted" | "inProgress" | "completed" | "waitingOnOthers" | "deferred")`
>
> Task status: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', or 'deferred'. Defaults server-side to 'notStarted'.
>
> **list\_id** `string` *required*
>
> Id of the task list to create the task in (path param todoTaskListId).
>
> **time\_zone** `string`
>
> IANA/Windows timezone name applied to due\_date\_time, start\_date\_time, and reminder\_date\_time (e.g. 'UTC', 'Pacific Standard Time'). Graph may normalize the returned dateTimeTimeZone to UTC rather than preserve this name.
>
> **categories** `array`
>
> List of category name strings to tag the task with.
>
> **importance** `string ("low" | "normal" | "high")`
>
> Task importance: 'low', 'normal', or 'high'. Defaults server-side to 'normal'.
>
> **body\_content** `string`
>
> Free-text notes/description for the task (maps to body.content).
>
> **due\_date\_time** `string`
>
> Due date as an ISO-8601 local datetime, e.g. '2026-07-10T00:00:00'. Combined with time\_zone into the Graph dueDateTime object. NOTE: To Do treats due dates as whole days — the time component is normalized to midnight on save (e.g. 17:00 becomes 00:00).
>
> **is\_reminder\_on** `boolean`
>
> Whether a reminder is active. A provided reminder\_date\_time always activates it.
>
> **start\_date\_time** `string`
>
> Start date as an ISO-8601 local datetime; combined with time\_zone into the Graph startDateTime object.
>
> **body\_content\_type** `string ("text" | "html")`
>
> Content type of body\_content: 'text' or 'html' (maps to body.contentType). Only used when body\_content is set. Microsoft To Do may normalize stored HTML to plain text and strip markup.
>
> **reminder\_date\_time** `string`
>
> Reminder date/time as an ISO-8601 local datetime; combined with time\_zone into the Graph reminderDateTime object. Providing this always activates the reminder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task List
>
> **Slug:** `MICROSOFT_TODO_CREATE_TASK_LIST`
>
> Create a new Microsoft To Do task list.
>
> #### Input Parameters
>
> **display\_name** `string` *required*
>
> Name of the new task list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Checklist Item
>
> **Slug:** `MICROSOFT_TODO_DELETE_CHECKLIST_ITEM`
>
> Delete a checklist item (subtask) from a Microsoft To Do task. This permanently removes the checklist item (this cannot be undone).
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list that contains the task.
>
> **task\_id** `string` *required*
>
> Id of the task that contains the checklist item.
>
> **checklist\_item\_id** `string` *required*
>
> Id (GUID) of the checklist item (subtask) to delete. This cannot be undone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task
>
> **Slug:** `MICROSOFT_TODO_DELETE_TASK`
>
> Delete a task from a Microsoft To Do task list. WARNING: this also permanently removes the task's checklist items and linked resources.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list that contains the task to delete.
>
> **task\_id** `string` *required*
>
> Id of the task to delete. Deleting a task permanently removes its checklist items and linked resources (this cannot be undone).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task Attachment
>
> **Slug:** `MICROSOFT_TODO_DELETE_TASK_ATTACHMENT`
>
> Permanently delete a file attachment from a Microsoft To Do task. This cannot be undone.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task containing the attachment.
>
> **attachment\_id** `string` *required*
>
> Id of the file attachment to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task List
>
> **Slug:** `MICROSOFT_TODO_DELETE_TASK_LIST`
>
> Delete a Microsoft To Do task list. WARNING: this cascades — all tasks in the list and their checklist items are permanently deleted.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list to delete. Deleting a list permanently removes all of its tasks and their checklist items (this cascade cannot be undone).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Task Attachment
>
> **Slug:** `MICROSOFT_TODO_DOWNLOAD_TASK_ATTACHMENT`
>
> Download one file attached to a Microsoft To Do task. The file is offloaded to storage and returned as a downloadable reference rather than inline base64.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task containing the attachment.
>
> **attachment\_id** `string` *required*
>
> Id of the file attachment to download.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Checklist Item
>
> **Slug:** `MICROSOFT_TODO_GET_CHECKLIST_ITEM`
>
> Get a single Microsoft To Do checklist item (subtask) by its id, within a task in a task list.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the To Do task list that contains the task (path param todoTaskListId). This is the long URL-safe id returned by the list/create task-list actions, not the display name.
>
> **task\_id** `string` *required*
>
> Id of the task that owns the checklist item (path param taskId). This is the long URL-safe id returned by the list/create task actions.
>
> **checklist\_item\_id** `string` *required*
>
> Id (GUID) of the checklist item to fetch (path param checklistItemId). This is the GUID returned by the list/create checklist-item actions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User
>
> **Slug:** `MICROSOFT_TODO_GET_CURRENT_USER`
>
> Return the profile of the Microsoft account connected to this toolkit (whoami / connection verification). Useful to confirm which mailbox the To Do tasks belong to before other operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task
>
> **Slug:** `MICROSOFT_TODO_GET_TASK`
>
> Get a single Microsoft To Do task by its id, within a task list. Set include\_checklist\_items=true to expand its checklist items inline.
>
> #### Input Parameters
>
> **expand** `string`
>
> Advanced OData \$expand expression. Normally leave unset and use include\_checklist\_items instead.
>
> **list\_id** `string` *required*
>
> Id of the To Do task list that contains the task (path param todoTaskListId). This is the long URL-safe id returned by the list/create task-list actions, not the display name.
>
> **task\_id** `string` *required*
>
> Id of the task to fetch (path param taskId). This is the long URL-safe id returned by the list/create task actions.
>
> **include\_checklist\_items** `boolean`
>
> When true, request the task's checklist items (subtasks) inline. When false, the tool does not send a \$expand query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Attachment
>
> **Slug:** `MICROSOFT_TODO_GET_TASK_ATTACHMENT`
>
> Get metadata for one file attached to a Microsoft To Do task. Use Download Task Attachment to retrieve the file contents.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task containing the attachment.
>
> **attachment\_id** `string` *required*
>
> Id of the file attachment to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task List
>
> **Slug:** `MICROSOFT_TODO_GET_TASK_LIST`
>
> Get a single Microsoft To Do task list by its id.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the To Do task list to fetch. This is the long URL-safe id returned by the list/create task-list actions (e.g. the `id` field), not the display name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Checklist Items
>
> **Slug:** `MICROSOFT_TODO_LIST_CHECKLIST_ITEMS`
>
> List the checklist items (subtasks) of a To Do task. Auto-paginates so all subtasks are returned at once as \{items: \[...]}.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list that owns the task (path param todoTaskListId). Get one from MICROSOFT\_TODO\_LIST\_TASK\_LISTS.
>
> **task\_id** `string` *required*
>
> Id of the task whose checklist items (subtasks) to return (path param taskId). Get one from MICROSOFT\_TODO\_LIST\_TASKS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Linked Resources
>
> **Slug:** `MICROSOFT_TODO_LIST_LINKED_RESOURCES`
>
> List external resources linked to a Microsoft To Do task. Auto-paginates the task's small linked-resource collection and returns all items at once.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task whose linked resources to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Attachments
>
> **Slug:** `MICROSOFT_TODO_LIST_TASK_ATTACHMENTS`
>
> List the files attached to a Microsoft To Do task. Returns attachment metadata without file contents, one page at a time, plus a next\_cursor.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Pagination token from a previous call's next\_cursor. Omit for the first page; pass it back unchanged to fetch the next page.
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task whose file attachments to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Lists
>
> **Slug:** `MICROSOFT_TODO_LIST_TASK_LISTS`
>
> List the connected user's To Do task lists, one page at a time. Identify the built-in default list by ID or wellknown\_list\_name='defaultList' rather than its localized display name; user-created lists have wellknown\_list\_name='none'.
>
> #### Input Parameters
>
> **top** `integer`
>
> Max task lists to return per page (maps to OData \$top). The server may cap this. If omitted the server uses its default page size.
>
> **cursor** `string`
>
> Pagination token from a previous call's next\_cursor. Omit for the first page; pass it back to fetch the next page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tasks
>
> **Slug:** `MICROSOFT_TODO_LIST_TASKS`
>
> List the tasks in a To Do task list. Checklist items (subtasks) are NOT returned by default; set include\_checklist\_items=true to expand them inline. Returns one page of tasks plus a next\_cursor for the next page.
>
> #### Input Parameters
>
> **top** `integer`
>
> Max tasks to return per page (maps to OData \$top). The server may cap this. If omitted the server uses its default page size.
>
> **cursor** `string`
>
> Pagination token from a previous call's next\_cursor. Omit for the first page; pass it back to fetch the next page.
>
> **expand** `string`
>
> Advanced OData \$expand expression. Normally leave unset and use include\_checklist\_items instead; that derives \$expand=checklistItems.
>
> **filter** `string`
>
> Optional OData \$filter expression, e.g. "status eq 'notStarted'" or "importance eq 'high'". Advanced; omit to return all tasks.
>
> **list\_id** `string` *required*
>
> Id of the task list whose tasks to return (path param todoTaskListId). Get one from MICROSOFT\_TODO\_LIST\_TASK\_LISTS.
>
> **include\_checklist\_items** `boolean`
>
> When true, expand each task's checklist items (subtasks) inline (maps to OData \$expand=checklistItems). Default false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sync Task Lists
>
> **Slug:** `MICROSOFT_TODO_SYNC_TASK_LISTS`
>
> Read one page of Microsoft To Do task-list changes. Continue the current round with next\_cursor, or store the terminal delta\_token to retrieve only changes from a later round. Removed task lists retain their removal marker.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque continuation cursor returned by the previous page in the current synchronization round. Pass it back unchanged.
>
> **select** `string`
>
> Comma-separated OData fields to select on the initial request. This selection is retained by continuation cursors.
>
> **delta\_token** `string`
>
> Checkpoint returned after an earlier synchronization round completed. Omit when starting the first round.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Checklist Item
>
> **Slug:** `MICROSOFT_TODO_UPDATE_CHECKLIST_ITEM`
>
> Update a checklist item (subtask) of a Microsoft To Do task: rename it (display\_name) and/or check/uncheck it (is\_checked). Partial update: only the fields you pass are changed; at least one is required. Setting is\_checked=true marks the subtask done.
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task that owns the checklist item.
>
> **is\_checked** `boolean`
>
> Set true to check off the subtask (mark it done), false to uncheck it. Checking auto-populates checkedDateTime server-side.
>
> **display\_name** `string`
>
> New text for the checklist item (maps to displayName). Replaces the existing text when provided.
>
> **checklist\_item\_id** `string` *required*
>
> Id (GUID) of the checklist item (subtask) to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `MICROSOFT_TODO_UPDATE_TASK`
>
> Update fields of an existing Microsoft To Do task, including title, notes, importance, status, dates, and categories; set status to completed to mark it done. Unspecified fields are omitted, except that providing a reminder date also enables the reminder.
>
> #### Input Parameters
>
> **title** `string`
>
> New task title.
>
> **status** `string ("notStarted" | "inProgress" | "completed" | "waitingOnOthers" | "deferred")`
>
> Task status: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', or 'deferred'. Setting 'completed' auto-populates completedDateTime server-side.
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task to update.
>
> **task\_id** `string` *required*
>
> Id of the task to update.
>
> **time\_zone** `string`
>
> IANA/Windows timezone name applied to any of the date fields provided (due\_date\_time, start\_date\_time, reminder\_date\_time). Defaults to 'UTC'. Graph may normalize returned dateTimeTimeZone values to UTC rather than preserve this name.
>
> **categories** `array`
>
> Replacement list of category name strings to tag the task with.
>
> **importance** `string ("low" | "normal" | "high")`
>
> Task importance: 'low', 'normal', or 'high'.
>
> **body\_content** `string`
>
> New notes/description for the task (maps to body.content). Replaces the existing notes when provided.
>
> **due\_date\_time** `string`
>
> New due date as an ISO-8601 local datetime (e.g. '2026-07-10T00:00:00'). Combined with time\_zone into the Graph dueDateTime object. Note: To Do treats due dates as whole days, so the time component is normalized to midnight on save. Pass null to clear it.
>
> **is\_reminder\_on** `boolean`
>
> Whether a reminder is active. A provided reminder\_date\_time always activates it.
>
> **start\_date\_time** `string`
>
> New start date as an ISO-8601 local datetime; combined with time\_zone into the startDateTime object. Pass null to clear it.
>
> **body\_content\_type** `string ("text" | "html")`
>
> Content type of body\_content: 'text' or 'html' (maps to body.contentType). Only used when body\_content is provided; defaults to 'text'. Microsoft To Do may normalize stored HTML to plain text and strip markup.
>
> **reminder\_date\_time** `string`
>
> New reminder date/time as an ISO-8601 local datetime; combined with time\_zone into the reminderDateTime object. Providing this always activates the reminder. Pass null to clear it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task List
>
> **Slug:** `MICROSOFT_TODO_UPDATE_TASK_LIST`
>
> Rename a Microsoft To Do task list (updates its displayName).
>
> #### Input Parameters
>
> **list\_id** `string` *required*
>
> Id of the task list to update.
>
> **display\_name** `string` *required*
>
> New name for the task list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Task Attachment
>
> **Slug:** `MICROSOFT_TODO_UPLOAD_TASK_ATTACHMENT`
>
> Attach a file up to 25 MB to a Microsoft To Do task. The tool automatically uses a single request for files under 3 MB and a chunked upload session for larger files.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> File to attach. Files under 3 MB use a single request; larger files up to 25 MB use a chunked upload session automatically.
>
> **list\_id** `string` *required*
>
> Id of the task list containing the task.
>
> **task\_id** `string` *required*
>
> Id of the task that should receive the file attachment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
