POST /tasks
Updated Oct 1, 20261 minute read
Create a task
A new card, on top of its column, planned unless another column is named. An issue in whichever tracker the board is connected to is opened for it on its own.
Part of Tasks.
Request body
application/json, required.
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | |
description | string | No | |
status | "requests" | "planned" | "in_progress" | "in_review" | "done" | No | |
priority | "urgent" | "high" | "medium" | "low" | No | |
assignee | string | No | A teammate's identity key or their email address. |
Responses
| Status | Description |
|---|---|
200 | The card. |
400 | The request is malformed, and the message names the field. |
401 | The bearer token is missing, revoked, or expired. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
id | string | No | |
key | string | No | |
number | integer | No |
Example response
{
"id": "k97a2fh3m1x8p4qv6r2t9w5y",
"key": "MED-12",
"number": 12
}Example request
curl -X POST https://api.median.sh/v1/tasks \
-H "Authorization: Bearer $BEARER_AUTH" \
-H "content-type: application/json" \
-d '{"title":"Export times out past 10k rows","description":"The CSV export gives up on large workspaces.","priority":"high"}'