Update a blog article
curl --request PATCH \
--url https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"article": {
"author": "<string>",
"blogId": "<string>",
"bodyHtml": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"excerpt": "<string>",
"handle": "<string>",
"id": "<string>",
"image": {
"altText": "<string>",
"url": "<string>"
},
"isPublished": true,
"platform": "shopify",
"publishDate": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"status": "publish",
"tags": [
"<string>"
],
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"url": "<string>"
},
"platform": "shopify"
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}AIsa Social
Update a blog article
Blogs. Acts in public on your connected account; needs social:publish. Audited. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call.
Partial-updates an article. Supported on Shopify (`shopify`), WordPress (`wordpress`), Wix (`wix`) and Webflow (`webflow`).
Send any subset of the create fields: `title`, `bodyHtml`, `handle`, `tags`, `author`, `excerpt`, `image`, `seo`, `isPublished`, `publishDate`. At least one field is required (an empty body returns 400).
### Publishing
`isPublished` and `publishDate` behave as on create:
- `isPublished: false` unpublishes back to a draft.
- A future `publishDate` schedules publication natively on the platform.
- Omitting both fields preserves the current WordPress or Wix status.
Omitting `image` preserves the current featured image; removal is not supported.
### Platform limits
- **WordPress**: rejects `seo` and does not support SEO-plugin/custom-field, category, or custom-post-type writes.
- **Webflow**: an edit to a published item goes live immediately, `isPublished: false` unpublishes it, and a future `publishDate` returns 400.
<!-- aisa-pricing:start -->
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
PATCH
https://api.aisa.one
/
apis
/
v1
/
social
/
accounts
/
{accountId}
/
blogs
/
{blogId}
/
articles
/
{articleId}
Update a blog article
curl --request PATCH \
--url https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"article": {
"author": "<string>",
"blogId": "<string>",
"bodyHtml": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"excerpt": "<string>",
"handle": "<string>",
"id": "<string>",
"image": {
"altText": "<string>",
"url": "<string>"
},
"isPublished": true,
"platform": "shopify",
"publishDate": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"status": "publish",
"tags": [
"<string>"
],
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"url": "<string>"
},
"platform": "shopify"
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}Request contract
- Method and path: PATCH /apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId} - accountId: path; required
- blogId: path; required
- articleId: path; required
- Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
{
"operationId": "patch_aisa_social_apis_v1_social_accounts_account_1bfa6c",
"method": "PATCH",
"path": "/apis/v1/social/accounts/{accountId}/blogs/{blogId}/articles/{articleId}",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "One of your social accounts (acc_...).",
"in": "path",
"name": "accountId",
"required": true,
"schema": {
"pattern": "^acc_[0-9A-Za-z]{22}$",
"type": "string"
}
},
{
"description": "Platform-native blog/site id returned by the list operation.",
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"type": "string"
}
},
{
"description": "Platform-native article id: numeric on Shopify and WordPress, a GUID on Wix, a 24-character hex item id on Webflow. Other formats return 400.",
"in": "path",
"name": "articleId",
"required": true,
"schema": {
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"example": {},
"schema": {
"description": "At least one field is required.",
"properties": {
"author": {
"description": "Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.",
"type": "string"
},
"bodyHtml": {
"description": "Article body as HTML.",
"type": "string"
},
"excerpt": {
"description": "Short summary shown in blog listings.",
"type": "string"
},
"fieldData": {
"additionalProperties": true,
"description": "Webflow only (other platforms answer 400). The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }).\n\n- Required by collections with required fields of their own. A create that leaves one empty answers 400 listing them.\n- A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400.",
"type": "object"
},
"handle": {
"description": "URL slug of the article.",
"type": "string"
},
"image": {
"description": "Featured image from a public URL. WordPress downloads it into the media library and Wix imports it into the Media Manager; JPEG, PNG, GIF and WebP are accepted up to 10 MB. Omit to preserve it; null removal is not supported.",
"properties": {
"altText": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"isPublished": {
"description": "Set false to move to draft or true to publish. On WordPress and Wix false takes priority over a future publishDate; omission preserves status unless publishDate is sent (edits to a published Wix post go live).",
"type": "boolean"
},
"publishDate": {
"description": "ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.",
"format": "date-time",
"type": "string"
},
"seo": {
"description": "Shopify and Wix. Search-engine overrides: Shopify global title_tag and description_tag metafields, Wix post SEO title and meta description. WordPress rejects this field.",
"properties": {
"description": {
"type": "string"
},
"title": {
"type": "string"
}
},
"type": "object"
},
"tags": {
"description": "Replaces the full tag-name list. WordPress and Wix resolve existing names case-insensitively and create missing tags (Wix allows up to 30).",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"type": "object"
}
}
},
"required": true
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"description": "Included with your connected social accounts: AIsa does not charge per call.",
"kind": "no_customer_charge"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$Platform-native blog/site id returned by the list operation.
Pattern:
^[A-Za-z0-9_-]{1,64}$Platform-native article id: numeric on Shopify and WordPress, a GUID on Wix, a 24-character hex item id on Webflow. Other formats return 400.
Pattern:
^[A-Za-z0-9_-]{1,64}$Body
application/json
At least one field is required.
Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.
Article body as HTML.
Short summary shown in blog listings.
Webflow only (other platforms answer 400). The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }).
- Required by collections with required fields of their own. A create that leaves one empty answers 400 listing them.
- A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400.
URL slug of the article.
Featured image from a public URL. WordPress downloads it into the media library and Wix imports it into the Media Manager; JPEG, PNG, GIF and WebP are accepted up to 10 MB. Omit to preserve it; null removal is not supported.
Show child attributes
Show child attributes
Set false to move to draft or true to publish. On WordPress and Wix false takes priority over a future publishDate; omission preserves status unless publishDate is sent (edits to a published Wix post go live).
ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.
Shopify and Wix. Search-engine overrides: Shopify global title_tag and description_tag metafields, Wix post SEO title and meta description. WordPress rejects this field.
Show child attributes
Show child attributes
Replaces the full tag-name list. WordPress and Wix resolve existing names case-insensitively and create missing tags (Wix allows up to 30).
Maximum array length:
100Minimum string length:
1Minimum string length:
1