Create a conversation

Create a new conversation, optionally with an initial user message and content fragments.

post/api/w/{wId}/assistant/conversations

Path parameters

wIdstring required

ID of the workspace

Request body

titlestring nullable

visibility'unlisted' | 'deleted' | 'test'

spaceIdstring nullable

contentFragmentsobject[]

selectedSpaceIdsstring[]

skipToolsValidationboolean

Response

Successfully created conversation

Changes

Changed in 17 of the 80 revisions of this API.2327

Aug 21, 2026b40d30e43ad43See the full diff
- ●
  added the new auto_complex enum value to the conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/modelResolutionMethod response property for the response status 200
  response-property-enum-value-added
- ●
  added the new auto_fast enum value to the conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/modelResolutionMethod response property for the response status 200
  response-property-enum-value-added
- ●
  added the new fair_use_downgrade enum value to the conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/modelResolutionMethod response property for the response status 200
  response-property-enum-value-added
Aug 18, 202637794681a73d1See the full diff
- ○
  added the new optional request property metadata/useDatabaseFileSystem
  new-optional-request-property
Aug 6, 20265834d690c29d2See the full diff
- ●
  removed the optional property contentFragments/items/skipDataSourceIndexing from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateContentFragment]/skipDataSourceIndexing from the response with the 200 status
  response-optional-property-removed
Aug 3, 2026c056bd9490bf4See the full diff
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/branchId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateCompactionMessage]/branchId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateUserMessage]/branchId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property message/branchId to the response with the 200 status
  response-optional-property-added
Aug 3, 2026d9d86878ec8a2See the full diff
- ●
  removed the optional property conversation/allOf[subschema #2]/branchId from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateCompactionMessage]/branchId from the response with the 200 status
  response-optional-property-removed
Jul 31, 2026baec3b07fb012See the full diff
- ○
  added the optional property contentFragments/items/processedPath to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateContentFragment]/processedPath to the response with the 200 status
  response-optional-property-added
Jul 20, 202689dbf1251af24See the full diff
- ○
  added the new optional request property message/context/selectedSpaceIds
  new-optional-request-property
- ○
  added the new optional request property selectedSpaceIds
  new-optional-request-property
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateUserMessage]/context/selectedSpaceIds to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property message/context/selectedSpaceIds to the response with the 200 status
  response-optional-property-added
Jul 17, 202650e23587026b4See the full diff
- ●
  removed the request property message/context/selectedSpaceIds
  request-property-removed
- ●
  removed the request property selectedSpaceIds
  request-property-removed
- ●
  removed the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateUserMessage]/context/selectedSpaceIds from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property message/context/selectedSpaceIds from the response with the 200 status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 15, 20268bbe27ffe9984See the full diff
- ○
  added the new optional request property message/context/selectedSpaceIds
  new-optional-request-property
- ○
  added the new optional request property selectedSpaceIds
  new-optional-request-property
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateUserMessage]/context/selectedSpaceIds to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property message/context/selectedSpaceIds to the response with the 200 status
  response-optional-property-added
Jul 10, 202650e23587026b12See the full diff
- ●
  removed the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/requestedModel from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/modelResolutionMethod to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property conversation/allOf[subschema #2]/content/items/items/oneOf[PrivateAgentMessage]/resolvedModel to the response with the 200 status
  response-optional-property-added

Full history (17 revisions)