> ## Documentation Index > Fetch the complete documentation index at: https://docs.orq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a datapoint > Creates a new datapoint in the specified dataset. ## OpenAPI ````yaml post /v2/datasets/{dataset_id}/datapoints openapi: 3.1.0 info: title: orq.ai API version: '2.0' description: orq.ai API documentation servers: - url: https://api.orq.ai security: - ApiKey: [] tags: - name: Guardrail Rules - name: Policies - name: Routing Rules - name: Files description: File upload and retrieval operations. - name: FilesService - name: Projects description: Projects organize resources within a workspace - name: ProjectsService - name: Skills description: >- Skills are modular instructions you can use to codify processes and conventions - name: SkillsService - name: Responses - description: >- Run agents on a cadence — cron, interval, or one-off. Minimum firing interval is 1 hour. name: Agent Schedules - name: Reporting description: >- GenAI reporting API over canonical analytics rollups. Accepts a metric name, time range, grain, group-by, and filters; returns a typed time series and optional totals. - name: ReportingService description: |- ReportingService exposes a single QueryReport RPC that maps allowlisted analytics payloads onto safe rollup queries. Callers never send SQL; the backend picks the rollup family and grain from the metric catalogue, the requested range, and the requested grouping. externalDocs: url: https://docs.orq.ai description: orq.ai Documentation paths: /v2/datasets/{dataset_id}/datapoints: post: tags: - Datasets summary: Create a datapoint description: Creates a new datapoint in the specified dataset. operationId: CreateDatasetItem parameters: - schema: type: string description: The unique identifier of the dataset required: true description: The unique identifier of the dataset name: dataset_id in: path requestBody: content: application/json: schema: type: array items: type: object properties: inputs: type: object additionalProperties: {} description: >- The inputs of the dataset. Key value pairs where the key is the input name and the value is the input value. Nested objects are not supported. messages: type: array items: oneOf: - type: object properties: role: type: string enum: - system description: >- The role of the messages author, in this case `system`. content: anyOf: - type: string description: The contents of the system message. - type: array items: $ref: '#/components/schemas/TextContentPartSchema' minItems: 1 description: >- An array of content parts with a defined type. For system messages, only type `text` is supported. description: The contents of the system message. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. required: - role - content title: System message description: >- Developer-provided instructions that the model should follow, regardless of messages sent by the user. - type: object properties: role: type: string enum: - developer description: >- The role of the messages author, in this case `developer`. content: anyOf: - type: string description: The contents of the system message. - type: array items: $ref: '#/components/schemas/TextContentPartSchema' minItems: 1 description: >- An array of content parts with a defined type. For system messages, only type `text` is supported. description: The contents of the developer message. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. required: - role - content title: Developer message - type: object properties: role: type: string enum: - user description: >- The role of the messages author, in this case `user`. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. content: anyOf: - type: string description: The text contents of the message. - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema - $ref: >- #/components/schemas/ImageContentPartSchema - $ref: >- #/components/schemas/AudioContentPartSchema - type: object properties: type: type: string enum: - file description: >- The type of the content part. Always `file`. cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type file: $ref: >- #/components/schemas/FileContentPartSchema required: - type - file description: >- An array of content parts with a defined type. Supported options differ based on the model being used to generate the response. Can contain text, image, or audio inputs. description: The contents of the user message. required: - role - content title: User message - type: object properties: content: anyOf: - type: string description: The contents of the assistant message. - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema - $ref: '#/components/schemas/RefusalPartSchema' - $ref: '#/components/schemas/ReasoningPartSchema' - $ref: >- #/components/schemas/RedactedReasoningPartSchema discriminator: propertyName: type mapping: text: $ref: >- #/components/schemas/TextContentPartSchema refusal: $ref: '#/components/schemas/RefusalPartSchema' reasoning: $ref: '#/components/schemas/ReasoningPartSchema' redacted_reasoning: $ref: >- #/components/schemas/RedactedReasoningPartSchema description: >- An array of content parts with a defined type. Can be one or more of type `text`, or exactly one of type `refusal`. - type: 'null' description: >- The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified. refusal: type: - string - 'null' description: The refusal message by the assistant. role: type: string enum: - assistant description: >- The role of the messages author, in this case `assistant`. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. audio: type: - object - 'null' properties: id: type: string description: >- Unique identifier for a previous audio response from the model. required: - id description: >- Data about a previous audio response from the model. tool_calls: type: array items: type: object properties: id: type: string description: The ID of the tool call. type: type: string enum: - function description: >- The type of the tool. Currently, only `function` is supported. function: type: object properties: name: type: string description: The name of the function to call. arguments: type: string description: >- The arguments to call the function with, as generated by the model in JSON format. Note that the model does not always generate valid JSON, and may hallucinate parameters not defined by your function schema. Validate the arguments in your code before calling your function. thought_signature: type: string description: >- Encrypted representation of the model internal reasoning state during function calling. Required by Gemini 3 models when continuing a conversation after a tool call. required: - id - type - function description: >- The tool calls generated by the model, such as function calls. required: - role title: Assistant message - type: object properties: role: type: string enum: - tool description: >- The role of the messages author, in this case tool. content: anyOf: - type: string - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema discriminator: propertyName: type mapping: text: $ref: >- #/components/schemas/TextContentPartSchema description: The contents of the tool message. tool_call_id: type: - string - 'null' description: Tool call that this message is responding to. cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type required: - role - content - tool_call_id title: Tool message description: A list of messages comprising the conversation so far expected_output: type: string minItems: 1 maxItems: 5000 description: An array of datapoints to create (min 1, max 5000) responses: '200': description: >- Datapoints created successfully. Returns an array of newly created datapoint objects. content: application/json: schema: type: array items: type: object properties: _id: type: string description: The unique identifier of the dataset item workspace_id: type: string description: The unique identifier of the workspace it belongs to inputs: type: object additionalProperties: {} description: >- The inputs of the dataset. Key value pairs where the key is the input name and the value is the input value. Nested objects are not supported. messages: type: array items: oneOf: - type: object properties: role: type: string enum: - system description: >- The role of the messages author, in this case `system`. content: anyOf: - type: string description: The contents of the system message. - type: array items: $ref: >- #/components/schemas/TextContentPartSchema minItems: 1 description: >- An array of content parts with a defined type. For system messages, only type `text` is supported. description: The contents of the system message. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. required: - role - content title: System message description: >- Developer-provided instructions that the model should follow, regardless of messages sent by the user. - type: object properties: role: type: string enum: - developer description: >- The role of the messages author, in this case `developer`. content: anyOf: - type: string description: The contents of the system message. - type: array items: $ref: >- #/components/schemas/TextContentPartSchema minItems: 1 description: >- An array of content parts with a defined type. For system messages, only type `text` is supported. description: The contents of the developer message. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. required: - role - content title: Developer message - type: object properties: role: type: string enum: - user description: >- The role of the messages author, in this case `user`. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. content: anyOf: - type: string description: The text contents of the message. - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema - $ref: >- #/components/schemas/ImageContentPartSchema - $ref: >- #/components/schemas/AudioContentPartSchema - type: object properties: type: type: string enum: - file description: >- The type of the content part. Always `file`. cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type file: $ref: >- #/components/schemas/FileContentPartSchema required: - type - file description: >- An array of content parts with a defined type. Supported options differ based on the model being used to generate the response. Can contain text, image, or audio inputs. description: The contents of the user message. required: - role - content title: User message - type: object properties: content: anyOf: - type: string description: The contents of the assistant message. - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema - $ref: '#/components/schemas/RefusalPartSchema' - $ref: '#/components/schemas/ReasoningPartSchema' - $ref: >- #/components/schemas/RedactedReasoningPartSchema discriminator: propertyName: type mapping: text: $ref: >- #/components/schemas/TextContentPartSchema refusal: $ref: '#/components/schemas/RefusalPartSchema' reasoning: $ref: '#/components/schemas/ReasoningPartSchema' redacted_reasoning: $ref: >- #/components/schemas/RedactedReasoningPartSchema description: >- An array of content parts with a defined type. Can be one or more of type `text`, or exactly one of type `refusal`. - type: 'null' description: >- The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified. refusal: type: - string - 'null' description: The refusal message by the assistant. role: type: string enum: - assistant description: >- The role of the messages author, in this case `assistant`. name: type: string description: >- An optional name for the participant. Provides the model information to differentiate between participants of the same role. audio: type: - object - 'null' properties: id: type: string description: >- Unique identifier for a previous audio response from the model. required: - id description: >- Data about a previous audio response from the model. tool_calls: type: array items: type: object properties: id: type: string description: The ID of the tool call. type: type: string enum: - function description: >- The type of the tool. Currently, only `function` is supported. function: type: object properties: name: type: string description: The name of the function to call. arguments: type: string description: >- The arguments to call the function with, as generated by the model in JSON format. Note that the model does not always generate valid JSON, and may hallucinate parameters not defined by your function schema. Validate the arguments in your code before calling your function. thought_signature: type: string description: >- Encrypted representation of the model internal reasoning state during function calling. Required by Gemini 3 models when continuing a conversation after a tool call. required: - id - type - function description: >- The tool calls generated by the model, such as function calls. required: - role title: Assistant message - type: object properties: role: type: string enum: - tool description: >- The role of the messages author, in this case tool. content: anyOf: - type: string - type: array items: oneOf: - $ref: >- #/components/schemas/TextContentPartSchema discriminator: propertyName: type mapping: text: $ref: >- #/components/schemas/TextContentPartSchema description: The contents of the tool message. tool_call_id: type: - string - 'null' description: Tool call that this message is responding to. cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type required: - role - content - tool_call_id title: Tool message description: A list of messages comprising the conversation so far expected_output: type: string evaluations: type: array items: oneOf: - type: object properties: id: type: string description: The unique identifier of the human evaluation evaluation_type: type: string enum: - human_review description: The type of evaluation human_review_id: type: string description: The unique identifier of the human review source: type: string enum: - orq - external default: orq reviewed_by_id: type: string description: >- The unique identifier of the user who reviewed the item reviewed_at: type: string format: date-time default: '2026-05-14T21:19:53.451Z' description: The date and time the item was reviewed type: type: string enum: - string value: type: string required: - id - evaluation_type - human_review_id - reviewed_by_id - type - value - type: object properties: id: type: string description: The unique identifier of the human evaluation evaluation_type: type: string enum: - human_review description: The type of evaluation human_review_id: type: string description: The unique identifier of the human review source: type: string enum: - orq - external default: orq reviewed_by_id: type: string description: >- The unique identifier of the user who reviewed the item reviewed_at: type: string format: date-time default: '2026-05-14T21:19:53.451Z' description: The date and time the item was reviewed type: type: string enum: - number value: type: number required: - id - evaluation_type - human_review_id - reviewed_by_id - type - value - type: object properties: id: type: string description: The unique identifier of the human evaluation evaluation_type: type: string enum: - human_review description: The type of evaluation human_review_id: type: string description: The unique identifier of the human review source: type: string enum: - orq - external default: orq reviewed_by_id: type: string description: >- The unique identifier of the user who reviewed the item reviewed_at: type: string format: date-time default: '2026-05-14T21:19:53.451Z' description: The date and time the item was reviewed type: type: string enum: - string_array values: type: array items: type: string required: - id - evaluation_type - human_review_id - reviewed_by_id - type - values description: Evaluations associated with the datapoint dataset_id: type: string description: The unique identifier of the dataset snapshot_version: type: string description: The version of the dataset snapshot created_by_id: type: string description: >- The unique identifier of the user who created the dataset updated_by_id: type: string description: >- The unique identifier of the user who last updated the dataset created: anyOf: - format: date-time type: string - format: date-time type: string default: '2026-05-14T21:19:47.506Z' readOnly: true format: date-time description: The date and time the resource was created updated: anyOf: - type: string format: date-time default: '2026-05-14T21:19:47.508Z' - format: date-time type: string readOnly: true format: date-time description: The date and time the resource was last updated required: - _id - workspace_id - dataset_id components: schemas: TextContentPartSchema: type: object properties: type: type: string enum: - text description: The type of the content part. text: type: string description: The text content. cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type required: - type - text title: Text content part description: The type of the content part. ImageContentPartSchema: type: object properties: type: type: string enum: - image_url image_url: type: object properties: url: type: string description: Either a URL of the image or the base64 encoded image data. detail: type: string enum: - low - high - auto description: Specifies the detail level of the image. required: - url cache_control: type: object properties: type: type: string enum: - ephemeral description: >- Create a cache control breakpoint at this content block. Accepts only the value "ephemeral". ttl: type: string enum: - 5m - 1h default: 5m description: >- The time-to-live for the cache control breakpoint. This may be one of the following values: - `5m`: 5 minutes - `1h`: 1 hour Defaults to `5m`. Only supported by `Anthropic` Claude models. required: - type required: - type - image_url title: Image content part description: An image content part AudioContentPartSchema: type: object properties: type: type: string enum: - input_audio input_audio: type: object properties: data: type: string description: Base64 encoded audio data. format: type: string enum: - mp3 - wav description: >- The format of the encoded audio data. Currently supports `wav` and `mp3`. required: - data - format required: - type - input_audio title: Audio content part description: An audio content part FileContentPartSchema: type: object properties: file_data: type: string description: >- The file data as a data URI string in the format 'data:;base64,'. Example: 'data:image/png;base64,iVBORw0KGgoAAAANS...' uri: type: string description: >- URL to the file. Only supported by Anthropic Claude models for PDF files. mimeType: type: string description: MIME type of the file (e.g., application/pdf, image/png) filename: type: string description: >- The name of the file, used when passing the file to the model as a string. description: >- File data for the content part. Must contain either file_data or uri, but not both. RefusalPartSchema: type: object properties: type: type: string enum: - refusal description: The type of the content part. Always `refusal`. refusal: type: string description: The refusal message generated by the model. required: - type title: Refusal part description: A message part containing a refusal message. ReasoningPartSchema: type: object properties: type: type: string enum: - reasoning description: The type of the content part. Always `reasoning`. reasoning: type: string description: >- The reasoning or thought process behind the response. Used for chain-of-thought or extended thinking. signature: type: string description: >- Optional cryptographic signature to verify the authenticity and integrity of the reasoning content required: - type - reasoning - signature title: Reasoning Part description: A message part containing reasoning or chain-of-thought content RedactedReasoningPartSchema: type: object properties: type: type: string enum: - redacted_reasoning description: The type of the content part. Always `reasoning`. data: type: string description: >- The encrypted reasoning or thought process behind the response. Used for chain-of-thought or extended thinking. required: - type - data title: Reasoning Part description: A message part containing reasoning or chain-of-thought content securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: JWT ````