Add A Datasource

curl --request POST \
  --url https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: datasource.json' \
  --data '{
  "name": "<string>",
  "originalName": "<string>",
  "sourceType": "<string>",
  "sourceId": "<string>",
  "destinationId": "<string>",
  "workspaceId": "<string>",
  "connectionId": "<string>",
  "createdDate": "2023-11-07T05:31:56Z",
  "_id": "<string>",
  "orgId": "<string>",
  "teamId": "<string>",
  "description": "<string>",
  "filename": "<string>",
  "recordCount": {
    "total": 123,
    "success": 123,
    "failure": 123
  },
  "lastSyncedDate": "2023-11-07T05:31:56Z",
  "discoveredSchema": {},
  "embeddingField": "<string>",
  "timeWeightField": "<string>",
  "modelId": "<string>",
  "hidden": true,
  "streamConfig": {},
  "timeUnit": "<string>"
}'

import requests

url = "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add"

payload = "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "datasource.json"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'datasource.json'},
  body: '{\n  "name": "<string>",\n  "originalName": "<string>",\n  "sourceType": "<string>",\n  "sourceId": "<string>",\n  "destinationId": "<string>",\n  "workspaceId": "<string>",\n  "connectionId": "<string>",\n  "createdDate": "2023-11-07T05:31:56Z",\n  "_id": "<string>",\n  "orgId": "<string>",\n  "teamId": "<string>",\n  "description": "<string>",\n  "filename": "<string>",\n  "recordCount": {\n    "total": 123,\n    "success": 123,\n    "failure": 123\n  },\n  "lastSyncedDate": "2023-11-07T05:31:56Z",\n  "discoveredSchema": {},\n  "embeddingField": "<string>",\n  "timeWeightField": "<string>",\n  "modelId": "<string>",\n  "hidden": true,\n  "streamConfig": {},\n  "timeUnit": "<string>"\n}'
};

fetch('https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: datasource.json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "datasource.json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "datasource.json")
  .body("{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'datasource.json'
request.body = "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "redirect": "<string>"
}

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

POST

{resourceSlug}

forms

datasource

add

Add A Datasource

curl --request POST \
  --url https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: datasource.json' \
  --data '{
  "name": "<string>",
  "originalName": "<string>",
  "sourceType": "<string>",
  "sourceId": "<string>",
  "destinationId": "<string>",
  "workspaceId": "<string>",
  "connectionId": "<string>",
  "createdDate": "2023-11-07T05:31:56Z",
  "_id": "<string>",
  "orgId": "<string>",
  "teamId": "<string>",
  "description": "<string>",
  "filename": "<string>",
  "recordCount": {
    "total": 123,
    "success": 123,
    "failure": 123
  },
  "lastSyncedDate": "2023-11-07T05:31:56Z",
  "discoveredSchema": {},
  "embeddingField": "<string>",
  "timeWeightField": "<string>",
  "modelId": "<string>",
  "hidden": true,
  "streamConfig": {},
  "timeUnit": "<string>"
}'

import requests

url = "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add"

payload = "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "datasource.json"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'datasource.json'},
  body: '{\n  "name": "<string>",\n  "originalName": "<string>",\n  "sourceType": "<string>",\n  "sourceId": "<string>",\n  "destinationId": "<string>",\n  "workspaceId": "<string>",\n  "connectionId": "<string>",\n  "createdDate": "2023-11-07T05:31:56Z",\n  "_id": "<string>",\n  "orgId": "<string>",\n  "teamId": "<string>",\n  "description": "<string>",\n  "filename": "<string>",\n  "recordCount": {\n    "total": 123,\n    "success": 123,\n    "failure": 123\n  },\n  "lastSyncedDate": "2023-11-07T05:31:56Z",\n  "discoveredSchema": {},\n  "embeddingField": "<string>",\n  "timeWeightField": "<string>",\n  "modelId": "<string>",\n  "hidden": true,\n  "streamConfig": {},\n  "timeUnit": "<string>"\n}'
};

fetch('https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: datasource.json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "datasource.json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "datasource.json")
  .body("{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.agentcloud.dev/{resourceSlug}/forms/datasource/add")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'datasource.json'
request.body = "{\n  \"name\": \"<string>\",\n  \"originalName\": \"<string>\",\n  \"sourceType\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"destinationId\": \"<string>\",\n  \"workspaceId\": \"<string>\",\n  \"connectionId\": \"<string>\",\n  \"createdDate\": \"2023-11-07T05:31:56Z\",\n  \"_id\": \"<string>\",\n  \"orgId\": \"<string>\",\n  \"teamId\": \"<string>\",\n  \"description\": \"<string>\",\n  \"filename\": \"<string>\",\n  \"recordCount\": {\n    \"total\": 123,\n    \"success\": 123,\n    \"failure\": 123\n  },\n  \"lastSyncedDate\": \"2023-11-07T05:31:56Z\",\n  \"discoveredSchema\": {},\n  \"embeddingField\": \"<string>\",\n  \"timeWeightField\": \"<string>\",\n  \"modelId\": \"<string>\",\n  \"hidden\": true,\n  \"streamConfig\": {},\n  \"timeUnit\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "redirect": "<string>"
}

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

{
  "message": "<string>",
  "code": 123
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

resourceSlug

string

required

The resourceSlug is a url parameter of the teamId associated with the user. Anywhere the resourceSlug is used can be interpreted as a teamId Mongodb Object id, unique identifier, length of 24 characters fitting the following regex; [a-f0-9]{24}

Body

datasource.json

Datasource object that was created when testDatasourceApi is run, must include datasourceId.

Represents a data source configuration within the system, including connection details, status, chunking configurations, and record counts.

name

string

required

The name of the datasource.

originalName

string

required

The original name of the datasource.

sourceType

string

required

The type of source for the datasource.

sourceId

string

required

The identifier of the data source.

destinationId

string

required

The identifier of the data destination.

workspaceId

string

required

The identifier of the workspace associated with the datasource.

connectionId

string

required

The identifier of the connection associated with the datasource.

createdDate

string<date-time>

required

The date and time when the datasource was created.

_id

string

Unique identifier for the datasource.

orgId

string

Identifier of the organization to which the datasource belongs.

teamId

string

Identifier of the team to which the datasource belongs.

description

string

Optional description of the datasource.

filename

string | null

The name of the file associated with the datasource, if applicable.

recordCount

object

The record count details for the datasource, including total, successful, and failed records.

Show child attributes

connectionSettings

object

Configuration settings for the datasource connection.

Show child attributes

lastSyncedDate

string<date-time> | null

The date and time when the datasource was last synced. Null indicates it has never been synced.

status

enum<string>

The current status of the datasource.

Available options:

draft,

processing,

embedding,

ready

discoveredSchema

object | null

Schema discovered during the data source connection. The structure depends on the source type.

chunkingConfig

object

Configuration settings for chunking unstructured data, including partitioning and chunking strategies, character limits, and similarity thresholds.

Show child attributes

embeddingField

string

The field used for embedding within the datasource.

timeWeightField

string

The field used to apply time weighting within the datasource.

modelId

string

Identifier of the embedding model used, if applicable.

hidden

boolean

Indicates whether the datasource is hidden from standard views.

streamConfig

object

Configuration settings for processing streams of data, breaking them into smaller chunks for more manageable processing.

Show child attributes

timeUnit

string

A temporary field to limit CRON frequency based on the plan. This will be replaced with a more robust solution in the future.

Response

Successful operation, redirect to '/{resourceSlug}/datasources'. Returns added toolId in return body

Server response after successsfully adding a new object

_id

string

The unique Mongo id of the newly inserted object.

redirect

string

a string containing the redirect link to get all objects after a successful insertion.