Declare/adjust soil horizons

PUT /parcels/{id}/soil-profile

Scope soil:write
API key x-api-key
Base URL https://api.hub.akuasense.com/v1

One horizon, or several in layers[]. Each one replaces the horizon that started at the same depth (depthTopCm); the others stay in place. The old one is closed, never erased.

Path parameters

id integer required

Headers

Idempotency-Key string

Replays the same 2xx response (24 h)

Request body

Response

201

Horizons recorded

success boolean always present
rows array of object always present

One row per horizon written, in the order of the body: id of GET /parcels/{id}/soil-profile.
Show 2 attributes Hide attributes
- id integer always present
- timestamp_start string date-time always present

Errors

400
Entry refused

invalid_idinvalid_body
401
Not authenticated
403
Insufficient scope/role, or outside your company

PUT /parcels/{id}/soil-profile

curl -X PUT https://api.hub.akuasense.com/v1/parcels/1/soil-profile \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "layers": [
      {
        "soilHorizonId": 5,
        "depthTopCm": 0,
        "depthBottomCm": 30
      },
      {
        "soilHorizonId": 12,
        "depthTopCm": 30,
        "depthBottomCm": 60
      }
    ]
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/parcels/1/soil-profile',
  {
    method: 'PUT',
    headers: {
      'x-api-key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "layers": [
        {
          "soilHorizonId": 5,
          "depthTopCm": 0,
          "depthBottomCm": 30
        },
        {
          "soilHorizonId": 12,
          "depthTopCm": 30,
          "depthBottomCm": 60
        }
      ]
    }),
  },
);
const data = await response.json();

import requests

response = requests.put(
    "https://api.hub.akuasense.com/v1/parcels/1/soil-profile",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "layers": [
            {
                "soilHorizonId": 5,
                "depthTopCm": 0,
                "depthBottomCm": 30,
            },
            {
                "soilHorizonId": 12,
                "depthTopCm": 30,
                "depthBottomCm": 60,
            },
        ],
    },
)
data = response.json()

Response

{
  "success": true,
  "rows": [
    {
      "id": 12,
      "timestamp_start": "2026-09-11T08:30:00.000Z"
    },
    {
      "id": 13,
      "timestamp_start": "2026-09-11T08:30:00.000Z"
    }
  ]
}

application/json

{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string",
  "code": "invalid_id"
}

application/problem+json · example generated from the schema

{
  "type": "string",
  "title": "string",
  "status": 401,
  "detail": "string",
  "code": "string"
}

application/problem+json · example generated from the schema

{
  "type": "string",
  "title": "string",
  "status": 403,
  "detail": "string",
  "code": "string"
}

application/problem+json · example generated from the schema