---
title: "Upload cover methods"
method: POST
path: "/cover-methods"
tags: ["Cover methods"]
---

# Upload cover methods

`POST /cover-methods`

## Query parameters

- `dry_run` boolean

## Response `200`

Upload accepted. When `dry_run=false` (default), returns an upload summary. When `dry_run=true`, the same summary is nested under `dry_run_data` and the data is not actually inserted into VegBank.

- union
  - UploadSummary — Counts of inserted records per entity type, plus the uploaded and VegBank-assigned identifiers for each record. Entity type keys (e.g. `pl`, `ob`, `rf`, `ds`) vary depending on what was uploaded. `ds` always appears and represents the internal dataset record created to log the upload.
    - `counts` object
    - `resources` object
  - object — Returned when `dry_run=true`. Transaction is rolled back.
    - `dry_run_data` UploadSummary — Counts of inserted records per entity type, plus the uploaded and VegBank-assigned identifiers for each record. Entity type keys (e.g. `pl`, `ob`, `rf`, `ds`) vary depending on what was uploaded. `ds` always appears and represents the internal dataset record created to log the upload.
      - `counts` object
      - `resources` object
    - `message` string

## Other responses

- `403` — Uploads not allowed
- `500` — Invalid data upload

---

[API](https://skmtc.net/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.net/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nceas/vegbankapi/versions/852fd165e202/schema)