tasks
tasks

Beacon presence for a device watching this task

Idempotent upsert: marks the calling user + device_id as actively watching this task for the next ~60 seconds. While at least one device for the user has a non-expired presence row for this task, the push fanout will skip ALL of that user's other registered devices for task notifications — the contract is 'if any device is demonstrably watching, suppress the others'. Clients call this every ~30s while the task screen is foregrounded. device_id is the UUID of the caller's UserPushToken row.

post/api/projects/{project_id}/tasks/{id}/presence/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/tasks/{id}/presence/
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required
project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

device_idstring uuid required

UUID of the caller's UserPushToken (returned by /api/users/@me/push_tokens/ on register).

Response

Presence recorded for this device.

Changes

No recorded changes to this operation across all 1 revision of this API.