ListDrop

Saves list-shaped content as a ListDrop list the user can keep, check off, and share: an itinerary, a reading or watch list, a packing list, gift ideas, an apartment or job-search shortlist, a step-by-step plan, a checklist. Applies when the user wants a list to outlive the conversation. Not meant for throwaway answers, secrets or sensitive data (a list is unowned until claimed), or content that isn't list-shaped. Without a connected account the list is created private and unowned, and the result contains a secret claim URL: opening it is the only way to view and keep the list, and unclaimed lists are deleted after 30 days. With a connected ListDrop account (OAuth, lists:write) the list is created directly in that account, private, and the result contains its URL instead. A URL inside an item becomes a titled, linked item. Optional fields: allowed_emails shares the private list view-only with specific people, who open the returned share URL and verify their address with a one-time email link (no account needed); expires_in_days makes the list archive itself on a date, for trips and events.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "emoji": {
      "type": "string",
      "maxLength": 8
    },
    "description": {
      "type": "string",
      "maxLength": 280
    },
    "tags": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "items": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "note": {
                "type": "string",
                "maxLength": 140
              }
            },
            "required": [
              "text"
            ]
          }
        ]
      }
    },
    "allowed_emails": {
      "description": "Email addresses allowed to VIEW this private list (view-only guest list).",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_in_days": {
      "description": "Self-archive after this many days (list becomes owner-only).",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "title",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns a PUBLIC ListDrop list as markdown (title, items, notes, links), given its URL (https://www.listdrop.co/l/<id>/…) or bare id. Private lists are never readable.

{
  "type": "object",
  "properties": {
    "list": {
      "type": "string",
      "minLength": 6,
      "maxLength": 300,
      "description": "List URL or id"
    }
  },
  "required": [
    "list"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns the connected user's own lists (titles, visibility, item counts, URLs), private ones included. Requires a connected ListDrop account (OAuth, lists:read scope); without one the server answers 401.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Sends a message to the ListDrop team when the user asks to report a problem, request a feature, or give feedback about ListDrop. A person reads every message. No account needed. The message should contain only what the user wants sent: no claim URLs, tokens, or personal data. The email field is for a user who asked for a reply and gave their address.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "minLength": 4,
      "maxLength": 2000,
      "description": "What happened, in plain words. Concrete beats polite: the call you tried, what you expected."
    },
    "kind": {
      "description": "problem | idea | praise | other",
      "type": "string",
      "enum": [
        "problem",
        "idea",
        "praise",
        "other"
      ]
    },
    "email": {
      "description": "Only if your user wants a reply and gave you their address.",
      "type": "string",
      "maxLength": 254
    }
  },
  "required": [
    "message"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}