Ingest From Public URL | Coactive AI

1 import requests 2 3 url = "https://api.coactive.ai/api/v1/ingestion/assets" 4 5 payload = { 6 "dataset_id": "2eef46c3-9766-42d4-9038-be5385a0b0b0", 7 "assets": [ 8 { 9 "source_path": "https://example.com/image1.png", 10 "metadata": { 11 "unique_id": "IMG_001", 12 "custom_field": "abcd" 13 }, 14 "asset_type": "image" 15 }, 16 { 17 "source_path": "https://example.com/video.mp4", 18 "metadata": { 19 "unique_id": "VID_002", 20 "random_field": "efgh" 21 }, 22 "asset_type": "video" 23 } 24 ] 25 } 26 headers = { 27 "Authorization": "Bearer <token>", 28 "Content-Type": "application/json" 29 } 30 31 response = requests.post(url, json=payload, headers=headers) 32 33 print(response.json())

1 { 2 "id": "5eb7cf5a86d9755df3a6c593", 3 "org_id": "org_iBqeTqXR0mq9FvEg", 4 "dataset_id": "2eef46c3-9766-42d4-9038-be5385a0b0b0", 5 "job_type": "assets", 6 "details": { 7 "assets": [ 8 { 9 "asset": { 10 "source_path": "https://example.com/image1.png", 11 "metadata": { 12 "unique_id": "IMG_001", 13 "custom_field": "abcd" 14 } 15 }, 16 "asset_id": "15cef525-11f8-4f3f-8950-5ab8ce5bb7a7", 17 "error": "null" 18 }, 19 { 20 "asset": { 21 "source_path": "https://example.com/video.mp4", 22 "metadata": { 23 "unique_id": "VID_002", 24 "custom_field": "efgh" 25 } 26 }, 27 "asset_id": "13b4c496-024c-465e-8049-c4b3151b35d2", 28 "error": null 29 } 30 ] 31 }, 32 "created_dt": "2025-05-12T15:45:31.381000", 33 "request_type": "submit", 34 "status": "pending", 35 "updated_dt": "2025-05-12T15:45:31.381000", 36 "total_assets": 2, 37 "processed_assets": 0, 38 "errored_assets": 0 39 }

Supports ingestion of up to 100 assets in a single request by providing a list of file paths. This method is ideal for quick uploads — whether you’re ingesting a single asset or a small batch — without the need to scan an entire bucket or use a file-based list. Note - If you do not specify the type of the asset, you will not receive the asset_id.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

dataset_idstringRequiredformat: "uuid"

assetslist of objectsRequired

connection_namestringOptionalBeta

Response

Successful Response

idstring

org_idstring

dataset_idstringformat: "uuid"

job_typeenum

Allowed values:

detailsobject or null

created_dtstringformat: "date-time"

request_typeenum or null

Allowed values:

statusenum or null

Enum of Ingest Job Status.

updated_dtstring or nullformat: "date-time"

total_assetsinteger or null

processed_assetsinteger or nullDefaults to 0

errored_assetsinteger or nullDefaults to 0

request_idstring or null

Authentication

Request

Response

Errors