Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "A Google Maps shared-list link (maps.app.goo.gl works). Omit when sending picks."
},
"title": {
"type": "string",
"description": "The source list's own name, e.g. \"@tinnedfish's posts\" or \"Films I rewatch\". Required with picks."
},
"source_owner": {
"type": "string",
"description": "Whose list or account it is, when it is not the person's own, e.g. \"@tinnedfish\". Credits them on the list."
},
"own_list": {
"type": "boolean",
"description": "True (default) when the source is the person's own: their notes become their notes. False for someone else's list or account: words stay credited to them."
},
"sort": {
"type": "boolean",
"description": "True when most entries are probably not recommendations (an account's posts, saved posts): everything arrives unsorted for the person to keep or skip. Default false: everything arrives kept."
},
"list": {
"type": "string",
"description": "Optional destination list. Otherwise commit_import can make a new private list."
},
"picks": {
"type": "array",
"maxItems": 1000,
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"note": {
"type": "string",
"description": "The person's own words, only when the source is theirs."
},
"author": {
"type": "string",
"description": "Author or creator as the person gives it (books, articles, posts), e.g. from \"Title - Author - why\". Stored as the pick's author and never replaced by added details. Keep it out of the note."
},
"source_text": {
"type": "string",
"description": "Someone else's words about it (a caption or review), quoted exactly and short. Kept credited, never the person's note."
},
"source_account": {
"type": "string",
"description": "Who wrote source_text, e.g. \"@tinnedfish\"."
},
"saved_at": {
"type": "string",
"description": "When it was posted or saved at the source, ISO 8601."
},
"entry_key": {
"type": "string",
"description": "A stable id for this entry in its source (a post's permalink id), so running again brings only new entries."
},
"item_type": {
"type": "string",
"description": "place, book, movie, music, post, product or another Curated type, when obvious."
}
},
"required": [
"title"
],
"additionalProperties": false
}
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"description": "Optional retry key. Reusing it with identical input replays the first result."
}
},
"additionalProperties": false
}