Update an article

Update editable fields on an article — currently `content` and `metaDescription`. Send only the fields you want to change. Returns the full updated article.

PATCH
/articles/{slug}

Update editable fields on an article — currently content and metaDescription. Send only the fields you want to change. Returns the full updated article.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

ArticlesQ API key sent as Authorization: Bearer aq_live_.... Each key is scoped to a single project.

In: header

Path Parameters

slug*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

import ArticlesQ from "@articlesq/sdk";const articlesq = new ArticlesQ({ apiKey: process.env.ARTICLESQ_API_KEY });const { data } = await articlesq.articles.update("your-article-slug", {  metaDescription: "Updated description for better SEO.",});
{
  "article": {
    "id": "clx1abc234abcdef0123456789",
    "slug": "best-crm-for-startups",
    "title": "Best CRM for Startups in 2026",
    "keyword": "best crm for startups",
    "metaDescription": "Updated meta description with the latest pricing details.",
    "content": "# Introduction\n\nIf you're a startup founder evaluating CRM tools...",
    "status": "draft",
    "datePublished": "2026-05-23T00:00:00.000Z",
    "dateModified": null
  }
}
{
  "error": {
    "title": "Unauthorized",
    "status": 401,
    "code": "missing_auth",
    "message": "Missing Authorization header",
    "instance": "/api/v1/articles",
    "details": {
      "property1": {},
      "property2": {}
    }
  }
}

{
  "error": {
    "title": "Unauthorized",
    "status": 401,
    "code": "missing_auth",
    "message": "Missing Authorization header",
    "instance": "/api/v1/articles"
  }
}

{
  "error": {
    "title": "Forbidden",
    "status": 403,
    "code": "insufficient_scope",
    "message": "Missing required scope: articles:write",
    "instance": "/api/v1/articles/{slug}"
  }
}
{
  "error": {
    "title": "Not Found",
    "status": 404,
    "code": "not_found",
    "message": "Article not found",
    "instance": "/api/v1/articles/best-crm-for-startups"
  }
}