Tasks & Notes ============= .. py:function:: model.CreateTaskNote(ownerId, aboutPersonId, assigneeId, roleId, isNote, instructions, notes, dueDate, keywordIdList, sendEmails) :param int ownerId: PeopleId of the person who owns the Task. This is a required field. :param int aboutPersonId: PeopleId of the person the Task is about. This is a required field. :param int assigneeId: PeopleId of the person the Task is assigned to. This is an optional field. :param int roleId: RoleId of the Role you want to limit the Task or Note to. This is an optional field. :param str isNote: Boolean. This will either take a 1 or 0, depending on true or false, or a "True" or "False." This field is for telling the api how to save this Task or Note. :param str instructions: String, for a Task or Note. :param str notes: String, for a Task or Note. :param date dueDate: Due date for the Task. This is an optional field. :param list keywordIdList: List of the KeywordIds that you want to assign to the Task or Note. This is an optional field. These are the acceptable formats: [1,2,3,4,5] or (1,2,3,4,5) or {[1],[2],[3],[4],[5]} :param bool sendEmails: This optional field determines whether a notification email will be sent to the assignee. If omitted, the default is True (an email will be sent). A Task will be created for the minister (lay or staff person). This person must be a User, i.e. have an account to login with. The Task is a ministerial Task, presumably to contact the person the Task is about. By default, an email will be sent to the minister with a link to complete the Task with a Note record, but this email can be disabled by setting the sendEmails parameter to `False`. .. py:function:: model.GetExtraQuestions(taskNoteId) :param int taskNoteId: Required. The Task/Note ID. Get the extra questions for a given Task/Note. .. py:function:: model.GetExtraQuestionsByKeywords(keywords) :param list keywords: Required. List of keyword IDs. Get the extra questions for a given list of keywords. .. py:function:: model.GetExtraQuestionsWithAnswers(taskNoteId) :param int taskNoteId: Required. The Task/Note ID. Get the extra questions with answers for a given Task/Note. .. py:function:: model.GetTaskNote(taskNoteId) :param int taskNoteId: Required. The Task/Note ID. Get a specific Task/Note by ID. .. py:function:: model.GetTaskNoteKeywordIds(taskNoteId) :param int taskNoteId: Required. The Task/Note ID. To find this, use SQL or, if creating the Task/Note programmatically, retrieve it from the CreateTaskNote function. Get a list of KeywordIds for a given TaskNote. .. py:function:: model.GetTasksNotes(numOfTaskNotes, notesOnly, orgId, statuses, peopleId, filter) :param int numOfTaskNotes: Optional. The number of Task/Notes to return. :param bool notesOnly: Optional. If True, only Notes will be returned. :param int orgId: Optional. Return Task/Notes for a specific Organization. :param list statuses: Optional. Array of status IDs to filter by. :param int peopleId: Optional. Return Task/Notes for a specific person. :param str filter: Optional. Filter string to search for. Get Task/Notes based on the provided filters. .. py:function:: model.SetTaskNoteKeywordIds(taskNoteId, keywordIds) :param int taskNoteId: Required. The Task/Note ID. To find this, use SQL or, if creating the Task/Note programmatically, retrieve it from the CreateTaskNote function. :param int[] keywordIds: An array of keyword IDs that the Task/Note should have. Any other Keywords that the Task/Note already has will be removed. Updates the keywords for a given Task/Note to match the new list. Any other Keywords that the Task/Note already has will be removed. If you use Extra Values connected to these keywords, you may find that this function affects the User's view of Tasks/Notes in ways you may not want. .. py:function:: model.SetTaskNoteStatus(taskNoteId, status) :param int taskNoteId: Required. The Task/Note ID. To find this, use SQL or, if creating the Task/Note programmatically, retrieve it from the CreateTaskNote function. :param int|string status: The new status for the Task/Note. Can be 'Complete', 'Pending', 'Accepted', 'Declined', 'Archived', or 'Note'. Can also be the corresponding numerical IDs used in the database. Update the status of a Task. Also can be used to convert a Note to a Task or vice versa. This will NOT validate Extra Values or required content on the Task/Note. This does NOT send emails notifying anyone about the change. .. py:function:: model.TaskNoteAccept(taskNoteId) :param int taskNoteId: Required. The Task/Note ID. Accept a Task. .. py:function:: model.TaskNoteComplete(taskNoteId, note, extraQuestions) :param int taskNoteId: Required. The Task/Note ID. :param str note: The note to add to the Task. :param list extraQuestions: List of extra questions with answers. Complete a Task. .. py:function:: model.TaskNoteDecline(taskNoteId, reason) :param int taskNoteId: Required. The Task/Note ID. :param str reason: The reason for declining the Task. Decline a Task. .. py:function:: model.TaskNoteEdit(viewModel) :param object viewModel: The Task/Note view model with updated values. Edit a Task/Note. .. py:function:: model.TaskNoteMassAddKeywords(taskNoteIdList, keywordsArray) :param list taskNoteIdList: Required. List of Task/Note IDs. :param list keywordsArray: Required. List of keyword IDs to add. Mass add keywords to Tasks/Notes. .. py:function:: model.TaskNoteMassArchive(taskNoteIdList) :param list taskNoteIdList: Required. List of Task/Note IDs. Mass archive Tasks/Notes. .. py:function:: model.TaskNoteMassAssign(taskNoteIdList, assigneeId) :param list taskNoteIdList: Required. List of Task/Note IDs. :param int assigneeId: Required. PeopleId of the person to assign the Tasks to. Mass assign Tasks to a person. .. py:function:: model.TaskNoteMassComplete(taskNoteIdList, completionDate, note) :param list taskNoteIdList: Required. List of Task/Note IDs. :param date completionDate: Required. The date of completion. :param str note: Required. The note to add to the Tasks. Mass complete Tasks. .. py:function:: model.TaskNoteMassDelete(taskNoteIdList) :param list taskNoteIdList: Required. List of Task/Note IDs. Mass delete Tasks/Notes. .. py:function:: model.TaskNoteMassUnarchive(taskNoteIdList) :param list taskNoteIdList: Required. List of Task/Note IDs. Mass unarchive Tasks/Notes. +--------------------+------------------+ | **Latest Update** | **4/25/2025** | +--------------------+------------------+ Hid obselete function documentation.