> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create a task > Add a task to a project list. ## OpenAPI ````yaml /openapi/platform/projects.yaml PUT /v1/projects/{PROJECT_ID}/lists/{LIST_ID}/tasks openapi: 3.1.0 info: title: Projects and Tasks API version: '1.0' description: "“Projects and Tasks” is a project management tool that helps you take real action with simple planning, assigning, and task-tracking features. You can create projects with various tasks and assignments. Those tasks exist within swim lanes or lists, and can be moved from list to list to show progress through a particular workflow. You can use default lists or create new custom lists. You can also add attachments to individual tasks to reference relevant materials and other artifacts.\n\n\n> ### Note\n>\n>You will need to ensure that your client application has access to the Workflow scope in order to access the Projects and Tasks endpoints.\n\n## The project object\n### Attributes\n| Property Name | Type | Description |\n| --- | --- | --- |\nname | String | The name of the project\nid | String | The ID of the project\nmembers | Long | The ID's of the members of the project\ncreatedBy | Long | The ID of the user who created the project\ncreatedDate | Date | Date the project was created\npublic | Boolean | whether or not the project is a public project\ndescription | String | Description of the project\ndueDate | Date | Due date of the project\n\n## The list object\n### Attributes\n| Property Name | Type | Description |\n| --- | --- | --- |\n| name\t| String | The name of the List.|\n| id | String\t| The ID of the List.|\n| type | String\t| The type of List (i.e. `TODO`, `WORKING_ON`, `COMPLETED`).|\n| index\t| Long | The ordered index of the list within the project.|\n\n## The task object\n### Attributes\n| Property Name | Type | Description |\n| --- | --- | --- |\n|id | String | The ID of the task.|\n|projectId | String | The ID of the project that the task belongs to.|\n|projectListId\t| tring\t| The ID of the list within a project that the task belongs to.|\n|taskName | String | The name of the task.|\n|description | String\t| An optional description of the task.|\n|createdDate | ate | The date the task was created.|\n|dueDate | Date | The date the task is expected to be completed.|\n|priority | Long | The prioritized order of the task in a list.|\n|createdBy | Long | The ID of the Domo user that created the task.|\n|ownedBy | Long | The ID of the Domo user that owns the task.|\n|contributors | Long | An array of user IDs that are assigned as contributors to the task.|\n|attachmentCount | Long\t| The number of attachments that task has.|\n|tags | String\t| An array of tags that have been assigned to the task.|\n|archived | Boolean | Whether or not the task has been archived.|" servers: - url: https://api.domo.com description: Domo API security: - bearerAuth: [] paths: /v1/projects/{PROJECT_ID}/lists/{LIST_ID}/tasks: parameters: - schema: type: string name: PROJECT_ID in: path required: true description: The ID of the project - schema: type: string name: LIST_ID in: path required: true description: The ID of the list - name: OFFSET schema: type: integer in: query description: >- The maximum amount of results to return (defaults to 10 with a maximum of 50) - schema: type: integer name: LIMIT in: query description: >- The number of records to offset from the beginning of the result list (defaults to 0) put: summary: Create a task description: Add a task to a project list. operationId: create-a-task parameters: - schema: type: string in: query name: taskName description: The name of the task required: true - schema: type: string in: query name: description description: An optional description of the task - schema: type: string in: query name: dueDate description: The date the task is expected to be completed - schema: type: integer in: query name: priority description: >- Priority of task within a list. Setting this property will impact the index of other tasks in the list to maintain sequential order. If not provided the priority will default to 1 and the index of all the other tasks in the list will shift. - schema: type: integer in: query name: ownedBy description: The ID of the Domo user that owns the task - schema: type: integer in: query name: contributors description: An array of user IDs that are assigned as contributors to the task - schema: type: string in: query name: tags description: An array of tags that have been assigned to the task requestBody: content: application/json: schema: type: object properties: id: type: string projectId: type: string projectListId: type: string taskName: type: string priority: type: integer contributors: type: array items: type: integer tags: type: array items: type: object properties: {} archived: type: boolean x-examples: Example 1: id: '3' projectId: '2' projectListId: '4' taskName: Business Plan Review priority: 3 contributors: - 27 tags: [] archived: false examples: Example 1: value: id: '3' projectId: '2' projectListId: '4' taskName: Business Plan Review priority: 3 contributors: - 27 tags: [] archived: false description: The request body accepts a task object. responses: '200': description: Returns the task object. content: application/json: schema: type: object properties: id: type: string projectId: type: string projectListId: type: string taskName: type: string createdDate: type: string updatedDate: type: string priority: type: integer createdBy: type: integer ownedBy: type: integer contributors: type: array items: type: integer attachmentCount: type: integer tags: type: array items: type: object properties: {} archived: type: boolean x-examples: Example 1: id: '5' projectId: '2' projectListId: '4' taskName: Business Plan Review createdDate: '2018-08-01T08:00:00Z' updatedDate: '2018-08-01T08:00:00Z' priority: 3 createdBy: 27 ownedBy: 27 contributors: - 27 attachmentCount: 0 tags: [] archived: false examples: Example 1: value: id: '5' projectId: '2' projectListId: '4' taskName: Business Plan Review createdDate: '2018-08-01T08:00:00Z' updatedDate: '2018-08-01T08:00:00Z' priority: 3 createdBy: 27 ownedBy: 27 contributors: - 27 attachmentCount: 0 tags: [] archived: false components: securitySchemes: bearerAuth: type: http scheme: bearer ````