path: root/doc/api_item_store.md

API item/store
==============

Usage: POST /api/z/1.0/item/store

Description: item/store posts an item (typically a conversation item or post, but can be any item) using form input.  


Required:

- body

	text/bbcode contents by default.


Optional:

- $_FILES['media']
	uploaded media file to include with post

- title
	title of post/item

- contact_allow
	array of xchan.xchan_hash allowed to view this item

- group_allow
	array of group.hash allowed to view this item

- contact_deny
	array of xchan.xchan_hash not allowed to view this item

- group_deny
	array of group.hash not allowed to view this item

- coord
	geographic coordinates

- location
	freefrom location

- expire
	datetime this post will expire or be removed

- mimetype
	mimetype if not text/bbcode

- parent
	item.id of parent to this post (makes it a comment)

- parent_mid
	alternate form of parent using message_id

- remote_xchan
	xchan.xchan_hash of this message author if not the channel owner

- consensus
	boolean set to true if this is a consensus or voting item (default false)

- nocomment
	boolean set to true if comments are to be disabled (default false)

- origin
	do not use this without reading the code

- namespace
	persistent identity for a remote network or service

- remote_id
	message_id of this resource on a remote network or service

- message_id
	message_id of this item (leave unset to generate one)

- created
	datetime of message creation

- post_id
	existing item.id if this is an edit operation

- app
	application or network name to display with item

- categories
	comma separated categories for this item

- webpage
	item.page_type if not 0

- pagetitle
	for webpage and design elements, the 'page name'

- layout_mid
	item.mid of layout for this design element

- plink
	permalink for this item if different than the default

- verb
	activitystream verb for this item/activity

- obj_type
	activitystream object type for this item/activity