---
title: "Deployment Chat Completion"
method: POST
path: "/api/v1/deploy/{deployment_id}/chat/completions"
tags: ["deployments", "inference"]
---

# Deployment Chat Completion

`POST /api/v1/deploy/{deployment_id}/chat/completions`

## Request

- Base URL: `https://api.trajectory.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.trajectory.ai/api/v1/deploy/{deployment_id}/chat/completions`
- Auth: HTTP bearer

Test this exact deployment without changing the slug's production target.

## Path parameters

- `deployment_id` string, required

## Headers

- `X-Trajectory-Id` string, required
- `Idempotency-Key` string, nullable
- `X-API-Key` string, nullable

## Request body

- ChatCompletionRequest
  - `model` string, required
  - `messages` ChatMessage[], required
    - `role` string, required
    - `content` union
      - string
      - object[]
  - `stream` boolean, nullable
  - `disable_thinking` boolean, nullable
  - `temperature` number, nullable
  - `max_tokens` integer, nullable: Maximum generated tokens, including reasoning tokens when emitted.
  - `top_p` number, nullable

## Response `200`

Successful Response

- ChatCompletionResponse
  - `id` string, required
  - `object` string, required
  - `created` integer, required
  - `model` string, required
  - `choices` ChatCompletionChoice[], required
    - `index` integer, required
    - `message` ChatCompletionResponseMessage, required
      - `role` string, required
      - `content` string, nullable, required
      - `tool_calls` ChatCompletionResponseToolCall[], nullable
        - `id` string, required
        - `type` 'function', required
        - `function` ChatCompletionResponseFunction, required
          - `name` string, required
          - `arguments` string, required
      - `function_call` ChatCompletionResponseFunction
        - `name` string, required
        - `arguments` string, required
    - `finish_reason` string, nullable
    - `logprobs` ChatCompletionChoiceLogprobs
      - `content` ChatCompletionTokenLogprob[], nullable
        - `token` string, required
        - `logprob` number, required
        - `bytes` integer[], nullable
        - `top_logprobs` ChatCompletionTokenTopLogprob[], required
          - `token` string, required
          - `logprob` number, required
          - `bytes` integer[], nullable
      - `refusal` ChatCompletionTokenLogprob[], nullable
        - `token` string, required
        - `logprob` number, required
        - `bytes` integer[], nullable
        - `top_logprobs` ChatCompletionTokenTopLogprob[], required
          - `token` string, required
          - `logprob` number, required
          - `bytes` integer[], nullable
  - `usage` Usage
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `completion_tokens_details` CompletionTokensDetails
      - `accepted_prediction_tokens` integer, nullable
      - `audio_tokens` integer, nullable
      - `reasoning_tokens` integer, nullable
      - `rejected_prediction_tokens` integer, nullable
    - `prompt_tokens_details` PromptTokensDetails
      - `audio_tokens` integer, nullable
      - `cached_tokens` integer, nullable

## Changes

- **2026-10-31** `7b218d495d5c`: 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2026-10-23** `a99a7b2a5444`: 1 info
  - added the new optional request property `disable_thinking`
- **2026-10-15** `b6eb5ddf06a9`: 2 info
  - request property `stream` list-of-types was widened by adding types `null` to media type `application/json`
  - added the optional property `choices/items/message/function_call` to the response with the `200` status
- **2026-10-02** `a0e690b1ef27`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/deploy/:deployment_id/chat/completions/post.md)

---

[API](https://skmtc.dev/trajectory/apis/trajectory-api.md) - [All operations](https://skmtc.dev/trajectory/apis/trajectory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trajectory/apis/trajectory-api/revisions/5b5a8ae4b4a4?raw)