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

Everything connected

What is connected and what each one is pointed at, in one read: the email address, the Slack and Discord channels, the GitHub accounts and repositories, the Notion workspace, the Linear team, and where issues and commits are read from. available: false means the deployment has no app to connect through, which is a different thing from nobody having connected one. The tracker half reads as empty rather than as absent for a caller who cannot manage signals.

GET/integrations
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 integrations.
emailobject
Show properties
availableboolean
addressstring
enabledboolean
slackobject
Show properties
availableboolean
workspacestring | null
mirrorChannelstring | null
enabledboolean
botRunningboolean
discordobject
Show properties
availableboolean
serverstring | null
ticketChannelstring | null
staffRolestring | null
mirrorChannelstring | null
mirrorEnabledboolean
enabledboolean
botRunningboolean
githubobject
Show properties
accountsstring[]
reposobject[]
Show properties
Array of object
repostring
branchstring | null
pathstring | null
statusstring
errorstring | null
publishedAtstring | null
lastSyncedAtinteger | null
docsSitesobject[]
The same repositories read as what they are, so every page has an address from the first sync.
Show properties
Array of object
repostring
frameworkstring
publishedAtstring | null
statusstring
notionobject
Show properties
workspacestring | null
connectedBystring | null
linearobject
Show properties
availableboolean
workspacestring | null
teamstring | null
autoCreateIssuesboolean
issueRepoobject | null
Where signals open GitHub issues, when anywhere.
Show properties
repostring
autoCreateboolean
commitReposobject[]
Show properties
Array of object
repostring
branchstring | null
closeFromCommitsboolean
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/integrations" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "email": {
    "available": true,
    "address": "string",
    "enabled": true
  },
  "slack": {
    "available": true,
    "workspace": "string",
    "mirrorChannel": "string",
    "enabled": true,
    "botRunning": true
  },
  "discord": {
    "available": true,
    "server": "string",
    "ticketChannel": "string",
    "staffRole": "string",
    "mirrorChannel": "string",
    "mirrorEnabled": true,
    "enabled": true,
    "botRunning": true
  },
  "github": {
    "accounts": [
      "string"
    ],
    "repos": [
      {
        "repo": "string",
        "branch": "string",
        "path": "string",
        "status": "string",
        "error": "string",
        "publishedAt": "string",
        "lastSyncedAt": 0
      }
    ],
    "docsSites": [
      {
        "repo": "string",
        "framework": "string",
        "publishedAt": "string",
        "status": "string"
      }
    ]
  },
  "notion": {
    "workspace": "string",
    "connectedBy": "string"
  },
  "linear": {
    "available": true,
    "workspace": "string",
    "team": "string",
    "autoCreateIssues": true
  },
  "issueRepo": {
    "repo": "string",
    "autoCreate": true
  },
  "commitRepos": [
    {
      "repo": "string",
      "branch": "string",
      "closeFromCommits": true
    }
  ]
}