Publish or unpublish articles

Puts knowledge documents on the help center, or takes them off. A published document keeps its address; what the article says is read from the document. Up to 200 at a time. Owners and admins.

POST/site/articles

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

docIdsstring[]required

max items 200

publishedbooleanrequired

Responses

200How many changed.

changedinteger

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

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 POST "https://api.median.sh/v1/site/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "docIds": [
    "string"
  ],
  "published": true
}'

const response = await fetch("https://api.median.sh/v1/site/articles", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "docIds": [
    "string"
  ],
  "published": true
})
});

Response

{
  "changed": 0
}