Send async message

Create and send a new message to a session asynchronously, starting the session if needed and returning immediately.

post/session/{sessionID}/prompt_async

Path parameters

sessionIDstring required

Session ID

directorystring

messageIDstring

agentstring

noReplyboolean

toolsobject

@deprecated tools and permissions have been merged, you can set permissions on the session itself now

systemstring

variantstring

excludeHistoryboolean

Prompt accepted

Changed in 7 of the 102 revisions of this API.44

Apr 29, 2026ba1ceff8b2ff1See the full diff
- ○
  added the new optional request property excludeHistory
  new-optional-request-property
Apr 29, 20263e3822f627bd1See the full diff
- ●
  removed the request property excludeHistory
  request-property-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 29, 2026ba1ceff8b2ff1See the full diff
- ○
  added the new optional request property excludeHistory
  new-optional-request-property
Apr 28, 20263e3822f627bd1See the full diff
- ●
  removed the request property excludeHistory
  request-property-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 28, 2026ba1ceff8b2ff1See the full diff
- ○
  added the new optional request property excludeHistory
  new-optional-request-property
Feb 12, 20267eb1c31fb9381See the full diff
- ○
  added the new optional request property format
  new-optional-request-property
Jan 20, 2026c7ae6a68e4fb2See the full diff
- ●
  removed the request property excludeHistory
  request-property-removed
- ●
  removed the request property format
  request-property-removed
This revision also has 36 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog