PUT content/update/:id

Updates an existing Joomla content article.

Resource URL

https://yourdomain.com/api/v1/content/update/:id

Resource Information

Option Description
Response formats JSON
Requires authentication Yes, session-based or custom header token
Rate limited YES

Request Parameters

Name Details
title
  • optional
alias
  • optional
  • alpha-numeric, no spaces
introtext
  • optional
fulltext
  • optional
catid
  • optional
created_by_alias
  • optional
state
  • optional
access
  • optional
robots
  • optional
author
  • optional
rights
  • optional
xreference
  • optional
language
    *, en-GB or other language code
  • optional

Example Request

You will need to character-encode your input to retain spaces and ensure special characters are not processed.

PUT https://yourdomain.com/api/v1/content/update/42
?title=New Article Title
&introtext=Short introduction for your article.
&fulltext=This is the main content of your article.
&catid=7
&created_by_alias=
&state=1
&access=1
&robots=
&author=
&rights=
&xreference=
&language=en-GB

Example Result

JSON Response

{
  "msg": Updated content item id = 42,
  "error": false,
  "status": 200
}

Response Headers

The following response headers follow a successful article posting when using token authentication via custom header. Note the Rate Limitation headers which are included be cause a token authenticated this session.

HTTP/1.1 200 OK
Date: Sun, 25 Oct 2015 22:08:58 GMT
Server: Apache/2.2.15
X-Powered-By: PHP/5.4.45
Joomla-Sessionid: 3o99399999fucdjqkqs99999p6
X-Rate-Calls-Remaining: 0
X-Rate-Limit-Limit: 0
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: origin, x-requested-with, content-type, token
Access-Control-Allow-Methods: PUT, GET, POST, DELETE, OPTIONS
Connection: close
Transfer-Encoding: chunked
Content-Type: application/json