Post generation - YALG Developer Docs

Post generation jobs retrieve relevant workspace knowledge and turn a brief into a draft through YALG’s AI workflow. If no brief is supplied, autopilot can select a suitable seed source.

Create a job

curl https://api.yalg.ai/v1/post-generation \
  -H "x-api-key: $YALG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brief": "Share what we learned from simplifying onboarding",
    "pinnedSourceIds": ["123e4567-e89b-12d3-a456-426614174000"],
    "excludedSourceIds": [],
    "platform": "linkedin"
  }'

The response includes the job ID, current status, and—after retrieval—the separate knowledgeTrace provenance. Provenance is not inserted into the published draft.

Run the pipeline

Some integrations create a job and then explicitly run it:

POST /v1/post-generation/{id}/run

Check job status

GET /v1/post-generation/{id}

Poll at a reasonable interval and stop when the job reaches a terminal state.

Validate generated content

POST /v1/post-generation/{id}/validate

Validation creates the resulting post when the job is ready.

Regenerate or reject

Use these endpoints for review workflows:

POST /v1/post-generation/{id}/regenerate
POST /v1/post-generation/{id}/reject

Both require a reason in the request body.

​Create a job

​Run the pipeline

​Check job status

​Validate generated content

​Regenerate or reject

Create a job

Run the pipeline

Check job status

Validate generated content

Regenerate or reject