---
title: "POST /api/dcv/session-event"
method: POST
path: "/api/dcv/session-event"
tags: ["Virtual Desktops"]
---

# POST /api/dcv/session-event

`POST /api/dcv/session-event`

POST operation for /api/dcv/session-event

## Headers

- `X-EDH-Attested-Instance` string, required
- `X-EDH-DcvRelay-HMAC` string, required

## Request body

- object
  - `event_type` 'placed' | 'placement_failed' | 'session-ready' | 'session-resumed' | 'session-failed' | 'session-heartbeat' | 'bootstrap-checkpoint' | 'bootstrap-status', required — The lifecycle event type
  - `session_uuid` string, uuid, required — UUID of the DCV session
  - `instance_id` string, required — EC2 instance ID (not required for control-plane callers)
  - `event_timestamp` string, date-time, required — ISO-8601 timestamp of the event (must be within 5 min of server time)
  - `nonce` string, required — Unique nonce for replay protection
  - `checkpoint` string — Bootstrap checkpoint name (required for bootstrap-checkpoint events)
  - `sub_status` string — Free-form progress message (required for bootstrap-status events)

## Response `204`

Event accepted and applied successfully

## Other responses

- `401` — Authentication or validation failed (HMAC mismatch, missing fields, nonce replay, etc.)
- `413` — Request body exceeds maximum size (16 KiB)
- `500` — Internal error during event application

---

[API](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api.md) · [All operations](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/engineering-development-hub-edh-api/revisions/058396b8f0f1/schema)