curl --request PATCH \
--url https://api.mymarky.ai/api/workspaces/{workspace_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "<string>",
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"platform_writing_instructions": {
"common": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"twitter": "<string>",
"linkedIn": "<string>",
"linkedInProfile": "<string>",
"tiktok": "<string>",
"pinterest": "<string>",
"googleBusiness": "<string>",
"instagramStory": "<string>",
"youtube": "<string>"
},
"timezone": "<string>",
"failed_to_publish_enabled": true,
"low_scheduled_enabled": true,
"post_published_enabled": true,
"post_stats_digest_enabled": true,
"allow_duplicate_name": false,
"clear": []
}
'import requests
url = "https://api.mymarky.ai/api/workspaces/{workspace_id}"
payload = {
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "<string>",
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"platform_writing_instructions": {
"common": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"twitter": "<string>",
"linkedIn": "<string>",
"linkedInProfile": "<string>",
"tiktok": "<string>",
"pinterest": "<string>",
"googleBusiness": "<string>",
"instagramStory": "<string>",
"youtube": "<string>"
},
"timezone": "<string>",
"failed_to_publish_enabled": True,
"low_scheduled_enabled": True,
"post_published_enabled": True,
"post_stats_digest_enabled": True,
"allow_duplicate_name": False,
"clear": []
}
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({
design_style: '<string>',
brand_style_grid_url: '<string>',
strategy: '<string>',
name: '<string>',
description: '<string>',
industry: '<string>',
website: '<string>',
language: '<string>',
events: [{name: '<string>', date: '2023-12-25', kind: 'event', note: '<string>'}],
platform_writing_instructions: {
common: '<string>',
facebook: '<string>',
instagram: '<string>',
twitter: '<string>',
linkedIn: '<string>',
linkedInProfile: '<string>',
tiktok: '<string>',
pinterest: '<string>',
googleBusiness: '<string>',
instagramStory: '<string>',
youtube: '<string>'
},
timezone: '<string>',
failed_to_publish_enabled: true,
low_scheduled_enabled: true,
post_published_enabled: true,
post_stats_digest_enabled: true,
allow_duplicate_name: false,
clear: []
})
};
fetch('https://api.mymarky.ai/api/workspaces/{workspace_id}', 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.mymarky.ai/api/workspaces/{workspace_id}",
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([
'design_style' => '<string>',
'brand_style_grid_url' => '<string>',
'strategy' => '<string>',
'name' => '<string>',
'description' => '<string>',
'industry' => '<string>',
'website' => '<string>',
'language' => '<string>',
'events' => [
[
'name' => '<string>',
'date' => '2023-12-25',
'kind' => 'event',
'note' => '<string>'
]
],
'platform_writing_instructions' => [
'common' => '<string>',
'facebook' => '<string>',
'instagram' => '<string>',
'twitter' => '<string>',
'linkedIn' => '<string>',
'linkedInProfile' => '<string>',
'tiktok' => '<string>',
'pinterest' => '<string>',
'googleBusiness' => '<string>',
'instagramStory' => '<string>',
'youtube' => '<string>'
],
'timezone' => '<string>',
'failed_to_publish_enabled' => true,
'low_scheduled_enabled' => true,
'post_published_enabled' => true,
'post_stats_digest_enabled' => true,
'allow_duplicate_name' => false,
'clear' => [
]
]),
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.mymarky.ai/api/workspaces/{workspace_id}"
payload := strings.NewReader("{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}")
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.mymarky.ai/api/workspaces/{workspace_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mymarky.ai/api/workspaces/{workspace_id}")
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 = "{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"created_at": "<string>",
"warnings": [
{
"field": "<string>",
"level": "approaching_limit",
"message": "<string>",
"code": "<string>"
}
],
"field_budgets": [
{
"field": "<string>",
"limit": 123,
"used": 123,
"remaining": 123
}
],
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "en",
"platform_writing_instructions": {},
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"timezone": "<string>",
"updated_at": "<string>",
"revision_id": "<string>",
"propagation": [
{
"field": "website",
"old": "<string>",
"new": "<string>",
"affected_unpublished": 123,
"requires": "caption_replace",
"suggested": {
"match": {
"statuses": [
"<string>"
]
},
"set": {
"caption_replace": {
"find": "<string>",
"replace": "<string>"
}
}
}
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}Update workspace
Update a workspace. Only provided fields are changed.
Changing the website does not rewrite posts that are already made.
propagation says how many unpublished posts still carry the old value and
gives the update_posts call that fixes them.
Errors: 400 invalid_request: No fields were given to update. 400 invalid_value: The workspace id is not a valid UUID. 401 authentication_required: API key or token is missing, invalid, or revoked. 403 permission_denied: Your plan does not include API access, or this workspace is not in your org. 404 resource_not_found: No workspace with that ID exists. 409 NAME_MATCHES_OTHER_WORKSPACE: Another workspace in your org already has that name. Nothing was saved. Send allow_duplicate_name=true to rename anyway. 429 rate_limit_exceeded: You sent too many requests this minute.
curl --request PATCH \
--url https://api.mymarky.ai/api/workspaces/{workspace_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "<string>",
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"platform_writing_instructions": {
"common": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"twitter": "<string>",
"linkedIn": "<string>",
"linkedInProfile": "<string>",
"tiktok": "<string>",
"pinterest": "<string>",
"googleBusiness": "<string>",
"instagramStory": "<string>",
"youtube": "<string>"
},
"timezone": "<string>",
"failed_to_publish_enabled": true,
"low_scheduled_enabled": true,
"post_published_enabled": true,
"post_stats_digest_enabled": true,
"allow_duplicate_name": false,
"clear": []
}
'import requests
url = "https://api.mymarky.ai/api/workspaces/{workspace_id}"
payload = {
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "<string>",
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"platform_writing_instructions": {
"common": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"twitter": "<string>",
"linkedIn": "<string>",
"linkedInProfile": "<string>",
"tiktok": "<string>",
"pinterest": "<string>",
"googleBusiness": "<string>",
"instagramStory": "<string>",
"youtube": "<string>"
},
"timezone": "<string>",
"failed_to_publish_enabled": True,
"low_scheduled_enabled": True,
"post_published_enabled": True,
"post_stats_digest_enabled": True,
"allow_duplicate_name": False,
"clear": []
}
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({
design_style: '<string>',
brand_style_grid_url: '<string>',
strategy: '<string>',
name: '<string>',
description: '<string>',
industry: '<string>',
website: '<string>',
language: '<string>',
events: [{name: '<string>', date: '2023-12-25', kind: 'event', note: '<string>'}],
platform_writing_instructions: {
common: '<string>',
facebook: '<string>',
instagram: '<string>',
twitter: '<string>',
linkedIn: '<string>',
linkedInProfile: '<string>',
tiktok: '<string>',
pinterest: '<string>',
googleBusiness: '<string>',
instagramStory: '<string>',
youtube: '<string>'
},
timezone: '<string>',
failed_to_publish_enabled: true,
low_scheduled_enabled: true,
post_published_enabled: true,
post_stats_digest_enabled: true,
allow_duplicate_name: false,
clear: []
})
};
fetch('https://api.mymarky.ai/api/workspaces/{workspace_id}', 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.mymarky.ai/api/workspaces/{workspace_id}",
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([
'design_style' => '<string>',
'brand_style_grid_url' => '<string>',
'strategy' => '<string>',
'name' => '<string>',
'description' => '<string>',
'industry' => '<string>',
'website' => '<string>',
'language' => '<string>',
'events' => [
[
'name' => '<string>',
'date' => '2023-12-25',
'kind' => 'event',
'note' => '<string>'
]
],
'platform_writing_instructions' => [
'common' => '<string>',
'facebook' => '<string>',
'instagram' => '<string>',
'twitter' => '<string>',
'linkedIn' => '<string>',
'linkedInProfile' => '<string>',
'tiktok' => '<string>',
'pinterest' => '<string>',
'googleBusiness' => '<string>',
'instagramStory' => '<string>',
'youtube' => '<string>'
],
'timezone' => '<string>',
'failed_to_publish_enabled' => true,
'low_scheduled_enabled' => true,
'post_published_enabled' => true,
'post_stats_digest_enabled' => true,
'allow_duplicate_name' => false,
'clear' => [
]
]),
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.mymarky.ai/api/workspaces/{workspace_id}"
payload := strings.NewReader("{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}")
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.mymarky.ai/api/workspaces/{workspace_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mymarky.ai/api/workspaces/{workspace_id}")
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 = "{\n \"design_style\": \"<string>\",\n \"brand_style_grid_url\": \"<string>\",\n \"strategy\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"industry\": \"<string>\",\n \"website\": \"<string>\",\n \"language\": \"<string>\",\n \"events\": [\n {\n \"name\": \"<string>\",\n \"date\": \"2023-12-25\",\n \"kind\": \"event\",\n \"note\": \"<string>\"\n }\n ],\n \"platform_writing_instructions\": {\n \"common\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"twitter\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"linkedInProfile\": \"<string>\",\n \"tiktok\": \"<string>\",\n \"pinterest\": \"<string>\",\n \"googleBusiness\": \"<string>\",\n \"instagramStory\": \"<string>\",\n \"youtube\": \"<string>\"\n },\n \"timezone\": \"<string>\",\n \"failed_to_publish_enabled\": true,\n \"low_scheduled_enabled\": true,\n \"post_published_enabled\": true,\n \"post_stats_digest_enabled\": true,\n \"allow_duplicate_name\": false,\n \"clear\": []\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"created_at": "<string>",
"warnings": [
{
"field": "<string>",
"level": "approaching_limit",
"message": "<string>",
"code": "<string>"
}
],
"field_budgets": [
{
"field": "<string>",
"limit": 123,
"used": 123,
"remaining": 123
}
],
"design_style": "<string>",
"brand_style_grid_url": "<string>",
"strategy": "<string>",
"name": "<string>",
"description": "<string>",
"industry": "<string>",
"website": "<string>",
"language": "en",
"platform_writing_instructions": {},
"events": [
{
"name": "<string>",
"date": "2023-12-25",
"kind": "event",
"note": "<string>"
}
],
"timezone": "<string>",
"updated_at": "<string>",
"revision_id": "<string>",
"propagation": [
{
"field": "website",
"old": "<string>",
"new": "<string>",
"affected_unpublished": 123,
"requires": "caption_replace",
"suggested": {
"match": {
"statuses": [
"<string>"
]
},
"set": {
"caption_replace": {
"find": "<string>",
"replace": "<string>"
}
}
}
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"code": "<string>",
"instance": "<string>",
"request_id": "<string>",
"param": "<string>"
}Authorizations
Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.
Headers
Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-11-03) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.
2026-04-08, 2026-07-17, 2026-08-02, 2026-08-04, 2026-08-06, 2026-10-30, 2026-10-31, 2026-11-03 "2026-11-03"
Path Parameters
The workspace ID (a UUID from list_workspaces).
Body
The brand's whole visual direction as markdown: the place for its colours (exact hex codes, which one leads), fonts, how type is set, logo placement and when the logo appears, imagery and whitespace. Prose at the top is binding on every image; a ## Treatments table underneath lists named looks, one picked per post. SCOPE: it is added to the prompt for AI-GENERATED images. It does NOT reach a template design, so it will not change a batch generated from templates. SIZE: 5000 characters, and writing this field REPLACES the whole value. Plan to the cap before composing; the response's field_budgets entry tells you how much room is left.
URL of a rendered 2x2 grid of four sample posts, all in ONE of the treatments from the design_style table — the first look the user kept when they ran /brand-setup. Written by /brand-setup at the end of that run; the app shows it so someone can SEE their look instead of reading it.
Social strategy doc as MARKDOWN — the goal we're working toward, who the posts are for, the brand voice, what we're trying right now, what we won't do, cadence and mix, plus a running log of experiments and what we learned. This is the layer an agency revisits each quarter. Write plain markdown (## headings, - bullets, | tables |); the app renders it in a rich-text editor, so no HTML tags — they show up as literal text and spend the size budget without adding meaning. Content pillars, caption rules and calls to action go here too. How graphics look goes in design_style. SIZE: 6000 characters, and writing this field REPLACES the whole doc. A longer value is still saved, but it comes back with a warning you have to act on in the same turn — so plan the doc to the cap BEFORE you compose it, rather than writing long and compacting after. The response's field_budgets entry for this field tells you exactly how much room is left.
Workspace name
Workspace description
Industry
Business website URL
Content language, as an ISO 639-1 code (e.g. 'en') or English name (e.g. 'English'). Both accepted.
The workspace's own dated moments: launches, openings, sales, events (e.g. {'name': 'Hope Shop opening', 'date': '2026-10-10', 'kind': 'opening'}). They show up in list_upcoming_moments, and a caption that names one is dated to it. At most 20. REPLACES the whole list: send every event to keep (the workspace's current events), or [] to clear. Undo with revert_revisions.
20Show child attributes
Show child attributes
MERGE-patch of the per-platform caption-writing instructions: only the keys you send change (e.g. {'facebook': 'Casual, ask a question.'} updates facebook and leaves every other platform alone). Send an EMPTY STRING to reset that platform to defaults.
Show child attributes
Show child attributes
The workspace's IANA timezone, e.g. 'Europe/Warsaw'. Posting-schedule slots and every *_local time use it, and holidays in moments come from its country. Existing schedule slots keep the moment they publish at; re-send the posting schedule to set slots on the new clock.
Deprecated: has no effect. Email notifications are set per user, in the app under Account > Notifications, not per workspace.
Deprecated: has no effect. Email notifications are set per user, in the app under Account > Notifications, not per workspace.
Deprecated: has no effect. Email notifications are set per user, in the app under Account > Notifications, not per workspace.
Deprecated: has no effect. Email notifications are set per user, in the app under Account > Notifications, not per workspace.
Set true to rename this workspace to a name another workspace in your org already has. Without it that rename is refused with 409 NAME_MATCHES_OTHER_WORKSPACE, because it usually means the content belongs in that other workspace instead.
Fields to empty, e.g. ['website']: the only way to clear one (an empty string is refused). Only when the user asked.
description, industry, website, design_style, brand_style_grid_url, strategy Response
Successful Response
What update_workspace returns: the workspace, plus how far the change reaches.
Workspace ID
When the workspace was created
Non-blocking notes about fields that need attention, empty when there is nothing to do. Act on them in the same turn you see them — that is while you still have the content in context.
Show child attributes
Show child attributes
Size ceilings for the fields that get pasted into the prompt for every generated post. READ THIS BEFORE COMPOSING a value for one of these fields — remaining is the room you have, and a budgeted field is REPLACED whole on write, so limit is the real target. Over-budget writes are accepted, not rejected, but they cost a full rewrite to fix.
Show child attributes
Show child attributes
The brand's whole visual direction as markdown: the place for its colours (exact hex codes, which one leads), fonts, how type is set, logo placement and when the logo appears, imagery and whitespace. Prose at the top is binding on every image; a ## Treatments table underneath lists named looks, one picked per post. SCOPE: it is added to the prompt for AI-GENERATED images. It does NOT reach a template design, so it will not change a batch generated from templates. SIZE: 5000 characters, and writing this field REPLACES the whole value. Plan to the cap before composing; the response's field_budgets entry tells you how much room is left.
URL of a rendered 2x2 grid of four sample posts, all in ONE of the treatments from the design_style table — the first look the user kept when they ran /brand-setup. Written by /brand-setup at the end of that run; the app shows it so someone can SEE their look instead of reading it.
Social strategy doc as MARKDOWN — the goal we're working toward, who the posts are for, the brand voice, what we're trying right now, what we won't do, cadence and mix, plus a running log of experiments and what we learned. This is the layer an agency revisits each quarter. Write plain markdown (## headings, - bullets, | tables |); the app renders it in a rich-text editor, so no HTML tags — they show up as literal text and spend the size budget without adding meaning. Content pillars, caption rules and calls to action go here too. How graphics look goes in design_style. SIZE: 6000 characters, and writing this field REPLACES the whole doc. A longer value is still saved, but it comes back with a warning you have to act on in the same turn — so plan the doc to the cap BEFORE you compose it, rather than writing long and compacting after. The response's field_budgets entry for this field tells you exactly how much room is left.
Workspace name
Workspace description
Industry category
Business website URL
Content language as an ISO 639-1 code (e.g. 'en', 'fr', 'es').
The user's customized per-platform caption-writing instructions (empty when none set). Keys are canonical platform names (e.g. 'instagram', 'linkedIn') plus 'common' (applies to all platforms). Follow the matching entry when writing a caption or platform_overrides caption — the user's instructions ALWAYS outrank generic platform best practices. Update via PATCH (merge semantics). Returned by get_workspace only, not the list endpoint.
Show child attributes
Show child attributes
The workspace's own dated moments: launches, openings, sales, events (e.g. {'name': 'Hope Shop opening', 'date': '2026-10-10', 'kind': 'opening'}). They show up in list_upcoming_moments, and a caption that names one is dated to it. At most 20.
Show child attributes
Show child attributes
The workspace's IANA timezone (e.g. 'Europe/Warsaw'). Posting-schedule slots and *_local times use it, and holidays in moments come from its country. Null when unset: times are then UTC and holidays default to the US. Set with update_workspace.
Last update time
Id of the undo record this write created. Pass it to revert_revisions to put the record back exactly as it was before this call. Set only on the response to a write; null when you read the record.
One entry per changed website that unpublished posts still carry. affected_unpublished says how many. suggested is the exact update_posts call that fixes them: tell the user the count and offer it. Empty when nothing needs follow-up.
Show child attributes
Show child attributes