datasets

POST /datasets/{dataset_id}/mapfields

Changed on Oct 16, 2026

Configures a field as a map field. Events you ingest afterward store the field's nested keys inside the map, while previously ingested events keep their structure. Not supported for metrics datasets.

Request

Base URL
https://api.axiom.co/v2
Auth
OAuth 2
Authorization codehttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://www.googleapis.com/oauth2/v4/token
Scopesdatasets|update
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/datasets/:dataset_id/mapfields/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

dataset_idstring required

Request body

namestring required

Example request

{
  "name": "fieldname"
}

Response

Created map field.

namestring required

Example response

{
  "name": "fieldname"
}

Changes

Oct 16, 2026v2fbc1b8430feb Revision changes
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history