PATCH /tasks/settings
Updated Oct 1, 20261 minute read
Update board settings
Renaming the prefix renames every key on the board, so a commit message naming an old one stops matching. Repositories need the GitHub account that owns them connected in the dashboard, or the request fails with github_not_connected. The Linear team is set in the Tasks app. Admins and owners only.
Part of Tasks.
Request body
application/json, required.
| Field | Type | Required | Description |
|---|---|---|---|
keyPrefix | string | No | Up to eight letters or numbers, starting with a letter. |
moveFromCode | boolean | No | |
githubRepo | any | No | owner/repo where GitHub issues for cards are opened. null stops opening them. |
watchRepo | string | No | owner/repo to start reading commits and pull requests for keys. |
unwatchRepo | string | No | owner/repo to stop reading. repo_not_found when it is not being read. |
Responses
| Status | Description |
|---|---|
200 | The settings, as they now stand. |
400 | The request is malformed, and the message names the field. |
401 | The bearer token is missing, revoked, or expired. |
403 | The token's person does not hold the role this needs. |
404 | Not one of yours, or not there at all. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
keyPrefix | string | No | The letters every key wears. |
linearTeam | object | No | |
linearTeam.id | string | No | |
linearTeam.key | string | No | |
linearTeam.name | string | No | |
githubRepo | any | No | "owner/repo", where issues for cards are opened. |
codeRepos | string[] | No | Repositories whose commits and pull requests are read for keys. |
moveFromCode | boolean | No | Whether a merged pull request or a finishing commit may move a card. |
boardUrl | any | No |
Example request
curl -X PATCH https://api.median.sh/v1/tasks/settings \
-H "Authorization: Bearer $BEARER_AUTH" \
-H "content-type: application/json" \
-d '{"keyPrefix":"MED"}'