Help / API

doc.set / Live testing

Edit a document title and description.

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

URL

HTTP POSThttp://www.ipernity.com/api/doc.set

Parameters

`api_key`	∗	Your api_key.
`doc_id`	∗	The ID of the document you wish to edit
`title`		The new title for this document
`description`		The new description for this document

∗ : this parameter is required.

The doc.set method can also be used to set the document permissions, license and safety. Additional parameters are described in the doc.setPerms and doc.setLicense methods.

Response

<doc doc_id="12345" title="A new title">
  <description>Well...</description>
</doc>

When setting other properties than title or content the API response will return a status and a possible error.

Error codes

1	`Document not found`	The document ID is invalid or insufficient permissions to view this doc.
2	`No parameters were sent`	At least one the `title` or the `description` 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.
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

2008-12-01: Method created.