Skip to content

Extract a LinkedIn profile to seed a twin

POST
/voice/twins/extract-linkedin

SPENDS CREDITS. Enriches a LinkedIn profile URL into the headline, current position, employment history and education a twin is seeded from. Reaches a paid enrichment provider on your behalf, so it is tiered billable.

Voice binds linkedin_url as a FORM field; the JSON body here is re-encoded as form data. Voice answers {"success": false, "error": ...} with a 200 when the profile cannot be extracted - read success.

A two-segment LITERAL under /voice/twins, declared before the /twins/{agent_id} routes; test_voice_stage2_api.py proves it resolves and that /twins/<id> still reaches its shipped handler.

Authorizations

Parameters

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body required

POST /api/v1/twins/extract-linkedin binds linkedin_url as a FORM field; this is the JSON shape the API takes and the router re-encodes.

object
linkedin_url
required

A LinkedIn profile URL, e.g. https://linkedin.com/in/name

string
>= 1 characters

Responses

200

Successful Response

object
data
required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

object
key
additional properties
any
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string