Ask for changes to a LinkedIn draft

Rewrite a draft from a request in words, as a new unapproved version. Send the version you read as expected_revision_id; a newer one answers 409. A change a person already approved is refused.

POSThttps://app.trygtm.com/api/v1/linkedin/drafts/{item_id}/revise

Scope: write
Cost: 100 action credits per unit — ai.linkedin.post
MCP tool: revise_linkedin_draft

Path parameters

item_idstringrequired: The draft's id (itemId), from list_linkedin_drafts or a drafting tool.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

expected_revision_idstringrequired: The version you read (revision.id from get_linkedin_draft). A newer version is refused as a conflict.
requeststringrequired: What to change, in the person's words.
save_as_lessonbooleanoptionaldefault: false: Also keep the request as a preference for every later draft for this profile. Only when the person says it applies from now on.

Request

curl -X POST https://app.trygtm.com/api/v1/linkedin/drafts/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/revise \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_revision_id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
    "request": "…"
  }'

Response

{
  "data": {
    "item_id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
    "revision_id": "8e9f0a1b-2c3d-4e4f-8a5b-6c7d8e9f0a1b",
    "review_path": "/linkedin/review/2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
    "next": "Nothing is published or changed on LinkedIn until a person with LinkedIn access in the workspace approves the exact change on the LinkedIn screen, or the account's automatic posting (which a person turned on there) schedules a post it wrote.",
    "lesson_id": null
  }
}