Changelog

1.3.1

Documentation only — no API behavior changed.

• The Post schema in the API reference now lists every field the API returns (creator, title, summary, description, tags, engagement, postedAt, createdAt, updatedAt, lastRefreshedAt), so generated clients keep them. The legacy vibe object is documented as deprecated; use scores and sentimentMix.
• GET /me and GET /insights responses are now fully typed in the reference.
• Example payloads that showed siftsyScore on a 0–100 scale (71, 31) are corrected to the 1–10 scale the API actually returns. Analysis commentAnalysis.scores examples now include scoreVersion and siftsyScore.
• Clarified when POST /analyses runs as a job: only search with mode: ai (the default) or selections over 100 posts. mode: keyword stays a synchronous 201 snapshot.
• Clarified paths: comments.path is relative to the base URL (…/v1/client); the Location header on POST /analyses is a host path that already includes /v1/client.
• 409 analysis_not_ready is documented on GET /analyses/{analysisId}/comments (where it is returned) rather than on GET /posts/{postId}/analysis/comments.