---
title: "REST API: Personas"
type: "wiki"
space: "Axero Documentation"
author: "JD Flores"
created: 2022-05-12T15:00:56Z
updated: 2026-09-28T01:19:10Z
url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90408/rest-api-personas"
---

# REST API: Personas

[Open API Guide](https://my.axerosolutions.com/spaces/5/axero-documentation/api-guide?id=90408)

Create and manage personas, the groups of users defined by profile conditions, and read which users match them. A persona's actions can add matching users to spaces, remove them, or give them site roles.

## Available Endpoints

| Method | Endpoint | Description |
| :--- | :--- | :--- |
| POST | [Add Persona](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90735/api)<br>`/api/personas` | Create a persona. |
| GET | [Check User Matches Persona](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113360/api)<br>`/api/personas/{PersonaID}/conditions/users/{UserID}/matched/status` | Reports whether one user matches a persona's conditions right now. |
| DELETE | [Delete Persona](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90410/api)<br>`/api/personas/{PersonaID}` | Delete a persona. |
| GET | [Get Persona Actions](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113357/api)<br>`/api/personas/{PersonaID}/actions` | Returns the actions of a persona: the spaces it adds matching users to or removes them from, and the site roles it assigns. |
| GET | [Get Persona by PersonaID](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90409/api)<br>`/api/personas/{PersonaID}` | Get a persona by its ID. |
| GET | [Get Persona Conditions](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113356/api)<br>`/api/personas/{PersonaID}/conditions` | Returns the conditions of a persona: the profile fields, operators, values, and grouping that decide which users match it. |
| GET | [Get Personas](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90407/api)<br>`/api/personas` | Get the personas on the site or in a space. |
| GET | [Get Personas Count](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113359/api)<br>`/api/personas/count` | Returns the number of personas, with the same space and view filters Get Personas takes. |
| GET | [Get Users for Persona](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90556/api)<br>`/api/personas/{PersonaID}/users` | Get the users who match a persona's conditions. |
| PUT | [Run All Persona Actions](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/113358/api)<br>`/api/personas/actions/runall` | Queue the actions of every enabled persona to run in the background. |
| PUT | [Update Persona](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/90776/api)<br>`/api/personas/{PersonaID}` | Update a persona. |