first commit

docs/openapi/paths/integrations/anthropic/messages.yaml

@@ -0,0 +1,119 @@
+# Anthropic Integration - Messages API Endpoints
+
+messages:
+  post:
+    operationId: anthropicCreateMessage
+    summary: Create message (Anthropic format)
+    description: |
+      Creates a message using Anthropic Messages API format.
+      Supports streaming via SSE.
+
+      **Async inference:** Send `x-bf-async: true` to submit the request as a background job and receive a job ID immediately. Poll with `x-bf-async-id: <job-id>` to retrieve the result. When the job is still processing, the response will have an empty `content` array. When completed, `content` will contain the full result. See [Async Inference](/features/async-inference) for details.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: x-bf-async
+      in: header
+      required: false
+      schema:
+        type: string
+        enum: ["true"]
+      description: Set to `true` to submit this request as an async job. Returns immediately with a job ID. Not 
+        compatible with streaming.
+    - name: x-bf-async-id
+      in: header
+      required: false
+      schema:
+        type: string
+      description: Poll for results of a previously submitted async job by providing the job ID returned from the 
+        initial async request.
+    - name: x-bf-async-job-result-ttl
+      in: header
+      required: false
+      schema:
+        type: integer
+        default: 3600
+      description: Override the default result TTL in seconds. Results expire after this duration from completion time.
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageResponse'
+          text/event-stream:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicStreamEvent'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+
+# Wildcard path for extended messages endpoints (e.g., /v1/messages/batches)
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []
+messages-wildcard:
+  post:
+    operationId: anthropicCreateMessageWildcard
+    summary: Create message (Anthropic format) - wildcard
+    description: |
+      Handles extended messages API paths.
+    tags:
+    - Anthropic Integration
+    parameters:
+    - name: path
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Extended path
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageRequest'
+    responses:
+      '200':
+        description: Successful response
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicMessageResponse'
+          text/event-stream:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/messages.yaml#/AnthropicStreamEvent'
+      '400':
+        description: Bad request
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+      '500':
+        description: Internal server error
+        content:
+          application/json:
+            schema:
+              $ref: '../../../schemas/integrations/anthropic/common.yaml#/AnthropicError'
+    security:
+    - BearerAuth: []
+    - BasicAuth: []
+    - VirtualKeyAuth: []
+    - ApiKeyAuth: []