Posts - YALG Developer Docs

Posts are LinkedIn-ready content records that can be drafted, scheduled, published, or enriched with media.

Create a draft

curl https://api.yalg.ai/v1/posts \
  -H "x-api-key: $YALG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "A useful lesson I learned about delegation...",
    "tags": ["leadership"]
  }'

Schedule a post

curl https://api.yalg.ai/v1/posts/schedule \
  -H "x-api-key: $YALG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postId": "123e4567-e89b-12d3-a456-426614174000",
    "date": "2026-07-01",
    "time": "09:00"
  }'

Publish or mark published

Use YALG publishing when available:

POST /v1/posts/{id}/publish

Use mark-published when another system published the post and YALG should record the outcome:

PATCH /v1/posts/{id}/mark-published

Manage media

Posts support image, video, and carousel media operations:

PATCH /v1/posts/{id}/upload-image
PATCH /v1/posts/{id}/upload-video
PATCH /v1/posts/{id}/upload-carousel
GET /v1/posts/{id}/image
GET /v1/posts/{id}/video
GET /v1/posts/{id}/carousel
DELETE /v1/posts/{id}/image
DELETE /v1/posts/{id}/video
DELETE /v1/posts/{id}/carousel

Regenerate tags

PATCH /v1/posts/{id}/regenerate-tags

Use this after changing post content or importing content from another system.

​Create a draft

​Schedule a post

​Publish or mark published

​Manage media

​Regenerate tags

Create a draft

Schedule a post

Publish or mark published

Manage media

Regenerate tags