Get persona
Retrieve your workspace's ideal customer profile targeting criteria.
Get persona
GET/api/v2/persona
Returns the authenticated workspace's persona. Returns 200 with { "data": null } when no persona has been configured yet — this is a normal state for a fresh workspace, not an error.
Example request
curl "https://api.getsillage.com/api/v2/persona" \
-H "Authorization: Bearer $SILLAGE_API_KEY"const response = await fetch('https://api.getsillage.com/api/v2/persona', {
headers: {
Authorization: `Bearer ${process.env.SILLAGE_API_KEY}`,
},
})
const result = await response.json()import { request } from 'node:https'
const req = request(
new URL('https://api.getsillage.com/api/v2/persona'),
{
headers: {
Authorization: `Bearer ${process.env.SILLAGE_API_KEY}`,
},
},
(res) => {
let data = ''
res.on('data', (chunk) => {
data += chunk
})
res.on('end', () => {
console.log(JSON.parse(data))
})
},
)
req.end()import os
import requests
response = requests.get(
"https://api.getsillage.com/api/v2/persona",
headers={"Authorization": f"Bearer {os.environ['SILLAGE_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
result = response.json()Example response
Configured workspace:
{
"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
}
}Fresh workspace with no persona yet:
{
"data": null
}Response fields
| Field | Type | Description |
|---|---|---|
| data | object | null | Persona object, or null if no persona has been configured. |
| data.id | integer | Persona numeric SQL identifier. Not portable across environments. |
| 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. |