---
search:
  tags:
    - Metrics
    - POST
seo:
  description: >-
    Record many metric values against one session in a single call. Reference
    for the POST /v1/metrics endpoint in the Roboto REST API.
sidebar:
  label: Publish metrics
  badge: POST
title: Publish metrics
type: openapi-operation
---
Record many metric values against one session in a single call.

Answers 201 once the request has been processed, even when the platform refused every value: the
response carries one element per submitted metric, in request order, holding either the metric it
recorded or the error that refused it. A caller on an API version before 2026-10-05 gets the older
shape instead, a ``succeeded`` list of stored records beside a ``failed`` list of named errors.

Three cases are settled before anything is recorded: a session that does not exist in this org answers
404, a malformed request answers 400, and so does one that omits ``device_id`` for a session without
exactly one device attached, since there is then no single attached device to record the values against.

A publication that runs out of time answers 504, under ``RobotoServiceTimeoutException`` when the
invocation's own deadline expired and ``RobotoOperationTimeoutException`` when a statement's budget did.
Either one rolls the publication back, the definitions it created along with the values.

### Access control
 - requires_resource_owner
 - Restricted tokens need the API scope `api.everything_else`

`POST /v1/metrics`