Posts

Upsert a post

Create a new post / knowledge article or update the existing one whose externalId matches the body. Embeddings are generated synchronously so the post is immediately retrievable by chat and search. Required: externalId, title, content (markdown or plain text). Optional: author, publishedAt (ISO 8601), url, tags, category. Use this for help-center articles, FAQ entries, or arbitrary brand content that should be answerable via chat. For bulk backfills prefer POST /posts/bulk. Idempotent on externalId.

post/posts

Request

  • Base URL: https://api.savanto.ai
  • URL: https://api.savanto.ai/posts
  • Auth: HTTP bearer

Request body

idstring required
titlestring required
contentstring
searchableTextstring
excerptstring
postTypestring
status'publish' | 'draft' | 'private' | 'pending'
authorIdstring
authorNamestring
publishedAtstring nullable
categoriesstring[]
tagsstring[]
urlstring
featuredImagestring nullable
sourcestring
indexStatus'active' | 'hidden' | 'disabled'
metadataobject
attributesobject nullable

Response

Post upserted successfully

object'post' required
requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.