Déclarer/ajuster les horizons de sol

PUT /parcels/{id}/soil-profile

Scope soil:write
Clé API x-api-key
URL de base https://api.hub.akuasense.com/v1

Un horizon, ou plusieurs dans layers[]. Chacun remplace celui qui commençait à la même profondeur (depthTopCm) ; les autres restent en place. L’ancien est clos, jamais effacé.

Paramètres de chemin

id integer obligatoire

En-têtes

Idempotency-Key string

Rejoue la même réponse 2xx (24 h)

Corps de la requête

Réponse

201

Horizons enregistrés

success boolean toujours présent
rows tableau d’object toujours présent

Une ligne par horizon écrit, dans l’ordre du corps : id de GET /parcels/{id}/soil-profile.
Afficher les 2 attributs Masquer les attributs
- id integer toujours présent
- timestamp_start string date-time toujours présent

Erreurs

400
Saisie refusée

invalid_idinvalid_body
401
Non authentifié
403
Scope/rôle insuffisant ou hors société

PUT /parcels/{id}/soil-profile

curl -X PUT https://api.hub.akuasense.com/v1/parcels/1/soil-profile \
  -H "x-api-key: VOTRE_CLE_API" \
  -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': 'VOTRE_CLE_API',
      '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": "VOTRE_CLE_API"},
    json={
        "layers": [
            {
                "soilHorizonId": 5,
                "depthTopCm": 0,
                "depthBottomCm": 30,
            },
            {
                "soilHorizonId": 12,
                "depthTopCm": 30,
                "depthBottomCm": 60,
            },
        ],
    },
)
data = response.json()

Réponse

{
  "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 · exemple généré depuis le schéma

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

application/problem+json · exemple généré depuis le schéma

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

application/problem+json · exemple généré depuis le schéma