---
title: "Agent System Metric Upload"
method: POST
path: "/v1/data-acquisition/agent/systemmetric"
tags: ["Data Acquisition"]
---

# Agent System Metric Upload

`POST /v1/data-acquisition/agent/systemmetric`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/data-acquisition/agent/systemmetric`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

TetraScience Agent can periodically upload system metrics of itself and the host environment the Agent is running. It requires a user-defined agent set up in the TetraScience Web UI. Uploaded system metric file should be new line delimited JSON file. See below for more details.

## Request body `multipart/form-data`

- object
  - `agentId` string, required: This is the sourceId for a user-defined integration. Need to copy from the TetraScience Web UI where the user-defined integration is created. For existing TetraScience Agent who can connect to TetraScience Cloud directly, provide the agentId to this field.
  - `agentVersion` string, required: The Agent version, such as "v1.0.0".
  - `systemmetric` string, binary, required: The system metric file to upload.

## Response `200`

200

- object
  - `message` string

## Other responses

- `404`: 404

---

[API](https://skmtc.dev/tetrascience/apis/agents.md) - [All operations](https://skmtc.dev/tetrascience/apis/agents/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/agents/revisions/ae8c491f4b2e?raw)