---
title: "Presence"
method: POST
path: "/companies/{company_id}/templates/{template_id}/presence"
tags: ["creatives"]
---

# Presence

`POST /companies/{company_id}/templates/{template_id}/presence`

## Request

- Base URL: `https://app.zalster.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zalster.com/companies/{company_id}/templates/{template_id}/presence`
- Auth: none declared

The editor's heartbeat: "I am here". Answers who else is, and the draft as saved.

Every few seconds while a template is open, so the editor can say who else
is editing and notice a draft saved or a version published elsewhere.

## Path parameters

- `company_id` string, uuid, required: Company id
- `template_id` string, uuid, required

## Response `200`

Successful Response

- TemplatePresenceOut: Who else has the template open, and the draft and version as the server has them.
  - `editors` PresenceEditorOut[], required
    - `user_id` string, uuid, required
    - `name` string, required
    - `seen_at` string, date-time, required
    - `agent` boolean
  - `draft_revision` integer, required
  - `draft_saved_at` string, date-time, nullable, required
  - `draft_saved_by` string, uuid, nullable, required
  - `draft_saved_by_name` string, nullable, required
  - `active_version_id` string, uuid, nullable, required
  - `changes` PresenceChangesOut: The last batch of operations on the template (decision 196): who, and which layers.
    - `by` string, uuid, required
    - `by_name` string, required
    - `agent` boolean, required
    - `layers` string[], required
    - `revision` integer, required
    - `at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zalster/apis/zalster-feed-processor.md) - [All operations](https://skmtc.dev/zalster/apis/zalster-feed-processor/llms.txt) - [OpenAPI document](https://skmtc.dev/zalster/apis/zalster-feed-processor/revisions/d0b9dc66ad36?raw)