Get Persona
Retrieve a single persona from your workspace by id.
Returns a single persona by its id. Returns 404 if the id is unknown, belongs to an archived persona, or belongs to another workspace.
Get persona
GET/api/v2/personas/{persona_id}
Path parameters
| Parameter | Type | Description |
|---|---|---|
| persona_id | integer | ID of the persona, as returned by List personas. This ID is specific to your environment. |
Example request
curl "https://api.getsillage.com/api/v2/personas/1234" \
-H "Authorization: Bearer $SILLAGE_API_KEY"Example response
{
"data": {
"id": 1234,
"job_title": ["VP Sales", "Head of Sales"],
"exclude_job_title": null,
"location": ["France", "Germany"],
"headcount": null,
"industry": null,
"seniority": ["vp", "director"],
"additional_info": null,
"tag": "enterprise-emea"
}
}Response fields
| Field | Type | Description |
|---|---|---|
| data.id | integer | ID of the persona, as returned by List personas. This ID is specific to your environment. |
| data.job_title | string[] | Target job titles. |
| data.exclude_job_title | string[] | Job titles to exclude. |
| data.location | string[] | Target locations. |
| data.headcount | string[] | Target headcount ranges. Valid values: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+. |
| data.industry | string[] | Target industries. |
| data.seniority | string[] | Target seniority levels. Valid values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. |
| data.additional_info | string | Additional free-text persona context. |
| data.tag | string | Short free-form label you can set to recognise this persona in your own systems. Never used for targeting, and unique across your workspace's personas. |
Errors
| Status | Description |
|---|---|
| 401 | The API key is missing or invalid. |
| 404 | The persona does not exist. |
| 422 | Invalid persona_id — must be a positive integer. |
| 429 | Too many requests. |
| 500 | An unexpected server error occurred. |