[GET] List posts
Method: GET
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts?page=1
Authorization: Bearer
Response:
{
data: [
{
"id: 3,
uuid"": ""8eb4e98d-2b93-44bd-a664-7a6438eff67b"","
status: "draft",
accounts: [],
versions: [
{
account_id: 0,
is_original: true,
content: [
{
body: "",
media: [],
url: ""
}
],
options: {
tiktok: {
privacy_level: {
account-0: null
},
allow_comments: {
account-0: false
},
allow_duet: {
account-0: false
},
allow_stitch: {
account-0: false
},
content_disclosure: {
account-0: false
},
brand_organic_toggle: {
account-0: false
},
brand_content_toggle: {
account-0: false
},
},
youtube: {
title: null,
status: "public"
},
linkedin: {
visibility: "PUBLIC"
},
mastodon: {
sensitive: false
},
instagram: {
type: "post"
},
pinterest: {
title: null,
link: null,
boards: {
account-0: null
}
},
facebook_page: {
type: "post"
}
}
}
],
tags: [
{
id: 2,
uuid: "f9288040-0d50-4e40-83d6-10ef6dd31d9d",
name: "release",
hex_color: "#111827"
},
{
id: 3,
uuid: "a09367a5-dfc1-43d7-9557-70eb93e01e01",
name: "news",
hex_color: "#38bdf8"
}
],
user: {
name: "Test User"
},
scheduled_at: null,
published_at: null,
created_at: "2024-03-29 15:26:06",
trashed: false
},
{
"id: 2,
uuid"": ""69288ffd-d4ef-4666-9320-4b9e120694fc"","
status: "published",
accounts: [
{
id: 3,
uuid: "ed1d7f93-ebca-4217-957c-a25fbb2c1075",
name: "Dottie user,
username: "dottieuser",
image: "https://example.com/avatar/dottie.jpg",
provider: "twitter",
data: null,
authorized: true,
created_at: "2024-03-29 09:55:31",
external_url: "https://twitter.com/dotsimpleapp/status/23424241115453465",
errors: []
}
],
versions: [
{
account_id: 0,
is_original: true,
content: [
{
body: "<div>Buy my wonderful product! 💻✨</div>",
media: [
{
id: "1",
name: "blue.png",
mime_type: "image/png",
type: "image",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
thumb_url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
is_video: false,
created_at: "2024-03-29 15:33:23"
}
],
url: ""
}
],
options: {
tiktok: {
privacy_level: {
account-0: null
},
allow_comments: {
account-0: false
},
allow_duet: {
account-0: false
},
allow_stitch: {
account-0: false
},
content_disclosure: {
account-0: false
},
brand_organic_toggle: {
account-0: false
},
brand_content_toggle: {
account-0: false
},
},
youtube: {
title: null,
status: "public"
},
linkedin: {
visibility: "PUBLIC"
},
mastodon: {
sensitive: false
},
instagram: {
type: "post"
},
pinterest: {
title: null,
link: null,
boards: {
account-0: null
}
},
facebook_page: {
type: "post"
}
}
}
],
tags: [],
user: {
name: "First Last"
},
scheduled_at: "2024-03-29 09:55:57",
published_at: "2024-03-29 09:56:03",
created_at: "2024-03-29 09:55:34",
trashed: false
},
{
"id: 1,
uuid"": ""b1b06706-ef95-42b7-8ac8-d648dc9a9d65"","
status: "published",
accounts: [
{
id: 2,
uuid: "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
name: "First Last",
username: "firstlast",
image: null,
provider: "linkedin",
data: null,
authorized: true,
created_at: "2024-03-29 09:49:22",
external_url: "https://linkedin.com/feed/update/urn:li:share:43536647554322",
errors: []
},
{
id: 1,
uuid: "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
name: "DotSimple",
username: "dotsimpleuser",
image: "https://example.com/avatar/dotsimple.jpg",
provider: "facebook_page",
data: {
suffix: {
value: "Page",
edited: false
}
},
authorized: true,
created_at: "2024-03-27 11:30:45",
external_url: "https://facebook.com/3432042343434323/7179414779038416896",
errors: []
}
],
versions: [
{
account_id: 0,
is_original: true,
content: [
{
body: "<div>Optimize your team's social media strategy with Dotsimple.</div>",
media: [
{
id: "2",
name: "tea-reduced-file-size.mp4",
mime_type: "video/mp4",
type: "video",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
thumb_url: "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
is_video: true,
created_at: "2024-03-29 15:33:32"
}
],
url: ""
}
],
options: {
tiktok: {
privacy_level: {
account-0: null
},
allow_comments: {
account-0: false
},
allow_duet: {
account-0: false
},
allow_stitch: {
account-0: false
},
content_disclosure: {
account-0: false
},
brand_organic_toggle: {
account-0: false
},
brand_content_toggle: {
account-0: false
},
},
youtube: {
title: null,
status: "public"
},
linkedin: {
visibility: "PUBLIC"
},
mastodon: {
sensitive: false
},
instagram: {
type: "post"
},
pinterest: {
title: null,
link: null,
boards: {
account-0: null
}
},
facebook_page: {
type: "post"
}
}
}
],
tags: [
{
id: 1,
uuid: "2323e1eb-b3a6-4183-990d-4d5afea04835",
name: "motivation",
hex_color: "#60a5fa"
}
],
user: {
name: "Firstname Lastname"
},
scheduled_at: "2024-03-29 09:50:56",
published_at: "2024-03-29 09:51:10",
created_at: "2024-03-29 09:50:46",
trashed: false
}
],
links: {
first: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
last: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
prev: null,
next: null
},
meta: {
current_page: 1,
from: 1,
last_page: 1,
links: [
{
url: null,
label: "« Previous",
active: false
},
{
url: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
label: "1",
active: true
},
{
url: null,
label: "Next »",
active: false
}
],
path: "https://app.dotsimple.io/app/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts",
per_page: 20,
to: 3,
total: 3
}
}[GET] Get a post
Method: GET
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts/{postUuid}
Authorization: Bearer
Response:
{
"id: 1,
uuid"": ""b1b06706-ef95-42b7-8ac8-d648dc9a9d65"","
status: "published",
accounts: [
{
id: 2,
uuid: "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
name: "First Last",
username: "firstlast",
image: null,
provider: "linkedin",
data: null,
authorized: true,
created_at: "2024-03-29 09:49:22",
external_url: "https://linkedin.com/feed/update/urn:li:share:43536647554322",
errors: []
},
{
id: 1,
uuid: "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
name: "DotSimple",
username: "dotsimplepost",
image: "https://example.com/avatar/dotsimple.jpg",
provider: "facebook_page",
data: {
suffix: {
value: "Page",
edited: false
}
},
authorized: true,
created_at: "2024-03-27 11:30:45",
external_url: "https://facebook.com/3432042343434323/7179414779038416896",
errors: []
}
],
versions: [
{
account_id: 0,
is_original: true,
content: [
{
body: "<div>Optimize your team's social media strategy with DotSimple.</div>",
media: [
{
id: "2",
name: "tea-reduced-file-size.mp4",
mime_type: "video/mp4",
type: "video",
url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
thumb_url: "https://app.dotsimple.io/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
is_video: true,
created_at: "2024-03-29 15:33:32"
}
],
url: ""
}
],
options: {
tiktok: {
privacy_level: {
account-0: null
},
allow_comments: {
account-0: false
},
allow_duet: {
account-0: false
},
allow_stitch: {
account-0: false
},
content_disclosure: {
account-0: false
},
brand_organic_toggle: {
account-0: false
},
brand_content_toggle: {
account-0: false
},
},
youtube: {
title: null,
status: "public"
},
linkedin: {
visibility: "PUBLIC"
},
mastodon: {
sensitive: false
},
instagram: {
type: "post"
},
pinterest: {
title: null,
link: null,
boards: {
account-0: null
}
},
facebook_page: {
type: "post"
}
}
}
],
tags: [
{
id: 1,
uuid: "2323e1eb-b3a6-4183-990d-4d5afea04835",
name: "motivation",
hex_color: "#60a5fa"
}
],
user: {
name: "First Last"
},
scheduled_at: "2024-03-29 09:50:56",
published_at: "2024-03-29 09:51:10",
created_at: "2024-03-29 09:50:46",
trashed: false
}[POST] Create a post
Method: GET
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts
Authorization: Bearer
Body:
{
"date": "2024-05-23",
"time": "15:00",
"timezone": "Europe/Vienna",
"schedule": true,
"schedule_now": true,
"queue": true,
"accounts": [1,2,3],
"tags": [1,2],
"versions": [
{
"account_id": 0,
"is_original": true,
"content": [
{
"body": "This is the content",
"media": [1]
}
],
"options": {
"mastodon": {
"sensitive": false
}
}
}
]
}[PUT] Update a post
Method: PUT
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts/{postUuid}
Authorization: Bearer
Body:
{
"date": "2024-05-23",
"time": "16:00",
"timezone": "Europe/Chisinau",
"accounts": [1,2,3],
"tags": [1,2],
"versions": [
{
"account_id": 0,
"is_original": true,
"content": [
{
"body": "This is the content v2",
"media": [1]
}
],
"options": {
"mastodon": {
"sensitive": false
}
}
}
]
}[POST] Schedule a post
Method: POST
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts/schedule/{postUuid}
Authorization: Bearer
Body:
{
"postNow": true
}Key
postNow
Format
boolean
Required
required
Description
Set to
trueto schedule the post now.
Set to `false' to schedule the post at the set post time.
[POST] Add a post to queue
Method: POST
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts/add-to-queue/{postUuid}
Authorization: Bearer
[POST] Delete a post
Method: DEL
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts/{postUuid}
Authorization: Bearer
[DEL] Delete multiple posts
Method: DEL
Endpoint: https://app.dotsimple.io/app/api/{workspaceUuid}/posts
Authorization: Bearer
Body:
{
"posts": ['8eb4e98d-2b93-44bd-a664-7a6438eff67b', 'b1b06706-ef95-42b7-8ac8-d648dc9a9d65']
}Key
posts
Format
array
Required
required
Description
Array of posts Uuids
Key
posts.*
Format
string
Required
required
Description
Post Uuid