---
title: "Create a task board task"
method: POST
path: "/v1/workspaces/{workspaceId}/task-board/tasks"
tags: ["Task Board"]
---

# Create a task board task

`POST /v1/workspaces/{workspaceId}/task-board/tasks`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/task-board/tasks`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- object
  - `title` string, required: Task title, maximum 180 characters.
  - `description` string, nullable: Task description, maximum 5000 characters.
  - `color` string, nullable: Card color as a #rrggbb hex value.
  - `columnId` string, uuid, nullable: Target column ID. Defaults to the backlog column.
  - `postId` string, uuid, nullable: Content post ID to link to the task.
  - `assigneeIds` string[]: Workspace member user IDs to assign, maximum 50.
  - `labelIds` string[]: Task board label IDs to apply, maximum 50.
  - `priority` 'urgent' | 'high' | 'medium' | 'low', nullable: Task priority.
  - `dueAt` string, nullable: Due date as YYYY-MM-DD.
  - `checklistItemTitles` string[]: Starter checklist item titles, maximum 25.

## Response `201`

Task created

- object
  - `data` PublicTaskBoardTaskResultDto, required
    - `task` object, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)
