> For the complete documentation index, see [llms.txt](https://help.novacuraflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novacuraflow.com/6.12/development/flow-studio/connectors/business-systems/microsoft-sharepoint-2013/generic-operations/tasks/task-information.md).

# Task information

### Get task information by ID

Get information such as start date, due date etc about a task.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter     | Description                             |
| ------------- | --------------------------------------- |
| Task app name | Name of Task app in SharePoint (not id) |
| Task ID       | ID of task                              |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Record variable containing the results of operation                    |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |
| 1000004    | Item with given id does not exist.           |

### Get task information by name <a href="#get-task-information-by-name" id="get-task-information-by-name"></a>

Get information such as start date, due date etc about all tasks with given name.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter     | Description                             |
| ------------- | --------------------------------------- |
| Task app name | Name of Task app in SharePoint (not id) |
| Task name     | Name of task                            |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |

### Get task information by query <a href="#get-task-information-by-query" id="get-task-information-by-query"></a>

Gets information about tasks by provided CAML Query. Example to get all tasks that are 50% or more completed:

```
<View>
    <Query>
        <Where>
            <Geq>
                <FieldRef Name='PercentComplete' />
                <Value Type='Number'>0.50</Value>
            </Geq>
        </Where>
    </Query>
</View>
```

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter     | Description                             |
| ------------- | --------------------------------------- |
| Task app name | Name of Task app in SharePoint (not id) |
| CAML Query    | The query to send to SharePoint.        |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |

### Get task property value <a href="#get-task-property-value" id="get-task-property-value"></a>

Gets the value of a field of a given task. This is an advanced operation that require deeper knowledge on how SharePoint works. The Property parameter is the identifier of a field, which might not be the same as is displayed in SharePoint. E.g use 'Body' as Property to update 'Description'.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter     | Description                             |
| ------------- | --------------------------------------- |
| Task app name | Name of Task app in SharePoint (not id) |
| Task ID       | ID of task                              |
| Property      | Name of property                        |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member    | Description                                                            |
| --------- | ---------------------------------------------------------------------- |
| HasFailed | Whether operation has failed or not                                    |
| ErrorCode | An error code related to operation failure. Is 0 if no failure occured |
| Results   | Simple variable containing the results of operation                    |

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |
| 1000004    | Item with given id does not exist.           |

### List fields of tasks <a href="#list-fields-of-tasks" id="list-fields-of-tasks"></a>

Lists the fields that are available for tasks in Task app.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter                | Description                                                                               |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| Task app name            | Name of Task app in SharePoint (not id)                                                   |
| Include read only fields | Specifies whether to include fields that can only be read in the results of the operation |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results\
StaticName\
Title\
Description\
DefaultValue\
ReadOnly\
Required\
TypeAsString

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |

### List tasks <a href="#list-tasks" id="list-tasks"></a>

Lists all tasks.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter     | Description                                                       |
| ------------- | ----------------------------------------------------------------- |
| Task app name | Name of Task app in SharePoint (not id)                           |
| Row limit     | Limit on how many tasks to list. A value of -1 indicates no limit |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |

### List tasks assigned to current user <a href="#list-tasks-assigned-to-current-user" id="list-tasks-assigned-to-current-user"></a>

Lists all tasks assigned to current user. Optionally including finished tasks.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter                     | Description                                       |
| ----------------------------- | ------------------------------------------------- |
| Task app name                 | Name of Task app in SharePoint (not id)           |
| Include already finshed tasks | Specifies whether to also include completed tasks |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |

### List tasks assigned to specific user <a href="#list-tasks-assigned-to-specific-user" id="list-tasks-assigned-to-specific-user"></a>

Lists all tasks assigned to specified user. Optionally including finished tasks.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter                     | Description                                       |
| ----------------------------- | ------------------------------------------------- |
| Task app name                 | Name of Task app in SharePoint (not id)           |
| User ID                       | ID of user                                        |
| Include already finshed tasks | Specifies whether to also include completed tasks |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not. If succesful, result of operation is stored in Results member

| Member       | Description                                                            |
| ------------ | ---------------------------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                                    |
| ErrorMessage | A description of the failure, if any                                   |
| ErrorCode    | An error code related to operation failure. Is 0 if no failure occured |
| Results      | Table variable containing the results of operation                     |

Structure of Results Results

* &#x20;ID

  ParentID

  &#x20;TaskName

  &#x20;DueDate

  &#x20;StartDate

  &#x20;AssignedTo

  * &#x20;UserID
  * &#x20;Value

  &#x20;Predecessors

  * &#x20;TaskID
  * &#x20;Value

  &#x20;Priority

  &#x20;PercentComplete

  &#x20;Description

  &#x20;Status

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.novacuraflow.com/6.12/development/flow-studio/connectors/business-systems/microsoft-sharepoint-2013/generic-operations/tasks/task-information.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
