Overview
Posts
Platforms
Workspace
Social Accounts
curl -X GET https://app.trypost.it/api/posts \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"content": "Excited to announce our new feature!",
"media": [],
"status": "scheduled",
"scheduled_at": "2025-01-15 10:00:00",
"published_at": null,
"platforms": [
{
"id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"platform": "linkedin",
"content_type": "linkedin_post",
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "John Doe",
"display_username": "johndoe",
"display_avatar": "https://media.licdn.com/.../avatar.jpg",
"social_account": {
"id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
"platform": "linkedin",
"display_name": "John Doe",
"username": "johndoe",
"is_active": true,
"status": "connected"
}
}
],
"labels": [],
"created_at": "2025-01-14 09:00:00",
"updated_at": "2025-01-14 09:00:00"
}
],
"links": {
"first": "https://app.trypost.it/api/posts?page=1",
"last": "https://app.trypost.it/api/posts?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"to": 1,
"last_page": 1,
"per_page": 15,
"total": 1,
"path": "https://app.trypost.it/api/posts",
"links": [
{ "url": null, "label": "« Previous", "page": null, "active": false },
{ "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
{ "url": null, "label": "Next »", "page": null, "active": false }
]
}
}
Posts
List posts
List all posts for the current workspace, paginated 15 per page.
GET
/
posts
curl -X GET https://app.trypost.it/api/posts \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"content": "Excited to announce our new feature!",
"media": [],
"status": "scheduled",
"scheduled_at": "2025-01-15 10:00:00",
"published_at": null,
"platforms": [
{
"id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"platform": "linkedin",
"content_type": "linkedin_post",
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "John Doe",
"display_username": "johndoe",
"display_avatar": "https://media.licdn.com/.../avatar.jpg",
"social_account": {
"id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
"platform": "linkedin",
"display_name": "John Doe",
"username": "johndoe",
"is_active": true,
"status": "connected"
}
}
],
"labels": [],
"created_at": "2025-01-14 09:00:00",
"updated_at": "2025-01-14 09:00:00"
}
],
"links": {
"first": "https://app.trypost.it/api/posts?page=1",
"last": "https://app.trypost.it/api/posts?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"to": 1,
"last_page": 1,
"per_page": 15,
"total": 1,
"path": "https://app.trypost.it/api/posts",
"links": [
{ "url": null, "label": "« Previous", "page": null, "active": false },
{ "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
{ "url": null, "label": "Next »", "page": null, "active": false }
]
}
}
Documentation Index
Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
Use this file to discover all available pages before exploring further.
Request
Page number for pagination. Defaults to
1.Response
Returns posts ordered byscheduled_at descending (latest first), 15 per page.
Show child attributes
Show child attributes
UUID of the post.
The post text body. May be
null for drafts.Media items attached to the post. Each item has
id, path, url, type (image | video | document), mime_type, original_filename. Empty array if none.One of:
draft, scheduled, publishing, published, partially_published, failed.Scheduled publish time in
Y-m-d H:i:s format. May be null for unscheduled drafts.Publish completion time in
Y-m-d H:i:s format. null until fully published.One entry per
post_platform (one social account targeted by this post).Show child attributes
Show child attributes
UUID of the post_platform row. Use this in
PUT /posts/{post} to enable/disable platforms.Platform identifier — e.g.
linkedin, linkedin-page, x, facebook, instagram, instagram-facebook, tiktok, youtube, threads, pinterest, bluesky, mastodon.Per-platform publish status:
pending, publishing, published, or failed.Whether this platform will be published to.
Public URL of the published post.
null until published successfully.Per-platform publish time in
Y-m-d H:i:s format. null until published.Error reason from the last failed publish attempt.
null on success.Snapshot of the social account’s display name (preserved if the account is later disconnected).
Snapshot of the username/handle.
Snapshot URL of the avatar.
The connected social account. Fields:
id, platform, display_name, username, is_active, status (connected | disconnected | token_expired).Workspace labels attached to the post. Each item has
id, name, color, created_at, updated_at.Creation timestamp in
Y-m-d H:i:s format.Last update timestamp in
Y-m-d H:i:s format.curl -X GET https://app.trypost.it/api/posts \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"content": "Excited to announce our new feature!",
"media": [],
"status": "scheduled",
"scheduled_at": "2025-01-15 10:00:00",
"published_at": null,
"platforms": [
{
"id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"platform": "linkedin",
"content_type": "linkedin_post",
"status": "pending",
"enabled": true,
"platform_url": null,
"published_at": null,
"error_message": null,
"display_name": "John Doe",
"display_username": "johndoe",
"display_avatar": "https://media.licdn.com/.../avatar.jpg",
"social_account": {
"id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
"platform": "linkedin",
"display_name": "John Doe",
"username": "johndoe",
"is_active": true,
"status": "connected"
}
}
],
"labels": [],
"created_at": "2025-01-14 09:00:00",
"updated_at": "2025-01-14 09:00:00"
}
],
"links": {
"first": "https://app.trypost.it/api/posts?page=1",
"last": "https://app.trypost.it/api/posts?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"to": 1,
"last_page": 1,
"per_page": 15,
"total": 1,
"path": "https://app.trypost.it/api/posts",
"links": [
{ "url": null, "label": "« Previous", "page": null, "active": false },
{ "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
{ "url": null, "label": "Next »", "page": null, "active": false }
]
}
}
⌘I