---
title: "POST /v1/enterprise/heartbeats"
method: POST
path: "/v1/enterprise/heartbeats"
tags: ["v1"]
---

# POST /v1/enterprise/heartbeats

`POST /v1/enterprise/heartbeats`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/v1/enterprise/heartbeats`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- Heartbeat
  - `instance_id` string, uuid, required
  - `license_id` string, required
  - `version` string
  - `deployment_type` string
  - `timestamp` string, date-time, required
  - `nonce` string, required
  - `sequence` integer, required
  - `usage_data` object

## Response `200`

OK

- EnterpriseHeartbeatResponse
  - `status` 'accepted' | 'ignored' | 'rejected', required
  - `reason` string
  - `grant_status` string
  - `expires_at` string, date-time
  - `renewal_notice` string

## Other responses

- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)