openapi: 3.0.3 info: title: OpenPipe Chat Datasets API description: The public API for reporting API calls to OpenPipe version: 0.1.1 servers: - url: https://api.openpipe.ai/api/v1 tags: - name: Datasets paths: /datasets: post: operationId: createDataset description: Create a new dataset. security: - Authorization: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string required: - name additionalProperties: false parameters: [] responses: '200': description: Successful response content: application/json: schema: type: object properties: object: type: string enum: - dataset id: type: string name: type: string created: type: string updated: type: string dataset_entry_count: type: number fine_tune_count: type: number required: - object - id - name - created - updated - dataset_entry_count - fine_tune_count additionalProperties: false default: $ref: '#/components/responses/error' tags: - Datasets get: operationId: listDatasets description: List datasets for a project. security: - Authorization: [] parameters: [] responses: '200': description: Successful response content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: object: type: string enum: - dataset id: type: string name: type: string created: type: string updated: type: string dataset_entry_count: type: number fine_tune_count: type: number required: - object - id - name - created - updated - dataset_entry_count - fine_tune_count additionalProperties: false required: - object - data additionalProperties: false default: $ref: '#/components/responses/error' tags: - Datasets /datasets/{datasetId}: delete: operationId: deleteDataset description: Delete a dataset. security: - Authorization: [] parameters: - name: datasetId in: path required: true schema: type: string responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: string object: type: string enum: - dataset deleted: type: boolean required: - id - object - deleted additionalProperties: false default: $ref: '#/components/responses/error' tags: - Datasets /datasets/{datasetId}/entries: post: operationId: createDatasetEntries description: Add new dataset entries. security: - Authorization: [] requestBody: required: true content: application/json: schema: type: object properties: entries: type: array items: type: object properties: messages: type: array items: anyOf: - type: object properties: role: type: string enum: - system content: anyOf: - type: string - type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false default: '' name: type: string required: - role additionalProperties: false - type: object properties: role: type: string enum: - user content: anyOf: - type: string - type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - image_url image_url: type: object properties: detail: anyOf: - type: string enum: - auto - type: string enum: - low - type: string enum: - high url: type: string required: - url additionalProperties: false required: - type - image_url additionalProperties: false - type: object properties: type: type: string enum: - input_audio input_audio: type: object properties: data: type: string format: type: string enum: - wav - mp3 required: - data - format additionalProperties: false required: - type - input_audio additionalProperties: false default: '' name: type: string required: - role additionalProperties: false - type: object properties: role: type: string enum: - assistant audio: type: object properties: id: type: string required: - id additionalProperties: false nullable: true content: anyOf: - type: string - type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - refusal refusal: type: string required: - type - refusal additionalProperties: false - enum: - 'null' nullable: true default: null function_call: type: object properties: name: type: string default: '' arguments: type: string default: '' additionalProperties: false nullable: true tool_calls: type: array items: type: object properties: id: type: string function: type: object properties: name: type: string arguments: type: string required: - name - arguments additionalProperties: false type: type: string enum: - function required: - id - function - type additionalProperties: false nullable: true name: type: string refusal: type: string nullable: true annotations: type: array items: type: object properties: type: type: string enum: - url_citation url_citation: type: object properties: start_index: type: number end_index: type: number title: type: string url: type: string required: - start_index - end_index - title - url additionalProperties: false required: - type - url_citation additionalProperties: false required: - role additionalProperties: false - type: object properties: role: type: string enum: - developer content: anyOf: - type: string - type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false default: '' name: type: string required: - role additionalProperties: false - type: object properties: role: type: string enum: - tool content: anyOf: - type: string - type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false default: '' tool_call_id: type: string required: - role - tool_call_id additionalProperties: false - type: object properties: role: type: string enum: - function name: type: string content: anyOf: - type: string - enum: - 'null' nullable: true required: - role - name - content additionalProperties: false rejected_message: type: object properties: reasoning_content: type: string nullable: true content: type: string nullable: true default: null refusal: type: string nullable: true role: type: string enum: - assistant function_call: type: object properties: name: type: string default: '' arguments: type: string default: '' additionalProperties: false nullable: true tool_calls: type: array items: type: object properties: id: type: string function: type: object properties: name: type: string arguments: type: string required: - name - arguments additionalProperties: false type: type: string enum: - function required: - id - function - type additionalProperties: false nullable: true required: - role additionalProperties: false tool_choice: anyOf: - type: string enum: - none - type: string enum: - auto - type: string enum: - required - type: object properties: type: type: string enum: - function default: function function: type: object properties: name: type: string required: - name additionalProperties: false default: name: '' additionalProperties: false tools: type: array items: type: object properties: function: type: object properties: name: type: string parameters: type: object additionalProperties: {} description: type: string strict: type: boolean nullable: true required: - name additionalProperties: false type: type: string enum: - function required: - function - type additionalProperties: false response_format: anyOf: - type: object properties: type: type: string enum: - text required: - type additionalProperties: false - type: object properties: type: type: string enum: - json_object required: - type additionalProperties: false - type: object properties: type: type: string enum: - json_schema json_schema: type: object properties: name: type: string description: type: string schema: type: object additionalProperties: {} strict: type: boolean nullable: true required: - name additionalProperties: false required: - type - json_schema additionalProperties: false split: type: string enum: - TRAIN - TEST metadata: type: object additionalProperties: type: string required: - messages additionalProperties: false minItems: 1 maxItems: 100 required: - entries additionalProperties: false parameters: - name: datasetId in: path required: true schema: type: string responses: '200': description: Successful response content: application/json: schema: type: object properties: object: type: string enum: - dataset.entries.creation entries_created: type: number errors: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: object: type: string enum: - dataset.entries.creation.error entry_index: type: number message: type: string required: - object - entry_index - message additionalProperties: false required: - object - data additionalProperties: false required: - object - entries_created - errors additionalProperties: false default: $ref: '#/components/responses/error' tags: - Datasets components: responses: error: description: Error response content: application/json: schema: type: object properties: message: type: string code: type: string issues: type: array items: type: object properties: message: type: string required: - message additionalProperties: false required: - message - code additionalProperties: false securitySchemes: Authorization: type: http scheme: bearer