--- title: "Data container task guide" canonical_url: "https://www.nutrient.io/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-data-container/" md_url: "https://www.nutrient.io/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-data-container.md" last_updated: "2026-05-23T00:08:18.199Z" description: "Learn to configure data container tasks for efficient JSON data handling in your API workflows." --- # Streamline API workflows with data container tasks The 'data container' task allows you to create a custom endpoint that can receive posted JSON data and stores it as instance data in your Integrify database. This task is designed to be completed by an API POST. Once the workflow reaches the data container task, the endpoint is prepped to wait for data to be posted to it. Once the data is posted, the workflow moves forward.![](@/assets/guides/workflow-automation/files/1393/data_container.png) ### How it Works * You add a data container task type to your workflow. * You configure the task, defining an expected field configuration with specific keys and data types. * Field Configuration: This shows which fields from your post body to store in the database (the other fields are ignored). None of the fields will be required in the post body, so you can include as many as you would like in the post body without producing an error. * Data Types: The expected data types for each field, such as 'string', 'numeric', or 'date'.![](@/assets/guides/workflow-automation/files/1393/config_data_cont.png)![](@/assets/guides/workflow-automation/files/1393/field_to_capt.png)![](@/assets/guides/workflow-automation/files/1393/data_cont.png) #### To begin working with the function described below, make sure that you have at least one Data Container task active in a request in your Integrify instance. ### Checking for Endpoints Programmatically You can always find your endpoint in the request summary, but you can also programmatically check for endpoints by sending a GET request to: ``` /tasktypes/data-container/endpoints ``` You can optionally filter by task name, instance ID, or instance SID. [See complete filtering options at developer.integrify.com](https://developer.integrify.com/rest/TaskTypes/tasktypes-data-container-endpoints) Here is an example response that shows two ready endpoints: ```json { endpoints: [ "/tasktypes/data-container/instances/tasks/reciptasks/d854f1fd-773d-4883-a2b7-0acc8c33d138?task_name=myTaskName", "/tasktypes/data-container/instances/tasks/reciptasks/d854f1fd-773d-4883-a2b7-0acc8c33d138?task_name=myOtherTaskName" ] } ``` As a convenience, the task name is appended to each endpoint in the response for easier visual parsing and searching. When a GET or POST request is made to the endpoint, this 'task_name' querystring will be ignored if included. Here is an example response that includes no endpoints (You will get this result if no Data Container tasks are currently active in Integrify): ```json { endpoints: [ ] } ``` ### Getting the Field Configuration Each endpoint will accept a GET request or a POST request. * GET * Returns the field configuration for your endpoint, in case you need to know what field keys and data types are expected. Here is an example field configuration ```json { field_configuration: [ { key: "client_name", value_type: "string" }, { key: "client_number", value_type: "numeric" } ] } ``` [See more information at developer.integrify.com](https://developer.integrify.com/rest/TaskTypes/tasktypes-data-container-get) ### Posting Data * POST * Stores any data fields from the post body that match the expected field configuration. * Completes the task and pushes the workflow to the next task. Here is an example post body: ```json { "client_name": "John Doe", "client_number": 5 } ``` Sending file attachments to a data container is a 2 part process. First, you must upload the file to the server using this API call: [https://developer.integrify.com/rest/Files/upload](https://developer.integrify.com/rest/Files/upload). Using the key value that is returned in this call, you then complete the data container file upload field using the key value you just retrieved: ```json { "client_name": "John Doe", "file_attachment":  "1a9dec20-3e93-11e5-8b58-7b9ee7d080f1" } ``` --- ## Related pages - [Catch submission issues before they reach the approver](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/ai-form-review.md) - [List of task types](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/complete-list-of-task-types.md) - [Effective data transfer between parent and child requests](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/passing-data-from-child-request-back-to-parent.md) - [Document Signing task configuration](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/document-signing-task.md) - [Optimize your workflow with counter tasks](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-counter-task.md) - [Create documents with Document Generation](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/premium-add-on-task-document-generation.md) - [How to configure the dynamic assigner task](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-dynamic-assigner.md) - [Configure dynamic email notifications seamlessly](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-dynamic-notification.md) - [Use the Excel Batch task in a workflow](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-excel-batch.md) - [Excel Import task configuration](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-excel-import.md) - [File Copy task configuration](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-file-copy.md) - [Customize task assignments with Form Assigner](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-form-assigner.md) - [Form task configuration](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-form-task.md) - [Enhance your processes with general notifications](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-general-notification.md) - [Simplifying workflow with Launch Request management](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-launch-request.md) - [Streamline file transfers with FTP Push Task](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-ftp-push-task.md) - [Understanding milestone tasks in workflow automation](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-milestone.md) - [Master the Open URL Task for Workflow Automation](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-open-url.md) - [Streamline your processes with PDF generator task](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-pdf-generator.md) - [Effortlessly merge PDFs with ease](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-pdf-merge.md) - [Efficient task assignment with Task Assigner](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-task-assigner.md) - [Schedule future tasks effortlessly with Task Scheduler](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-task-scheduler.md) - [Effortlessly manage user profile updates](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-task-user-profile.md) - [Configure form prefills](/guides/workflow-automation/admin-guide/processes/tasks/standard-task/standard-tasks-form-prefills.md)