---
title: "POST /ace/{ace_uid}/v1/chat/completions"
method: POST
path: "/ace/{ace_uid}/v1/chat/completions"
tags: ["ace"]
---

# POST /ace/{ace_uid}/v1/chat/completions

`POST /ace/{ace_uid}/v1/chat/completions`

## Request

- Base URL: `https://api.timbal.ai`
- URL: `https://api.timbal.ai/ace/{ace_uid}/v1/chat/completions`
- Auth: HTTP bearer

OpenAI-compatible chat completions endpoint for an ACE.

## Path parameters

- `ace_uid` string, uuid, required

## Response `200`

Upstream response (JSON or SSE depending on `stream`)

## Other responses

- `400`: Bad request
- `401`: Missing or invalid credentials
- `402`: Credits limit exceeded
- `404`: ACE not found
- `500`: Upstream provider error

## Changes

- **2026-04-24** `f24cc7de524c`: 1 info
  - endpoint added
- **2026-03-16** `eb2c08128881`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/ace/:ace_uid/v1/chat/completions/post.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) - [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/revisions/dd7e398ce0d3?raw)