{"openapi":"3.1.0","info":{"title":"Collabulist Agent API","version":"1.0.0","description":"Public checklist creation and mutation endpoints for Collabulist disposable checklists."},"servers":[{"url":"https://collabulist.com"}],"paths":{"/api/lists/preview":{"post":{"summary":"Preview a create-list request without creating a list","operationId":"previewCreateList","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."},"title":{"type":"string","maxLength":120},"items":{"type":"array","minItems":1,"items":{"type":"string","minLength":1,"maxLength":500}},"website":{"type":"string","description":"Honeypot field; omit this field."}}}}}},"responses":{"200":{"description":"Normalized create-list preview."},"400":{"description":"Invalid create-list request."}}}},"/api/lists":{"post":{"summary":"Create a checklist","operationId":"createList","description":"Preferred create-list action. Send a client-generated clientMutationId to make retries idempotent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."},"title":{"type":"string","maxLength":120},"items":{"type":"array","minItems":1,"items":{"type":"string","minLength":1,"maxLength":500}},"website":{"type":"string","description":"Honeypot field; omit this field."}}}}}},"responses":{"200":{"description":"Duplicate retry accepted; the original list is returned."},"201":{"description":"List created."},"400":{"description":"Invalid create-list request."},"409":{"description":"The clientMutationId was reused for a different create-list request."}}}},"/l/{token}.json":{"get":{"summary":"Read public list JSON","operationId":"readPublicList","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public checklist state."}}}},"/api/lists/{token}/items":{"post":{"summary":"Add an item","operationId":"addItem","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."}}}}}},"responses":{"201":{"description":"Item added."}}}},"/api/lists/{token}/items/{itemId}/complete":{"post":{"summary":"Mark an item complete","operationId":"completeItem","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."}}}}}},"responses":{"200":{"description":"Requested checked state applied."}}}},"/api/lists/{token}/items/{itemId}/uncomplete":{"post":{"summary":"Mark an item incomplete","operationId":"uncompleteItem","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."}}}}}},"responses":{"200":{"description":"Requested checked state applied."}}}},"/api/lists/{token}":{"patch":{"summary":"Rename a list","operationId":"renameList","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","maxLength":120}}}}}},"responses":{"200":{"description":"List renamed."}}}},"/api/lists/{token}/items/order":{"patch":{"summary":"Reorder visible items","operationId":"reorderItems","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["itemIds"],"properties":{"itemIds":{"type":"array","minItems":1,"items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Items reordered."}}}},"/api/lists/{token}/items/{itemId}/claim":{"patch":{"summary":"Assign or unassign an item","operationId":"claimItem","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"claimantLabel":{"type":"string"},"claimantParticipantId":{"type":"string"},"claimantIsActor":{"type":"boolean"},"clear":{"type":"boolean"},"clientMutationId":{"type":"string","minLength":1,"maxLength":120,"description":"Client-generated idempotency key for safe retries."}}}}}},"responses":{"200":{"description":"Assignment changed."}}}}}}