Chat

Create a named chat session

Changed on

Creates a titled agent session. Setup may occur on the first prompt. Idempotent via the Idempotency-Key header — a duplicate submit by the same authenticated caller within the 24-hour idempotency window returns the already-created session instead of a second one. Reusing the same key with a different request body is a 422 idempotency_key_reused.

post/assistant/chat/sessions

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/assistant/chat/sessions
  • Auth
    HTTP bearer

Headers

idempotency-keystring

Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.

Example:b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f

Request body

titlestring required
descriptionstring
agentstring

Response

Created session

Changes