Skip to main content
POST
Import from the catalog

Authorizations

Authorization
string
header
required

Clerk session JWT for browsers, or nmp_ personal access token for CLI/SDK clients. Not accepted by ClerkSession-only operations.

Headers

Authorization
string | null

Path Parameters

org_slug
string
required
project_slug
string
required

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.

catalog_id
string
required
folder_id
string | null

Response

Successful Response

item
WorkspaceImportJob · object
required