Skip to main content
GET/api/public/v1/bookmarks/imports/{id}

bookmarks.get

One import with every link (root bar/other, folder path, title, URL), examples of rejected links and its last 200 per-profile applications you can see.

Capability: profile.readMCP tool: bookmarks_get
View as Markdown

Parameters

NameTypeRequiredDescription
idpathstring (uuid)YesBookmark import id

Examples

curl "https://browlix.com/api/public/v1/bookmarks/imports/<id>" \
  -H "Authorization: Bearer $BROWLIX_API_KEY"

Response

200 with { data, correlation_id }.

FieldTypeAlways presentDescription
dataobjectYes
data.idstring (uuid)Yes
data.namestringYes
data.source_namestringNo
data.linksintegerYes(min -9007199254740991, max 9007199254740991)
data.foldersintegerYes(min -9007199254740991, max 9007199254740991)
data.rejected_countintegerYes(min -9007199254740991, max 9007199254740991)
data.rejectedarray<object>NoUp to 50 examples (title and scheme only)
data.rejected[].reason"unsafe_scheme" | "invalid_url" | "credentials" | "too_long" | "too_deep" | "over_limit"Yes
data.rejected[].titlestringYes
data.rejected[].schemestringYes
data.duplicates_in_fileintegerYes(min -9007199254740991, max 9007199254740991)
data.sha256stringYes
data.created_atstringYes
data.pendingintegerYesProfiles that still wait for (or are applying) this import (min -9007199254740991, max 9007199254740991)
data.appliedintegerYes(min -9007199254740991, max 9007199254740991)
data.itemsarray<object>Yes
data.items[].root"bar" | "other"Yes
data.items[].patharray<string>Yes
data.items[].titlestringYes
data.items[].urlstringYes
data.applicationsarray<object>Yes
data.applications[].idstring (uuid)Yes
data.applications[].profile_idstring (uuid)Yes
data.applications[].profile_namestringNo
data.applications[].profile_numberintegerNo(min -9007199254740991, max 9007199254740991)
data.applications[].set_idstring (uuid)No
data.applications[].set_namestringYes
data.applications[].mode"merge" | "replace"Yes
data.applications[].scope"folder" | "all"Yes
data.applications[].folderstringNo
data.applications[].state"pending" | "applying" | "applied" | "failed" | "cancelled"Yes
data.applications[].revintegerYes(min -9007199254740991, max 9007199254740991)
data.applications[].session_idstring (uuid)No
data.applications[].resultobjectNo
data.applications[].result.addedintegerYes(min -9007199254740991, max 9007199254740991)
data.applications[].result.duplicatesintegerYes(min -9007199254740991, max 9007199254740991)
data.applications[].result.removedintegerYes(min -9007199254740991, max 9007199254740991)
data.applications[].reasonstringNo
data.applications[].created_atstringYes
data.applications[].updated_atstringYes
correlation_idstring (uuid)Yes

New fields can appear at any time; ignore the ones you do not know.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
NOT_FOUND404No
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations