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.
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 ArticlesQ API key sent as Authorization: Bearer aq_live_.... Each key is scoped to a single project.
In: header
Path Parameters
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"
}
}Publish or unpublish an article POST
Publishes a draft or returns a published article to draft. Needs the `articles:publish` scope, which is granted separately from `articles:write`, so a key can create and edit drafts without being able to publish them. Returns the updated article.
Get image settings GET
Returns the project's image settings: the style added to every image prompt, whether the logo and the character are used, their reference images, and the brand notes. Read them before writing image prompts so your scenes fit the style and the brand notes.