# How to change text or image through API

**URL:** https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758
**Category:** Uncategorised Topics
**Created:** [November 16, 2016, 7:34am UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758 "2016-11-16T07:34:33Z")
**Posts on this page:** 5
**Page:** 1

<div class="post-metadata">

### Author: ![yuriG](https://community.xibo.org.uk/letter_avatar_proxy/v4/letter/y/90ced4/32.png) [@yuriG](https://community.xibo.org.uk/u/yuriG)
#### Post date: [November 16, 2016, 7:34am UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758/1 "2016-11-16T07:34:33Z")

</div>

Hello forum,  
We are looking for the way to be able to show notifications (both in text and graphical form) through the regions.  
Say we defined a region with text information. I want to be able to send API call from 3-rd party software to change the text that was set in the time of creation/update of the layout containing the region.

Can you point me to direction on how to do this?

Thank you in advance,  
Yuri.

---

<div class="post-metadata">

### Author: ![Peter](https://community.xibo.org.uk/user_avatar/community.xibo.org.uk/peter/32/8154_2.png) [@Peter](https://community.xibo.org.uk/u/Peter)
#### Post date: [November 16, 2016, 9:37am UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758/2 "2016-11-16T09:37:56Z")

</div>

EDIT: Just in case it wasn’t clear, the guide and the information below are exclusive to 1.8 API, I don’t think you can do any of those in 1.7.

Regarding images/media files, you can have a look at my guide there is a part with media upload, which with additional parameters can replace existing media file. -

> [@API Introduction with Postman](https://community.xibo.org.uk/t/1-8-api-introduction/7702):
>
> Introduction This guide is applicable for CMS 1.8 and later versions and assumes that you already have a working CMS. Players need to be version 1.8.0-rc1 or later and [XMR](http://xibo.org.uk/manual-tempel/en/xmr.html) also needs to be configured. As a first step, you will need to decide what application you will want to use to connect to the API. In this guide we will use [Postman](https://www.getpostman.com/) as an example application. The API documentation can be found in the [Developer manual](https://xibo.org.uk/docs/developer/) under the [Integration](https://xibo.org.uk/docs/developer/integrating-with-xibo) section. CMS Application No matter what applicatio…

Changing text, actually could prove to be somewhat difficult - it’s not documented at all yet.

In order to edit text in a region, you will need widgetId for that text item

Now, you will need to call GET Layout to get playlistId:  
 ![](https://community.xibo.org.uk/uploads/default/original/2X/3/336c2748fe5627ecbef9eefe1b84e78c2a5ff927.png)

Then call GET playlist to get widgedId you need:

 ![](https://community.xibo.org.uk/uploads/default/original/2X/c/c4c8f787b4f0e29894253ce52badb1e4c746acd9.png)

Please keep in mind there might be more widgets on your playlist, in my test there is only the text item to make it clearer.

Now that you have your widgetId, you can use PUT `playlist/widget/:widgetId` call to change the text it will be like this:

Headers:

 ![](https://community.xibo.org.uk/uploads/default/original/2X/e/e64a6123e50604468ec9d8532e3a91be1f2728ef.png)  
Body  
 ![](https://community.xibo.org.uk/uploads/default/original/2X/c/c67df331a30538d60ae95de46a49c0e08d10b68a.png)  
so you’re changing the text to:  
`<p><span style=color:#FFFFFF;><span style=font-size:48px;>TEST</span></span></p>`

The colour and font size are obviously just an example.

Hope that will help you.

---

<div class="post-metadata">

### Author: ![yuriG](https://community.xibo.org.uk/letter_avatar_proxy/v4/letter/y/90ced4/32.png) [@yuriG](https://community.xibo.org.uk/u/yuriG)
#### Post date: [November 27, 2016, 5:30pm UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758/3 "2016-11-27T17:30:44Z")

</div>

Peter hello.  
Thank you for reply.  
We are currently on version 1.7.9 which we were able to download from your website for linux.

Should we upgrade to 1.8 and if yes how we can get it?  
Or will it work on 1.7.9?

Also do you have dev documentation on how to extend out-of-the box API?

Thank you,  
Yuri

---

<div class="post-metadata">

### Author: ![Guru\_Evi](https://community.xibo.org.uk/letter_avatar_proxy/v4/letter/g/f4b2a3/32.png) [@Guru\_Evi](https://community.xibo.org.uk/u/Guru_Evi)
#### Post date: [November 27, 2016, 7:14pm UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758/4 "2016-11-27T19:14:48Z")

</div>

The 1.8 branches can be downloaded from GitHub. There is some documentation on the API here: [http://xibo.org.uk/manual/en/api.html](http://xibo.org.uk/manual/en/api.html)

The API uses SOAP and WSDL so the API should pretty much self-generate.

---

<div class="post-metadata">

### Author: ![Peter](https://community.xibo.org.uk/user_avatar/community.xibo.org.uk/peter/32/8154_2.png) [@Peter](https://community.xibo.org.uk/u/Peter)
#### Post date: [November 28, 2016, 9:36am UTC](https://community.xibo.org.uk/t/how-to-change-text-or-image-through-api/7758/5 "2016-11-28T09:36:43Z")

</div>

1.7 series has incomplete, not well documented API, if you wish to use the API we’d recommend to wait for 1.8 or try 1.8.0-rc1.  
1.8 API documentation is linked several times in my guide, [http://xibo.org.uk/manual-tempel/en/api.html](http://xibo.org.uk/manual-tempel/en/api.html) / [http://xibo.org.uk/manual-tempel/api/](http://xibo.org.uk/manual-tempel/api/)

1.8.0-rc1 download and upgrade instructions can be found here - [http://xibo.org.uk/manual-tempel/en/release\_notes\_1.8.0-rc1.html](http://xibo.org.uk/manual-tempel/en/release_notes_1.8.0-rc1.html)
