Create a Dataset Item

Guide to creating a Dataset Item in the Fetch Hive API.

Create a new data set item

post

Create a new data set item with specified parameters

Authorizations

bearerAuth

AuthorizationstringRequired

Enter the token with the Bearer: prefix, e.g. "Bearer abcde12345".

Path parameters

data_set_idstringRequired

Data set token

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

Responses

200

Successful response

application/json

default

Error

application/json

post

/data_sets/{data_set_id}/items

HTTPcURLJavaScriptPython

POST /v1/data_sets/{data_set_id}/items HTTP/1.1
Host: api.fetchhive.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 333

{
  "data_set_item": {
    "name": "text",
    "description": "text",
    "data_query": "text",
    "data_content": "text",
    "custom_prompt": "text",
    "custom_prompt_status": "enabled",
    "response_type": "text",
    "item_type": "custom",
    "chunking_strategy": "default",
    "delete_email_data": "enabled",
    "delete_telephone_data": "enabled",
    "chunk_overlap": 1,
    "maximum_chunk_length": 1
  }
}

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

{
  "message": "Successfully created a data set item.",
  "data_set_item": {
    "id": 1,
    "name": "text",
    "description": "text",
    "token": "text",
    "data_query": "text",
    "data_content": "text",
    "formatted_data_content": "text",
    "custom_prompt": "text",
    "custom_prompt_status": "enabled",
    "website_screenshot_url": "text",
    "data_document_url": "text",
    "error_message": "text",
    "item_type": "custom",
    "response_type": "text",
    "run_status": "pending"
  }
}