Upsert Persona

Creates or replaces the ICP persona for the workspace. Calling this endpoint a second time fully replaces the existing persona.

Upsert workspace persona

Deprecated — use Create persona or Update persona instead

This endpoint only ever replaces the workspace's oldest persona, so it cannot create a second business line. It keeps answering, but will be removed in a future major version. Use Create persona to create one and Update persona to update one instead.

PUT/api/v2/partner/workspaces/{partner_workspace_id}/persona

Path parameters

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

Request body

job_title and location are required; the other fields are optional. Omitting an optional field leaves it unchanged on update.

Field	Type	Description
job_title	array of strings	Required. Target job titles — at least one entry.
exclude_job_title	array of strings	Job titles to exclude.
location	array of strings	Required. Target locations — at least one entry. Include at least one country (a city alone is not enough) so account mapping can run.
headcount	array of strings	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	array of strings	Target industries.
seniority	array of strings	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.

Example request

curl -X PUT "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/persona" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": ["VP Sales", "Head of Growth"],
    "location": ["France"],
    "headcount": ["51-200", "201-500"],
    "seniority": ["director", "vp", "c_suite"]
  }'

Example response

{
  "data": {
    "id": 55
  }
}

The response returns the id of the upserted persona.

Errors

Status	Meaning
400	Invalid request body.
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`.
429	Too many requests.
500	An unexpected server error occurred.

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