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

# Integrate custom datasets

<RequestExample>
  ```bash cURL theme={null}
  curl -X 'POST' \
    'https://api.coaxial.ai/data_integration/custom' \
    -H 'accept: application/json' \
    -H 'Authorization: Bearer <api_key>' \
    -H 'Content-Type: application/json' \
    -d '{
    "dataset_name": <custom_dataset_name>
  }'
  ```

  ```python python theme={null}
  import coaxial
  from coaxial.models import IntegrateCustomDatasetRequest
  from pprint import pprint

  coaxial_api = coaxial.Api(api_key=<api_key>)
  integrate_custom_dataset_request = IntegrateCustomDatasetRequest(dataset_name=<custom_dataset_name>)

  try:
      api_response = coaxial_api.data_integration.integrate_custom_dataset(integrate_custom_dataset_request)
      print("The response of DataIntegrationApi->integrate_custom_dataset:\n")
      pprint(api_response)
  except Exception as e:
      print("Exception when calling DataIntegrationApi->integrate_custom_dataset: %s\n" % e)
  ```
</RequestExample>

<ResponseExample>
  ```json Example Response theme={null}
  {
    "datasets": [
      {
        "dataset_name": "string",
        "id": <coaxial_dataset_integration_id>
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml post /data_integration/custom
openapi: 3.1.0
info:
  contact:
    email: team@coaxial.ai
    name: Team Coaxial
  description: The Coaxial REST API. Please see https://docs.coaxial.ai for more details.
  termsOfService: https://coaxial.ai/terms/
  title: The Coaxial API
  version: 0.0.1
servers:
  - description: production
    url: https://api.coaxial.ai
  - description: sandbox
    url: https://sandbox.coaxial.ai
security: []
paths:
  /data_integration/custom:
    post:
      tags:
        - data_integration
      summary: Integrate custom datasets
      operationId: integrate_custom_dataset
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/integrate_custom_dataset_request'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/integrate_custom_dataset_response'
          description: Custom dataset names in an array of strings
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - Authorization: []
components:
  schemas:
    integrate_custom_dataset_request:
      properties:
        dataset_name:
          title: Dataset Name
          type: string
      required:
        - dataset_name
      title: integrate_custom_dataset_request
      type: object
    integrate_custom_dataset_response:
      properties:
        datasets:
          items:
            $ref: '#/components/schemas/dataset_info'
          title: Datasets
          type: array
      required:
        - datasets
      title: integrate_custom_dataset_response
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    dataset_info:
      properties:
        dataset_name:
          title: Dataset Name
          type: string
        id:
          format: uuid
          title: Id
          type: string
      required:
        - dataset_name
        - id
      title: dataset_info
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    Authorization:
      scheme: bearer
      type: http

````