Posts

Get a post

One post with its variants, statuses and publish results.

GEThttps://traceeai.com/api/v1/posts/{postId}

CLI:tracee posts get·MCP:postsaction get

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Path parameters

postIdstringrequired
uuid

Response

Errors

200The post.Post
- idstringrequired
  uuid
- titlestringrequired
- bodystringrequired
- linkUrlstring | nullrequired
- utmCampaignstringrequired
  The utm_campaign every link in the post carries.
- statusstringrequired
  Available options:draftpending_approvalapprovedrejectedscheduledpublishedpartially_publishedfailedremoved
- scheduledForstring | nullrequired
  date-time
- plannedForstring | nullrequired
  date-time
- createdBystringrequired
  Who made it: a person's email or an agent's name.
- createdViastringrequired
  Available options:agentapp
- createdAtstringrequired
  date-time
- updatedAtstringrequired
  date-time
- mediaobject[]required
  The post's own media.
- threadobject[]required
  Follow-up parts every channel sends unless it has its own.
- repeatobject | nullrequired
- repeatedFromstring | nullrequired
  The post this one is a repeat of.
  uuid
- variantsobject[]required
  One per channel.

{ "id": "<string>", "title": "<string>", "body": "<string>", "linkUrl": "<string>", "utmCampaign": "<string>", "status": "draft", "scheduledFor": "<string>", "plannedFor": "<string>", "createdBy": "<string>", "createdVia": "agent", "createdAt": "<string>", "updatedAt": "<string>", "media": [ { "id": "<string>", "url": "<string>", "kind": "image" } ], "thread": [ { "body": "<string>", "mediaIds": [], "delayMinutes": "<integer>", "media": [ { "id": "<string>", "url": "<string>", "kind": "image" } ] } ], "repeat": { "everyDays": "<integer>", "until": "<string>" }, "repeatedFrom": "<string>", "variants": [ { "id": "<string>", "channelId": "<string>", "platform": "linkedin", "accountName": "<string>", "body": "<string>", "linkUrl": "<string>", "media": [ { "id": "<string>", "url": "<string>", "kind": "image" } ], "brandIssues": [], "status": "draft", "platformPostId": "<string>", "platformPostUrl": "<string>", "publishedAt": "<string>", "error": "<string>", "settings": {}, "thread": [ { "body": "<string>", "mediaIds": [], "delayMinutes": "<integer>", "media": [ { "id": "<string>", "url": "<string>", "kind": "image" } ] } ], "parts": [ { "position": "<integer>", "status": "<string>", "platformPostUrl": "<string>", "publishedAt": "<string>", "error": "<string>" } ] } ] }