The workspace's email voice
What an assistant should read before writing an email on the workspace's behalf: language, style guide, the AI agent's persona and the team's recent real emails.
Download the full API pública projection: openapi.json.
Write emails with an assistant explains this resource in prose, with runnable examples.
| Method | Path | What it does |
|---|---|---|
GET | /copilot/email-voice | The workspace's email voice — read it before writing an email |
GET /copilot/email-voice
The workspace's email voice — read it before writing an email
Everything an AI needs to write an email that sounds like THIS workspace, in one read and with no model call: the workspace language (locale), its written style guide, the persona of the AI agent that serves its email (agent_instructions — take its tone, ignore its channel mechanics), up to five real emails people of the workspace recently sent (quoted history and signatures stripped, each capped at ~1,200 characters), the caller's default signature, and — with contact_id — the recipient.
If you are a user's own assistant connected through the Vitrina MCP, call this before drafting an email, write in locale, imitate the sample emails (never copy their facts), then save the result with POST /email-drafts for a person to review and send. Leave the signature out of the body: it is appended when the person sends.
The voice is the WORKSPACE's, not a member's: most human replies are typed straight into the connected mailbox, so the samples are the team's mail, not the caller's.
| Parameter | In | Type | Required | Constraints |
|---|---|---|---|---|
contact_id | query | uuid | no |
curl https://api.vitrinadev.com/api/v1/copilot/email-voice \
-H "Authorization: Bearer $VITRINA_KEY"Example response (200)
{
"data": {
"locale": "es",
"style_guide": "Cercano y claro. Tuteamos. Frases cortas. Nunca prometemos plazos que no controlamos.",
"agent_instructions": "Eres el asistente del equipo. Respondes con calidez y precisión, tuteas y cierras siempre con un próximo paso concreto.",
"agent": {
"id": "33333333-0000-4000-8000-000000000001",
"name": "Asistente"
},
"sample_emails": [
{
"subject": "Tu cotización",
"body_text": "Hola Pedro,\n\nTe adjunto la cotización que conversamos. Cualquier duda me escribes por aquí o al WhatsApp.\n\nUn abrazo,",
"sent_at": "2026-09-20T13:40:00.000Z"
}
],
"signature": {
"id": "44444444-0000-4000-8000-000000000001",
"name": "Firma principal",
"text": "Persona del equipo\nEquipo comercial"
},
"contact": {
"id": "22222222-0000-4000-8000-000000000001",
"name": "María González",
"email": "[email protected]"
}
}
}Answers: 200 · 400 · 401 · 403 · 404 · 409 · 429