account.getQuota album.create album.delete album.docs.add album.docs.getContext album.docs.getList album.docs.remove album.docs.setList album.edit album.get album.getFaves album.getList album.getVisitors album.orderList album.setPerms api.methods.get api.methods.getList auth.checkToken auth.getFrob auth.getToken doc.albums.add doc.checkMD5 doc.comments.add doc.comments.delete doc.comments.edit doc.comments.get doc.comments.getList doc.comments.reply doc.delete doc.get doc.getContainers doc.getContext doc.getExif doc.getFaves doc.getList doc.getMedias doc.getPerms doc.getVisitors doc.notes.add doc.notes.delete doc.notes.edit doc.search doc.set doc.setGeo doc.setLicense doc.setPerms doc.setSafety doc.tags.add doc.tags.edit doc.tags.getList doc.tags.remove explore.docs.getPopular explore.docs.getRecent explore.docs.homepage explore.groups.getRandom faves.albums.add faves.albums.getList faves.albums.remove faves.docs.add faves.docs.getList faves.docs.remove folder.albums.add folder.albums.getList folder.albums.remove folder.create folder.delete folder.edit folder.get folder.getList folder.orderList group.docs.add group.docs.getContext group.docs.getList group.docs.remove group.get group.getList group.search network.autocomplete network.docs.getRecent network.getList post.comments.add post.comments.delete post.comments.edit post.comments.get post.comments.getList post.comments.reply post.get post.getContext post.getFaves post.getList post.getVisitors post.search post.set tags.docs.getList tags.user.getList tags.user.getPopular test.echo test.hello upload.checkTickets upload.file upload.replace user.get

Live testing

Edit a article title and description.

• This method call must be authenticated and signed.
• This method requires "write" permission on blog.

URL

HTTP POSThttps://api.ipernity.com/api/post.set

Parameters

api_key	∗	Your api_key.
post_id		The ID of the article you wish to edit (if no provided, a new article is created)
title	∗	The new title for this article
content	∗	The new content
intro		The new intro
com		The new permissions to comment on the article: 0: only you 3: friends & family 7: contacts 15: every member
tag		The new permissions to add a tag: 0: only you 3: friends & family 7: contacts 15: every member
tagme		The new permissions to let a member add his personal member tag: 0: only you 3: friends & family 7: contacts 15: every member
lg_id		Language ID. Values are : 1: french 2: english etc...
share		Set the privacy level with one parameter. Values are : 0: private 1: visible to family 2: visible to friends 3: visible to friends & family 31: public
license		The new license ID for the article. Valid license IDs are: 0: Copyright 1: Attribution (CC by) 3: Attribution+Non Commercial (CC by-nc) 5: Attribution+Non Deriv (CC by-nd) 7: Attribution+Non Commercial+Non Deriv (CC by-nc-nd) 9: Attribution+Share Alike (CC by-sa) 11: Attribution+Non Commercial+Share Alike (CC by-nc-sa) 255: Copyleft

∗ : this parameter is required.

Response

<post post_id="123" license="0" title="le titre" intro="" safety="0"
    link="https://www.ipernity.com/post/12345/123" >

  <visibility ispublic="0" isfamily="0" isfriend="0" share="" />

  <dates posted_at="1402043692" created="1402043692" last_comment_at="0" last_update_at="0" />

  <owner user_id="12345" username="" alias="" is_pro=""
        icon="https://u1.ipernity.com/p/00/00//nobuddy.m.jpg" />

  <count visits="0" faves="0" comments="0" tags="0" />

  <share url="https://www.ipernity.com/post/12345/123" />

</post>

Error codes

1	Post not found	The post ID is invalid or insufficient permissions to view this post.
2	No parameters were sent	At least one the title or the content parameter is needed.
3	Invalid arguments	Some additional argument values (privacy, license,...) are out of authorized bounds.
100	API Key is missing	Please add the api_key parameter to this request.
101	API Key is invalid	This API key is invalid or disabled.
102	Invalid format	The requested format is invalid. Valid formats are : json, xml, php.
103	Method not found	The requested method is invalid or missing.
104	Signature missing	The query signature is missing.
105	Signature is invalid	The query signature is invalid.
106	Token missing	User is not logged. The authentication token is missing.
107	Token invalid	The authentication token is invalid.
108	Account closed	The user account is closed or suspended.
109	Action blocked	This action is blocked because of a member or a group blocklist restriction
110	Insufficient permissions	Insufficient permissions for this method.
111	IP not allowed	The request came from a remote address not allowed by this application.
112	Application Quota Error	The application has reached its requests quota.
113	Client IP Quota Error	The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ...
120	HTTP POST required	This API method must be called using HTTP POST.
121	Invalid SOAP envelope	The SOAP envelope could not be parsed.
122	Invalid XML-RPC envelope	The XML-RPC envelope could not be parsed.
130	OAuth protocol version unsupported	We only support OAuth version 1.1 and 1.1a
131	OAuth parameters are missing	Some of the OAuth parameters were not sent: %s%
132	OAuth Clock skew	The timestamp sent is out of ranges. Please check your computer clock is not skewed.
133	OAuth Nonce is invalid	The OAuth Nonce parameter cannot be used twice.
134	OAuth Timestamp is invalid	The OAuth Timestamp parameter is out of ranges (clock skew) or inferior to the previous timestamp sent.
135	OAuth Signature method unsupported	The OAuth Signature must be either MD5, HMAC_SHA1 or PLAINTEXT over HTTPS.
500	Service error	Service general error.
501	Maintenance mode	Service under temporarily maintenance. Thank you for your kind understanding.
503	Service unavailable	The service is temporarily unavailable. Please try again in a few minutes.

Changelog

• 2014-06-05: Documentation added.

See also

• post.comments.add
• post.comments.delete
• post.comments.edit
• post.comments.get
• post.comments.getList
• post.comments.reply
• post.get
• post.getContext
• post.getFaves
• post.getList
• post.search