Sign in
chat

Run Headless Agent

post/agents/server/sessions/{session_id}/chat

Path parameters

session_idstring required

Request body

OR

Response

Successful Response

{"stackTrail":"paths:/agents/server/sessions/{session_id}/chat:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

Changed in 9 of the 70 revisions of this API.6243

  • 4016becf04d62See the full diff
    • ○

      added the new optional request property oneOf[subschema #1: LegacyChatSubmitMessage]/messages/items/parts/items/anyOf[subschema #2: ReasoningUIPart]/id

      new-optional-request-property

    • ○

      added the new optional request property oneOf[subschema #2: LegacyChatRegenerateMessage]/messages/items/parts/items/anyOf[subschema #2: ReasoningUIPart]/id

      new-optional-request-property

  • e4bf71c6ae16222See the full diff
    • ▲

      removed ProjectContext TraceContext SessionContext PromptContext PromptVersionContext AgentSpanContext PlaygroundContext CodeEvaluatorContext LlmEvaluatorContext DatasetContext from the oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property oneOf list

      request-property-one-of-removed

    • ▲

      removed ProjectContext TraceContext SessionContext PromptContext PromptVersionContext AgentSpanContext PlaygroundContext CodeEvaluatorContext LlmEvaluatorContext DatasetContext from the oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property oneOf list

      request-property-one-of-removed

    • ○

      mapped value for discriminator key code_evaluator changed from CodeEvaluatorContext to CodeEvaluatorUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key code_evaluator changed from CodeEvaluatorContext to CodeEvaluatorUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key dataset changed from DatasetContext to DatasetUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key dataset changed from DatasetContext to DatasetUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key llm_evaluator changed from LlmEvaluatorContext to LlmEvaluatorUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key llm_evaluator changed from LlmEvaluatorContext to LlmEvaluatorUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key playground changed from PlaygroundContext to PlaygroundUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key playground changed from PlaygroundContext to PlaygroundUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key project changed from ProjectContext to ProjectUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key project changed from ProjectContext to ProjectUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key prompt changed from PromptContext to PromptUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key prompt changed from PromptContext to PromptUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key prompt_version changed from PromptVersionContext to PromptVersionUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key prompt_version changed from PromptVersionContext to PromptVersionUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key session changed from SessionContext to SessionUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key session changed from SessionContext to SessionUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key span changed from AgentSpanContext to SpanUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key span changed from AgentSpanContext to SpanUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key trace changed from TraceContext to TraceUIContext for oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      mapped value for discriminator key trace changed from TraceContext to TraceUIContext for oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property

      request-property-discriminator-mapping-changed

    • ○

      added ProjectUIContext TraceUIContext SessionUIContext PromptUIContext PromptVersionUIContext SpanUIContext PlaygroundUIContext CodeEvaluatorUIContext LlmEvaluatorUIContext DatasetUIContext to the oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/ request property oneOf list

      request-property-one-of-added

    • ○

      added ProjectUIContext TraceUIContext SessionUIContext PromptUIContext PromptVersionUIContext SpanUIContext PlaygroundUIContext CodeEvaluatorUIContext LlmEvaluatorUIContext DatasetUIContext to the oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/ request property oneOf list

      request-property-one-of-added

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 6107b5235c742See the full diff
    • ○

      request property oneOf[subschema #1: LegacyChatSubmitMessage]/contexts/items/oneOf[subschema #12: GraphQLContext]/ deprecated

      request-property-deprecated

    • ○

      request property oneOf[subschema #2: LegacyChatRegenerateMessage]/contexts/items/oneOf[subschema #12: GraphQLContext]/ deprecated

      request-property-deprecated

  • 881c8eca3876110See the full diff
    • ▲

      removed ChatSubmitMessage ChatRegenerateMessage from the request body oneOf list

      request-body-one-of-removed

    • ○

      api operation id run_server_agent_agents_server_sessions__session_id__chat_post removed and replaced with legacyServerAgentChat

      api-operation-id-removed

    • ○

      endpoint deprecated

      endpoint-deprecated

    • ○

      mapped value for key regenerate-message changed from ChatRegenerateMessage to LegacyChatRegenerateMessage from the request discriminator

      request-body-discriminator-mapping-changed

    • ○

      mapped value for key submit-message changed from ChatSubmitMessage to LegacyChatSubmitMessage from the request discriminator

      request-body-discriminator-mapping-changed

    • ○

      added LegacyChatSubmitMessage LegacyChatRegenerateMessage to the request body oneOf list

      request-body-one-of-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 507

      response-non-success-status-added

    This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • eea5907029bd2See the full diff
    • ●

      removed the request property oneOf[subschema #1: ChatSubmitMessage]/contexts/items/oneOf[subschema #2: ProjectContext]/rootSpansOnly

      request-property-removed

    • ●

      removed the request property oneOf[subschema #2: ChatRegenerateMessage]/contexts/items/oneOf[subschema #2: ProjectContext]/rootSpansOnly

      request-property-removed

  • 74accc51bb1622See the full diff
    • ▲

      removed AssistantMessageMetadata from the oneOf[subschema #1: ChatSubmitMessage]/messages/items/metadata request property anyOf list

      request-property-any-of-removed

    • ▲

      removed AssistantMessageMetadata from the oneOf[subschema #2: ChatRegenerateMessage]/messages/items/metadata request property anyOf list

      request-property-any-of-removed

    • ○

      added subschema #1 to the oneOf[subschema #1: ChatSubmitMessage]/messages/items/metadata request property anyOf list

      request-property-any-of-added

    • ○

      added subschema #1 to the oneOf[subschema #2: ChatRegenerateMessage]/messages/items/metadata request property anyOf list

      request-property-any-of-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 2a6261fc25f64See the full diff
    • ○

      added the new optional request property oneOf[subschema #1: ChatSubmitMessage]/messages/items/metadata/anyOf[subschema #1: AssistantMessageMetadata]/turnTraceContext

      new-optional-request-property

    • ○

      added the new optional request property oneOf[subschema #1: ChatSubmitMessage]/turnTraceContext

      new-optional-request-property

    • ○

      added the new optional request property oneOf[subschema #2: ChatRegenerateMessage]/messages/items/metadata/anyOf[subschema #1: AssistantMessageMetadata]/turnTraceContext

      new-optional-request-property

    • ○

      added the new optional request property oneOf[subschema #2: ChatRegenerateMessage]/turnTraceContext

      new-optional-request-property

  • 3636983878f71See the full diff
    • ○

      endpoint added

      endpoint-added

  • c81391216eb51See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 91 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog