Content API
Read a space's published articles as JSON with a ul_ct_ key and show them on your site or in your application with your own design.
On this page
The Content API returns the published articles of a Knowledge space as JSON, so your site or application can show them with its own design. It is the alternative to the Elion ITSM help center when you want your own help page.
Before you start
You need the administrator level in Settings (Administrator role).
The space with the published pages must exist.
Choose the key type
Type | What it is for | What it can read |
|---|---|---|
Browser (customer's public site) | Your website's JavaScript calls the API directly. | Only a Public space, and only from the Allowed sites you specify. |
Server (internal pages too) | Your server calls the API and delivers the content to your application. | Any unarchived space, including Internal or Portal. It is rejected if used from a browser. |
A Server key can read internal pages. Store it as a secret on your server; never put it in a web page's code or in a mobile app.
Create a key
Go to Settings → Help center and open the Import tab.
In the Content API card, choose the Space and click Create key.
Fill in Name, Type, Allowed sites (required for Browser, for example
https://www.miempresa.cl) and Expires (In 90 days, In 180 days, In one year or No expiry).Click Create key, copy the key with Copy key and click Done, I copied it.
The key is shown only once. In the table you can Rotate a key (the new one inherits everything and the previous one keeps working for 24 hours) or Revoke a key (it stops working immediately). Each space allows up to 10 active keys.
Request the content
All requests are GET to https://api-itsm.argunis.com/api/public/content/v1/… with the header Authorization: Bearer ul_ct_…. The space comes from the key.
Path | What it returns |
|---|---|
| The space's name, description and number of pages. |
| The menu: each page with |
| A page by its path. |
| A page by its number. |
| Full-text search (up to 50 results). |
| Pages that changed or stopped being published since that date (up to 1,000), to keep your copy up to date. |
| An image from a page, with the same key. |
curl -H "Authorization: Bearer ul_ct_…" \
"https://api-itsm.argunis.com/api/public/content/v1/pages?path=/primeros-pasos/iniciar-sesion"A page includes title, description, labels, html, toc (heading index), breadcrumbs, prev, next, updatedAt and version.
The
htmlcomes already cleaned, with the same elements the knowledge base accepts. You can insert it into your page.Links between pages come as
/<espacio>/<ruta>. Replace them with your site's paths.Images point to
/api/public/content/v1/assets/<id>and are requested with the same key.If the path changed, it returns
{ "redirect": "/ruta-nueva" }.
What it does not return
Drafts, earlier versions, comments, ratings or pages from archived spaces.