List personas
Browse the personas of the workspace.
Returns the personas of your workspace, a page at a time, oldest first. Archived personas are not listed. Use a persona id as persona_id where an endpoint asks for one.
Route
GET/api/v3/personas
Access modes
Use a workspace API key. The workspace is inferred from the key.
Authorization: Bearer sk_live_...Query parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| page_size | integer | Items per page, from 1 to 100. Defaults to 25. |
Example request
curl "https://api.getsillage.com/api/v3/personas?page=1&page_size=25" \
-H "Authorization: Bearer $SILLAGE_API_KEY"Success response
Status: 200 OK
{
"data": [
{
"id": 7,
"name": "Sales EMEA persona",
"job_titles": ["VP Sales", "Head of Sales"],
"excluded_job_titles": ["Intern"],
"locations": ["United States", "France"],
"headcounts": ["51-200", "201-500"],
"industries": ["Software"],
"seniorities": ["vp", "head"],
"exclusion_criteria": ["Agencies"],
"tag": "smb-us"
}
],
"meta": {
"pagination": {
"page": 1,
"page_size": 25,
"page_count": 1,
"total": 1
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
| data[].id | integer | ID of the persona. |
| data[].name | string | The persona's name, as shown in the app. |
| data[].job_titles | array of string | Target job titles. [] when there are none. |
| data[].excluded_job_titles | array of string | People whose LinkedIn headline contains one of these words won't become leads. |
| data[].locations | array of string | Target locations: countries or regions. [] when there are none. |
| data[].headcounts | array of string | Target headcount ranges. [] when there are none. |
| data[].industries | array of string | Target industries. [] when there are none. |
| data[].seniorities | array of string | The seniority levels this persona targets. |
| data[].exclusion_criteria | array of string | Sentences or keywords describing who to leave out. |
| data[].tag | string or null | The short label you set to recognise this persona. Never used for targeting, and unique across the personas of the workspace. |
| meta.pagination.page | integer | Current page. |
| meta.pagination.page_size | integer | Items per page. |
| meta.pagination.page_count | integer | Number of pages. |
| meta.pagination.total | integer | Total number of items. |
See Pagination.
Errors
| Status | Meaning |
|---|---|
| 401 | The API key is missing or invalid. |
| 422 | page or page_size is not valid, or a query parameter is not known. |
| 429 | Rate limit exceeded. |
| 500 | An unexpected server error occurred. |
Error responses use RFC 9457 problem documents with Content-Type: application/problem+json. type is always about:blank; code tells one problem from another, detail says what went wrong this time, and errors names the field at fault.