Skip to content
Median
Esc
↑↓navigate↵open⌘Jpreview

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.

PATCH/tasks/settings
Authorization
AuthorizationBearer token · headerrequired
`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Request body
requiredapplication/json
keyPrefixstring
Up to eight letters or numbers, starting with a letter.
max length 8
moveFromCodeboolean
githubRepostring | null
`owner/repo` where GitHub issues for cards are opened. `null` stops opening them.
watchRepostring
`owner/repo` to start reading commits and pull requests for keys.
unwatchRepostring
`owner/repo` to stop reading. `repo_not_found` when it is not being read.
Responses
200The settings, as they now stand.
keyPrefixstring
The letters every key wears.
linearTeamobject | null
Show properties
idstring
keystring
namestring
githubRepostring | null
"owner/repo", where issues for cards are opened.
codeReposstring[]
Repositories whose commits and pull requests are read for keys.
moveFromCodeboolean
Whether a merged pull request or a finishing commit may move a card.
boardUrlstring | null
400The request is malformed, and the message names the field.
errorobject
Show properties
codestring
messagestring
401The bearer token is missing, revoked, or expired.
errorobject
Show properties
codestring
messagestring
403The token's person does not hold the role this needs.
errorobject
Show properties
codestring
messagestring
404Not one of yours, or not there at all.
errorobject
Show properties
codestring
messagestring
429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobject
Show properties
codestring
messagestring
Request
curl -X PATCH "https://api.median.sh/v1/tasks/settings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "keyPrefix": "MED"
}'
Response
{
  "keyPrefix": "string",
  "linearTeam": {
    "id": "string",
    "key": "string",
    "name": "string"
  },
  "githubRepo": "string",
  "codeRepos": [
    "string"
  ],
  "moveFromCode": true,
  "boardUrl": "string"
}