Import from the catalog
curl --request POST \
--url https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"catalog_id": "<string>"
}
'import requests
url = "https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog"
payload = { "catalog_id": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({catalog_id: '<string>'})
};
fetch('https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"item": {
"id": "<string>",
"org_slug": "<string>",
"project_slug": "<string>",
"dataset_slug": "<string>",
"title": "<string>",
"source_kind": "<string>",
"dataset_id": "<string>",
"source_uri": "<string>",
"raw_object_path": "<string>",
"report_object_path": "<string>",
"read_model_path": "<string>",
"error_message": "<string>",
"created_by": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"hf_repo_id": "<string>",
"hf_revision": "<string>",
"hdf5": {
"kind": "<string>",
"inspected": true,
"reason": "<string>",
"size_bytes": 1,
"max_bytes": 1,
"dataset_count": 1,
"group_count": 1,
"datasets": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"ndim": 1,
"size": 1,
"compression": "<string>",
"chunks": [
123
],
"attrs": {}
}
],
"groups": [
{
"path": "<string>",
"attrs": {}
}
],
"preview_candidates": {
"image": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"height": 123,
"width": 123,
"channels": 123,
"frames": 1,
"episode_index": 1,
"split": "<string>",
"trajectory_id": "<string>",
"group_path": "<string>",
"camera_key": "<string>"
}
],
"jpeg_bytes": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>"
}
],
"padded_jpeg": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>",
"camera_key": "<string>",
"compress_len_path": "<string>",
"camera_index": 1
}
],
"image_path": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"first_frame_path": "<string>",
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>",
"camera_key": "<string>"
}
],
"numeric_tensor": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"ndim": 1,
"size": 1
}
]
},
"preview_assets": [
{
"path": "<string>",
"label": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"metadata": {}
}
],
"episodes": [
{
"episode_index": 1,
"split": "<string>",
"trajectory_id": "<string>",
"frames_path": "<string>",
"group_path": "<string>",
"length_frames": 1,
"duration_sec": 1
}
],
"truncated": true,
"root_attrs": {}
},
"preview_assets": [
{
"path": "<string>",
"label": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"metadata": {}
}
],
"started_at": "<string>",
"progress_pct": 123,
"progress_phase": "<string>",
"progress_message": "<string>",
"downloaded_bytes": 123,
"total_bytes": 123,
"attempt_count": 0,
"max_attempts": 3,
"claim_epoch": 0,
"claimed_by": "<string>",
"claimed_at": "<string>",
"claim_expires_at": "<string>",
"last_heartbeat_at": "<string>",
"retry_after": "<string>",
"last_error": "<string>",
"consistency_status": "unknown",
"consistency_checked_at": "<string>",
"consistency_error": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Imports
Import from the catalog
POST
/
api
/
v1
/
orgs
/
{org_slug}
/
projects
/
{project_slug}
/
imports
/
from-catalog
Import from the catalog
curl --request POST \
--url https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"catalog_id": "<string>"
}
'import requests
url = "https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog"
payload = { "catalog_id": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({catalog_id: '<string>'})
};
fetch('https://platform.neural-motion.org/api/v1/orgs/{org_slug}/projects/{project_slug}/imports/from-catalog', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"item": {
"id": "<string>",
"org_slug": "<string>",
"project_slug": "<string>",
"dataset_slug": "<string>",
"title": "<string>",
"source_kind": "<string>",
"dataset_id": "<string>",
"source_uri": "<string>",
"raw_object_path": "<string>",
"report_object_path": "<string>",
"read_model_path": "<string>",
"error_message": "<string>",
"created_by": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"hf_repo_id": "<string>",
"hf_revision": "<string>",
"hdf5": {
"kind": "<string>",
"inspected": true,
"reason": "<string>",
"size_bytes": 1,
"max_bytes": 1,
"dataset_count": 1,
"group_count": 1,
"datasets": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"ndim": 1,
"size": 1,
"compression": "<string>",
"chunks": [
123
],
"attrs": {}
}
],
"groups": [
{
"path": "<string>",
"attrs": {}
}
],
"preview_candidates": {
"image": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"height": 123,
"width": 123,
"channels": 123,
"frames": 1,
"episode_index": 1,
"split": "<string>",
"trajectory_id": "<string>",
"group_path": "<string>",
"camera_key": "<string>"
}
],
"jpeg_bytes": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>"
}
],
"padded_jpeg": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>",
"camera_key": "<string>",
"compress_len_path": "<string>",
"camera_index": 1
}
],
"image_path": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"encoding": "<string>",
"layout": "<string>",
"frames": 123,
"height": 123,
"width": 123,
"channels": 123,
"episode_index": 1,
"first_frame_path": "<string>",
"fps": 1,
"split": "<string>",
"trajectory_id": "<string>",
"camera_key": "<string>"
}
],
"numeric_tensor": [
{
"path": "<string>",
"shape": [
123
],
"dtype": "<string>",
"ndim": 1,
"size": 1
}
]
},
"preview_assets": [
{
"path": "<string>",
"label": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"metadata": {}
}
],
"episodes": [
{
"episode_index": 1,
"split": "<string>",
"trajectory_id": "<string>",
"frames_path": "<string>",
"group_path": "<string>",
"length_frames": 1,
"duration_sec": 1
}
],
"truncated": true,
"root_attrs": {}
},
"preview_assets": [
{
"path": "<string>",
"label": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"metadata": {}
}
],
"started_at": "<string>",
"progress_pct": 123,
"progress_phase": "<string>",
"progress_message": "<string>",
"downloaded_bytes": 123,
"total_bytes": 123,
"attempt_count": 0,
"max_attempts": 3,
"claim_epoch": 0,
"claimed_by": "<string>",
"claimed_at": "<string>",
"claim_expires_at": "<string>",
"last_heartbeat_at": "<string>",
"retry_after": "<string>",
"last_error": "<string>",
"consistency_status": "unknown",
"consistency_checked_at": "<string>",
"consistency_error": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Clerk session JWT for browsers, or nmp_ personal access token for CLI/SDK clients. Not accepted by ClerkSession-only operations.
Headers
Body
application/json
Request body for POST /imports/from-catalog.
catalog_id is the catalog item's id (as returned by GET /api/datasets);
BE resolves it against the catalog registry to discover the real source
coordinates (hf_repo_id, etc.) so the FE never has to re-derive them.
folder_id is the optional My-Data folder the resulting dataset's file
should land in once the import materializes (None = project root). It's
validated against the project at job-create time.
Response
Successful Response
Show child attributes
Show child attributes
⌘I

