---
title: "Upsert Export Request"
method: PUT
path: "/exports/{export_id}"
tags: ["ExportRequest"]
---

# Upsert Export Request

`PUT /exports/{export_id}`

Upsert Export Request

## Path parameters

- `export_id` string, required

## Headers

- `If-Match` string

## Request body

- ExportRequest
  - `id` string
  - `created_time` integer — Export request time
  - `created_by_id` string — Export creation user id
  - `last_updated_time` integer — Export last updated
  - `last_updated_by_id` string — Export last updated user id
  - `workspace_id` string — Workspace identifier
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'terminated' — Ambient export status
  - `target_entity_id` string, required — Entity under export
  - `target_content` string[], required — Requested export contents
  - `output_format` 'pdf' | 'zip' — Export requested contents in requested output format
  - `output_uri` string — Export artifact URI. Available on export success.
  - `output_signed_url` string — Signed download URL (populated when output_uri provided)

## Response `200`

Export Request validation request

- ExportRequest
  - `id` string
  - `created_time` integer — Export request time
  - `created_by_id` string — Export creation user id
  - `last_updated_time` integer — Export last updated
  - `last_updated_by_id` string — Export last updated user id
  - `workspace_id` string — Workspace identifier
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'terminated' — Ambient export status
  - `target_entity_id` string, required — Entity under export
  - `target_content` string[], required — Requested export contents
  - `output_format` 'pdf' | 'zip' — Export requested contents in requested output format
  - `output_uri` string — Export artifact URI. Available on export success.
  - `output_signed_url` string — Signed download URL (populated when output_uri provided)

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Entity not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)
