From e459448bb660e356d9237d2086f56f61d99e3836 Mon Sep 17 00:00:00 2001
From: necoline <necoline@together.ai>
Date: Tue, 10 Feb 2026 17:45:31 +0100
Subject: [PATCH] Update descriptions for endpoints

---
 openapi.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openapi.yaml b/openapi.yaml
index b066537..6702d23 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -1177,7 +1177,7 @@ paths:
     post:
       tags: ['Chat']
       summary: Create chat completion
-      description: Query a chat model.
+      description: Generate a model response for a given chat conversation. Supports single queries and multi-turn conversations with system, user, and assistant messages.
       x-codeSamples:
         - lang: Python
           label: Together AI SDK (v1)
@@ -1322,7 +1322,7 @@ paths:
     post:
       tags: ['Completion']
       summary: Create completion
-      description: Query a language, code, or image model.
+      description: Generate text completions for a given prompt using a language, code, or image model.
       x-codeSamples:
         - lang: Python
           label: Together AI SDK (v1)
@@ -1459,7 +1459,7 @@ paths:
     post:
       tags: ['Embeddings']
       summary: Create embedding
-      description: Query an embedding model for a given string of text.
+      description: Generate vector embeddings for one or more text inputs. Returns numerical arrays representing semantic meaning, useful for search, classification, and retrieval.
       x-codeSamples:
         - lang: Python
           label: Together AI SDK (v1)
@@ -3301,7 +3301,7 @@ paths:
     post:
       tags: ['Rerank']
       summary: Create a rerank request
-      description: Query a reranker model
+      description: Rerank a list of documents by relevance to a query. Returns a relevance score and ordering index for each document.
       x-codeSamples:
         - lang: Python
           label: Together AI SDK (v1)