@@ -6140,6 +6140,10 @@ components:
                                 index: 0
                                 object: 'embedding'
                               properties:
+                                document_index:
+                                  description: 'Index of the source document when `input` was a list of documents (contextual embeddings). Absent otherwise.'
+                                  example: 0
+                                  type: 'integer'
                                 embedding:
                                   anyOf:
                                     - items:
@@ -43627,6 +43631,19 @@ paths:
                         minLength: 1
                         type: 'string'
                       type: 'array'
+                    - description: 'Documents to embed with document-level context: each item is an ordered list of chunk strings. One embedding is returned per chunk, in document order, with `document_index` set on each. Only models that support contextual embeddings accept this shape.'
+                      example:
+                        - - 'Paris is the capital of France.'
+                          - 'It sits on the Seine.'
+                        - - 'Berlin is the capital of Germany.'
+                      items:
+                        items:
+                          minLength: 1
+                          type: 'string'
+                        minItems: 1
+                        type: 'array'
+                      minItems: 1
+                      type: 'array'
                     - items:
                         type: 'number'
                       type: 'array'
@@ -43680,7 +43697,7 @@ paths:
                   description: 'Text, token, or multimodal input(s) to embed'
                   example: 'The quick brown fox jumps over the lazy dog'
                 input_type:
-                  description: 'The type of input (e.g. search_query, search_document)'
+                  description: 'The type of input (e.g. search_query, search_document). Document-chunk input (`string[][]`) is only valid with a document input type.'
                   example: 'search_query'
                   type: 'string'
                 model:
@@ -43746,6 +43763,10 @@ paths:
                         index: 0
                         object: 'embedding'
                       properties:
+                        document_index:
+                          description: 'Index of the source document when `input` was a list of documents (contextual embeddings). Absent otherwise.'
+                          example: 0
+                          type: 'integer'
                         embedding:
                           anyOf:
                             - items: