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"
  }
}

Create an article POST

Creates a new article in the project the API key is scoped to. Use this when you generate content with your own agents and want ArticlesQ to host it (e.g. for the backlinks exchange). The article body is markdown.

Setup webhooks

Receive article events in your app and verify that they really came from ArticlesQ.