diff --git a/mods/ITEMS/mcl_throwing/API.md b/mods/ITEMS/mcl_throwing/API.md
index a75a71635..f2b1c7374 100644
--- a/mods/ITEMS/mcl_throwing/API.md
+++ b/mods/ITEMS/mcl_throwing/API.md
@@ -1,3 +1,35 @@
 # mcl_throwing
 
-## mcl_throwing.throw(throw_item, pos, dir, velocity, thrower)
\ No newline at end of file
+## mcl_throwing.throw(throw_item, pos, dir, velocity, thrower)
+Throw a throwable item.
+
+* throw_item: itemstring of the throwable item
+* pos: initial position of the entity
+* dir: direction where the throwable item will be thrown
+* velocity: (optional) will overide the default velocity value (can be nil)
+* thrower: (optional) player/entity who throw the object (can be nil)
+
+## mcl_throwing.register_throwable_object(name, entity, velocity)
+Register a throwable item.
+
+* name: itemname of the throwable object
+* entity: entity thrown
+* velocity: initial velocity of the entity
+
+## mcl_throwing.dispense_function(stack, dispenserpos, droppos, dropnode, dropdir)
+Throw throwable item from dispencer.
+
+Shouldn't be called directly.
+
+Must be used in item definition:
+
+`_on_dispense = mcl_throwing.dispense_function,`
+
+## mcl_throwing.get_player_throw_function(entity_name, velocity)
+
+Return a function who handle item throwing (to be used in item definition)
+
+Handle creative mode, and throw params.
+
+* entity_name: the name of the entity to throw
+* velocity: (optional) velocity overide (can be nil)