Skip to content

Update descriptions for endpoints#208

Merged
blainekasten merged 1 commit intomainfrom
DX-256/improve-endpoint-descriptions
Feb 12, 2026
Merged

Update descriptions for endpoints#208
blainekasten merged 1 commit intomainfrom
DX-256/improve-endpoint-descriptions

Conversation

@necoline
Copy link
Contributor

Summary

  • Updated endpoint descriptions for Chat Completions, Completions, Embeddings, and Rerank to be more descriptive and informative
  • Replaced brief/vague descriptions (e.g., "Query a chat model.") with detailed descriptions that explain what each endpoint does and what it supports

Changes

  • Chat Completions (/chat/completions): Describes conversation support with system, user, and assistant messages
  • Completions (/completions): Clarifies that the endpoint generates text completions for a given prompt
  • Embeddings (/embeddings): Explains vector embeddings, semantic meaning, and common use cases (search, classification, retrieval)
  • Rerank (/rerank): Describes document reranking by relevance with scoring and ordering details

Test plan

  • Verify the OpenAPI spec is still valid
  • Confirm updated descriptions render correctly in generated docs

@github-actions
Copy link

github-actions bot commented Feb 10, 2026

✱ Stainless preview builds

This PR will update the togetherai SDKs with the following commit message.

feat: Update descriptions for endpoints
⚠️ togetherai-openapi studio · code

There was a regression in your SDK.
generate ⚠️

⚠️ togetherai-go studio · code

There was a regression in your SDK.
generate ⚠️lint ✅test ✅

go get github.com/stainless-sdks/togetherai-go@6bb26328effc8b75f0422d05ae5d0a9c41c2e68f
⚠️ togetherai-python studio · code

There was a regression in your SDK.
generate ⚠️build ✅lint ✅test ⏳

pip install https://pkg.stainless.com/s/togetherai-python/7ad438fff1c6c6175d8acfe16ffac7ed9dede2db/together-2.1.1-py3-none-any.whl
⚠️ togetherai-typescript studio · code

There was a regression in your SDK.
generate ⚠️build ✅lint ✅test ✅

npm install https://pkg.stainless.com/s/togetherai-typescript/e7a8aafed811633b2a1c2c19df41fb43fd48ae89/dist.tar.gz
⚠️ togetherai-terraform studio · code

There was a regression in your SDK.
generate ⚠️lint ✅test ✅


This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-02-12 20:25:31 UTC

@blainekasten blainekasten merged commit 0f0fff2 into main Feb 12, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants