List Personas

Returns a paginated list of active personas for the workspace — each one a distinct ideal customer profile (business line) used for signal scoring, account prioritization, and content generation.

List personas

GET/api/v2/partner/workspaces/{partner_workspace_id}/personas

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.

Query parameters

Parameter	Type	Default	Description
page	integer	1	Page number. Must be greater than or equal to 1.
page_size	integer	25	Number of items per page. Must be between 1 and 100.

Example request

curl "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/personas?page=1&page_size=25" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "data": [
    {
      "id": 1234,
      "job_title": ["VP Sales", "Head of Growth"],
      "exclude_job_title": null,
      "location": ["France"],
      "headcount": ["51-200", "201-500"],
      "industry": null,
      "seniority": ["director", "vp", "c_suite"],
      "additional_info": null,
      "tag": "enterprise-emea"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 1
    }
  }
}

Response fields

Field	Type	Description
id	integer	ID of the persona, as returned by this endpoint. This ID is specific to your environment.
job_title	string[]	Target job titles.
exclude_job_title	string[]	Job titles to exclude.
location	string[]	Target locations.
headcount	string[]	Target company headcount ranges. Allowed values: `1-10`, `11-50`, `51-200`, `201-500`, `501-1,000`, `1,001-5,000`, `5,001-10,000`, `10,001+`.
industry	string[]	Target industries.
seniority	string[]	Target seniority levels. Allowed values: `owner`, `founder`, `c_suite`, `partner`, `vp`, `head`, `director`, `manager`, `senior`, `entry`, `intern`.
additional_info	string	Free-text additional instructions or context for the persona.
tag	string	Short free-form label you can set to recognise this persona in your own systems. Never used for targeting, and unique across the workspace's personas.
meta.pagination.page	integer	Current page number.
meta.pagination.page_size	integer	Number of personas per page.
meta.pagination.page_count	integer	Total number of pages.
meta.pagination.total	integer	Total number of active personas in the workspace.

Errors

Status	Meaning
401	The master key is missing or invalid.
403	The master key is not authorized to access this resource.
404	No workspace found for this `partner_workspace_id`.
422	Invalid `page` or `page_size` query parameter.
429	Rate limit exceeded.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json.