Skip to content

Quick Add API

All endpoints require authentication. Base path: /api/v1/dashboard/quick-add.

MethodPathDescription
POST/v1/dashboard/quick-add/detectDetect content type from input
POST/v1/dashboard/quick-add/commitCommit the detected item
POST /v1/dashboard/quick-add/detect

Analyzes a URL or text string and returns the detected content type, confidence score, and whether confirmation is needed.

Request Body:

FieldTypeRules
contentstringRequired. URL or text to analyze

Response:

{
"success": true,
"data": {
"content": "https://www.deezer.com/album/123456",
"content_type": "music",
"confidence": 0.95,
"needs_confirmation": false,
"metadata": { }
}
}

Detected types:

TypeDescription
musicDeezer/Discogs URL
booksHardcover/Goodreads URL
moviesIMDb URL
gamesSteam/BGG URL
recipesChefkoch URL
linksAny other URL
todoText containing due, repeat, or link:
notePlain text with no signals
plantsPlant entry (manual selection)
quotesQuote entry (manual selection)
feedFeed subscription (manual selection)
clipboardClipboard text (manual selection)

See Quick Add for the detection rules. needs_confirmation is true when confidence is below 60%.

POST /v1/dashboard/quick-add/commit

Saves the item to the appropriate library.

Request Body:

FieldTypeRules
contentstringRequired. The original URL or text
content_typestringRequired. One of the types above
metadataobjectOptional. Extra fields for the target library