---
title: "HEAD Get metadata for a device agent installer"
description: "Retrieves metadata (like Content-Length and Content-Type) for a device agent installer without downloading the file, using a one-time token."
last_updated: "2026-05-06T07:33:58.657893+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/device-agent/headagentdownload"
---

<APIEndpoint
  method={"HEAD"}
  path={"/api/download-agent"}
  summary={"Get metadata for a device agent installer"}
  description={"Retrieves metadata (like Content-Length and Content-Type) for a device agent installer without downloading the file, using a one-time token."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"token","in":"query","required":true,"description":"One-time download token generated by /api/download-agent/token.","schema":{"type":"string"}}]} />

## Responses

<APIResponse
  statusCode={"200"}
  description={"Successfully retrieved metadata for the agent installer."}
  contentType={"application/octet-stream"}
/>

<APIResponse
  statusCode={"400"}
  description={"Missing download token."}
  contentType={"text/plain"}
  schema={{"type":"string"}}
/>

<APIResponse
  statusCode={"403"}
  description={"Invalid or expired download token."}
  contentType={"text/plain"}
  schema={{"type":"string"}}
/>

<APIResponse
  statusCode={"404"}
  description={"Installer file not found on the server."}
  contentType={"text/plain"}
  schema={{"type":"string"}}
/>

<APIResponse
  statusCode={"500"}
  description={"Server configuration error or failed to get agent metadata."}
  contentType={"text/plain"}
  schema={{"type":"string"}}
/>

## Try It

<APIPlayground
  method={"HEAD"}
  path={"/api/download-agent"}
  parameters={[{"name":"token","in":"query","required":true,"description":"One-time download token generated by /api/download-agent/token.","schema":{"type":"string"}}]}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.