> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enkryptai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datasets Add Task



## OpenAPI

````yaml POST /datasets/add-task
openapi: 3.0.0
info:
  title: Enkrypt AI APIs
  version: 2.0.0
servers:
  - url: https://api.enkryptai.com
security:
  - apiKeyAuth: []
tags:
  - name: Guardrails
  - name: Code of Conduct
  - name: Endpoints
  - name: Datasets
  - name: Redteam
  - name: Deployments
  - name: AI Proxy
  - name: Leaderboard
  - name: Archived
  - name: MCP Hub
    description: >-
      MCP Hub vulnerability scanning APIs. Submitting scans (the POST endpoints)
      is open to all authenticated callers. The scan **retrieval** APIs — Get
      Scan Job Status, Get Complete Scan Results, List Scans, and Get MCP Hub
      Scan Statistics (the GET endpoints) — are an **enterprise data-license
      feature**: they require your organization to have MCP Hub API access
      enabled by Enkrypt, otherwise they return `403`. Contact us at
      support@enkryptai.com to enable access.
  - name: MCP Registry Servers
  - name: MCP Gateways
  - name: MCP Playground
paths:
  /datasets/add-task:
    post:
      tags:
        - Datasets
      summary: Datasets Add Task
      operationId: datasets_add_task_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatasetsConfig'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetsAddTaskResponse'
components:
  schemas:
    DatasetsConfig:
      title: DatasetsConfig
      type: object
      required:
        - dataset_name
      allOf:
        - $ref: '#/components/schemas/DatasetsBaseConfig'
      properties:
        dataset_name:
          title: Dataset Name
          type: string
          description: Name of the dataset
          example: Election
        info_pdf_url:
          title: Info PDF URL
          type: string
          description: URL to the PDF which explains the dataset to be generated
          example: ''
      example:
        dataset_name: Election
        system_description: >-
          - **Voter Eligibility**: To vote in U.S. elections, individuals must
          be U.S. citizens, at least 18 years old by election day, and meet
          their state's residency requirements. - **Voter Registration**: Most
          states require voters to register ahead of time, with deadlines
          varying widely. North Dakota is an exception, as it does not require
          voter registration. - **Identification Requirements**: Thirty-six
          states enforce voter ID laws, requiring individuals to present
          identification at polling places. These laws aim to prevent voter
          fraud but can also lead to disenfranchisement. - **Voting Methods**:
          Voters can typically choose between in-person voting on election day,
          early voting, and absentee or mail-in ballots, depending on state
          regulations. - **Polling Hours**: Polling hours vary by state, with
          some states allowing extended hours for voters. Itâ€™s essential for
          voters to check local polling times to ensure they can cast their
          ballots. - **Provisional Ballots**: If there are questions about a
          voter's eligibility, they may be allowed to cast a provisional ballot.
          This ballot is counted once eligibility is confirmed. - **Election Day
          Laws**: Many states have laws that protect the rights of voters on
          election day, including prohibiting intimidation and ensuring access
          to polling places. - **Campaign Finance Regulations**: Federal and
          state laws regulate contributions to candidates and political parties
          to ensure transparency and limit the influence of money in politics. -
          **Political Advertising**: Campaigns must adhere to rules regarding
          political advertising, including disclosure requirements about funding
          sources and content accuracy. - **Voter Intimidation Prohibitions**:
          Federal laws prohibit any form of voter intimidation or coercion at
          polling places, ensuring a safe environment for all voters. -
          **Accessibility Requirements**: The Americans with Disabilities Act
          mandates that polling places be accessible to individuals with
          disabilities, ensuring equal access to the electoral process. -
          **Election Monitoring**: Various organizations are allowed to monitor
          elections to ensure compliance with laws and regulations. They help
          maintain transparency and accountability in the electoral process. -
          **Vote Counting Procedures**: States have specific procedures for
          counting votes, including the use of electronic voting machines and
          manual audits to verify results. - **Ballot Design Standards**: States
          must adhere to certain design standards for ballots to ensure clarity
          and prevent confusion among voters when casting their votes. -
          **Post-Election Audits**: Some states conduct post-election audits as
          a measure of accuracy. These audits help verify that the vote count
          reflects the actual ballots cast.
        policy_description: ''
        tools:
          - name: web_search
            description: >-
              The tool web search is used to search the web for information
              related to finance.
        info_pdf_url: ''
        scenarios: 1
        categories: 1
        depth: 1
        max_prompts: 100
    DatasetsAddTaskResponse:
      title: DatasetsAddTaskResponse
      type: object
      properties:
        message:
          title: Message
          type: string
          example: Dataset task has been added successfully
        task_id:
          title: Task Id
          type: string
          example: data-generation-bc4a320e-60ea-4641-ba1c-f8d8b302f6b8
        status:
          title: Status
          type: string
          description: Status of the task
          enum:
            - Success
            - Failed
          example: Success
      required:
        - task_id
    DatasetsBaseConfig:
      title: DatasetsBaseConfig
      type: object
      required:
        - system_description
      properties:
        system_description:
          title: System Description
          type: string
          description: Description of the system
          example: >-
            - **Voter Eligibility**: To vote in U.S. elections, individuals must
            be U.S. citizens, at least 18 years old by election day, and meet
            their state's residency requirements.
        policy_description:
          title: Policy Description
          type: string
          description: Description of the policy
          example: ''
        tools:
          title: Tools
          type: array
          items:
            title: Tool
            type: object
            required:
              - name
              - description
            properties:
              name:
                title: Tool Name
                type: string
                description: Name of the tool
                example: web_search
              description:
                title: Tool Description
                type: string
                description: Description of what the tool does
                example: >-
                  The tool web search is used to search the web for information
                  related to finance.
          description: Array of tools available to the model
          example:
            - name: web_search
              description: >-
                The tool web search is used to search the web for information
                related to finance.
        max_prompts:
          title: Max Prompts
          type: integer
          description: Maximum number of prompts to be generated
          minimum: 100
          maximum: 3500
          example: 100
        scenarios:
          title: Scenarios
          type: integer
          description: Maximum number of scenarios to be generated
          minimum: 1
          maximum: 10
          example: 2
        categories:
          title: Categories
          type: integer
          description: Maximum number of categories to be generated
          minimum: 1
          maximum: 10
          example: 2
        depth:
          title: Depth
          type: integer
          description: Maximum number of depth to be generated
          minimum: 1
          maximum: 3
          example: 2
      example:
        system_description: >-
          - **Voter Eligibility**: To vote in U.S. elections, individuals must
          be U.S. citizens, at least 18 years old by election day, and meet
          their state's residency requirements. - **Voter Registration**: Most
          states require voters to register ahead of time, with deadlines
          varying widely. North Dakota is an exception, as it does not require
          voter registration. - **Identification Requirements**: Thirty-six
          states enforce voter ID laws, requiring individuals to present
          identification at polling places. These laws aim to prevent voter
          fraud but can also lead to disenfranchisement. - **Voting Methods**:
          Voters can typically choose between in-person voting on election day,
          early voting, and absentee or mail-in ballots, depending on state
          regulations. - **Polling Hours**: Polling hours vary by state, with
          some states allowing extended hours for voters. Itâ€™s essential for
          voters to check local polling times to ensure they can cast their
          ballots. - **Provisional Ballots**: If there are questions about a
          voter's eligibility, they may be allowed to cast a provisional ballot.
          This ballot is counted once eligibility is confirmed. - **Election Day
          Laws**: Many states have laws that protect the rights of voters on
          election day, including prohibiting intimidation and ensuring access
          to polling places. - **Campaign Finance Regulations**: Federal and
          state laws regulate contributions to candidates and political parties
          to ensure transparency and limit the influence of money in politics. -
          **Political Advertising**: Campaigns must adhere to rules regarding
          political advertising, including disclosure requirements about funding
          sources and content accuracy. - **Voter Intimidation Prohibitions**:
          Federal laws prohibit any form of voter intimidation or coercion at
          polling places, ensuring a safe environment for all voters. -
          **Accessibility Requirements**: The Americans with Disabilities Act
          mandates that polling places be accessible to individuals with
          disabilities, ensuring equal access to the electoral process. -
          **Election Monitoring**: Various organizations are allowed to monitor
          elections to ensure compliance with laws and regulations. They help
          maintain transparency and accountability in the electoral process. -
          **Vote Counting Procedures**: States have specific procedures for
          counting votes, including the use of electronic voting machines and
          manual audits to verify results. - **Ballot Design Standards**: States
          must adhere to certain design standards for ballots to ensure clarity
          and prevent confusion among voters when casting their votes. -
          **Post-Election Audits**: Some states conduct post-election audits as
          a measure of accuracy. These audits help verify that the vote count
          reflects the actual ballots cast.
        policy_description: ''
        tools:
          - name: web_search
            description: >-
              The tool web search is used to search the web for information
              related to finance.
        scenarios: 1
        categories: 1
        depth: 1
        max_prompts: 100
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````