Get board settings

How the board is wired up, and where it lives.

GET/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.

Responses

200The settings.

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

401The bearer token is missing, revoked, or expired.

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 GET "https://api.median.sh/v1/tasks/settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/tasks/settings", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "keyPrefix": "string",
  "linearTeam": {
    "id": "string",
    "key": "string",
    "name": "string"
  },
  "githubRepo": "string",
  "codeRepos": [
    "string"
  ],
  "moveFromCode": true,
  "boardUrl": "string"
}