Personyze Personyze developer docs
Open Personyze
Account configuration

REST Actions object

Personyze developer documentation Questions: support@personyze.com

For information about how REST API works, see rest main page.

Read-only list of the actions in your account — the pieces of content a campaign can show. Use it to resolve the action_id values returned by campaign summaries, forms and product interactions into names, or to inventory what a Personyze account contains.

The endpoint URL is:

app.personyze.com/rest/actions

GET only. Actions are authored in the panel, not through this API.

Columns

Column Description
id The action id, as referenced elsewhere in the API.
name The action's name in the panel.
version_tag Which version this row describes — production or testing.
type_id The action type (banner, popup, recommendation block, email, and so on).
placeholders JSON array of the placeholder ids this action renders into, e.g. [14,15].
content_type How the action's content is stored.
content_param Which parameter of the action holds its content.
content_begin, content_end The HTML wrapper around the action's content, when it has one. Resolved for the requested version_tag.
presenting_rules The action's presentation rules, as stored.
libs_app Libraries the action depends on.

Requesting fewer columns makes the query cheaper — the content and wrapper columns require extra joins that are skipped when you don't ask for them.

Select example

Names and ids only:

curl 'https://api:FD09908F25BECB09D78EBEA1DADFB618651F612D@app.personyze.com/rest/actions/columns/id,name,type_id'

One action:

curl 'https://api:FD09908F25BECB09D78EBEA1DADFB618651F612D@app.personyze.com/rest/actions/where/id=88'

Only what is live:

curl 'https://api:FD09908F25BECB09D78EBEA1DADFB618651F612D@app.personyze.com/rest/actions/where/version_tag=production/columns/id,name,placeholders'

Related

conditions — the campaigns that decide when an action runs.