---
title: "Check in with Dagu Console now"
method: POST
path: "/license/refresh"
tags: ["system"]
---

# Check in with Dagu Console now

`POST /license/refresh`

## Request

- Base URL: `http://localhost/api/v1`
- URL: `http://localhost/api/v1/license/refresh`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - none

Refreshes the license from Dagu Console instead of waiting for the next hourly check-in. Admin only.

## Query parameters

- `remoteNode` string

## Response `200`

License status after the check-in

- LicenseStatusResponse: Public status of the current Dagu license
  - `valid` boolean, required: Whether the loaded license token has not expired
  - `plan` string, required: License plan name
  - `expiry` string, required: License expiration timestamp, or empty for a perpetual or absent license
  - `features` string[], required: Feature claims included in the license
  - `gracePeriod` boolean, required: Whether the license is expired but still inside its grace period
  - `graceEndsAt` string, required: Grace-period end timestamp, or empty when the license has no expiration
  - `community` boolean, required: Whether no license claims are loaded
  - `source` string, required: Public license source category
  - `warningCode` string, required: Warning code included in the license token
  - `error` string, required: User-facing explanation when a configured license is unusable
  - `serverName` string: Name Dagu Console shows for this server: the one a person gave it, else reportedName
  - `reportedName` string: Name this server reports to Dagu Console: license.server_name, else the hostname
  - `licenseId` string: Identifier of the loaded license
  - `workspace` string: Dagu Console workspace that owns the license
  - `connectedVia` 'console' | 'key' | 'env' | 'config' | 'file': How the license reached this server
  - `serverId` string: Identifier of this server in Dagu Console, for licenses that check in
  - `lastCheckIn` string: Last time Dagu Console accepted this server's check-in
  - `consoleUrl` string: Dagu Console page for this server

## Other responses

- `400`: The license does not check in with Dagu Console
- `403`: Insufficient permissions
- `502`: Dagu Console could not be reached
- `default`: Unexpected error

## Changes

> 208 revisions in range; 1 not diffed.

- **2026-10-16** (v1) `afb5a872fdef`: 1 info
  - added the optional property `reportedName` to the response with the `200` status
- **2026-10-09** (v1) `e2fde4da38bd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dagucloud/apis/dagu/changes/license/refresh/post.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) - [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) - [OpenAPI document](https://skmtc.dev/dagucloud/apis/dagu/revisions/4f7617b01d17?raw)