Skip to main content
POST
/
v1
/
projects
/
{project_id}
/
data
/
fetch
Fetch Url
curl --request POST \
  --url https://api.ontora.com/v1/projects/{project_id}/data/fetch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "source_name": "<string>",
  "metadata": {}
}
'
{
  "input_id": "<string>",
  "input_type": "<string>",
  "size_bytes": 123,
  "source_name": "<string>",
  "detected_format": "<string>",
  "preview": {},
  "status": "pending",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
project_id
string
required

Body

application/json

Request to fetch data from a URL.

​
url
string<uri>
required

URL to fetch data from

Required string length: 1 - 2083
​
source_name
string | null

Name/description of the data source

​
metadata
Metadata · object

Additional metadata

Response

Successful Response

Response after data input is accepted.

​
input_id
string
required

Unique identifier for this input

​
input_type
string
required

Type of input (file, url, paste, webhook)

​
size_bytes
integer
required

Size of the input in bytes

​
source_name
string | null

Name of the data source

​
detected_format
string | null

Detected format (if available)

​
preview
Preview · object

Preview of the data

​
status
string
default:pending

Processing status

​
created_at
string<date-time>