> ## Documentation Index
> Fetch the complete documentation index at: https://developer.fabric.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration Template Guide

> A guide for exporting configurations from Sandbox to Production

This guide explains how to export configuration templates from an existing tenant (for example, sandbox) and apply them to a new tenant (for example, production) using the Order Management System (OMS) APIs.

Configuration templates enable standardized onboarding, making it easy to replicate predefined setup entities across environments.

* Enable reusable configuration templates for tenant onboarding.
* Export configuration entities from an existing tenant.
* Import configuration templates into a new tenant through a secure URL.
* Support API-driven onboarding using signed S3-backed template files.
* Enforce 4-hour access control for template URLs.
* Track template metadata & status.

<Note> The scope is limited to onboarding only. Features such as versioning, rollback, or diff support are not included. </Note>

## Supported Configuration Entities

A template can include one or more of the following entities:

* `configs`
* `rules`
* `zones`
* `networks`
* `geos`
* `attributes`
* `counters`
* `targetConfigs`
* `ppsConfigs`
* `holdConfigs`

## Step 1: Create and Export the Configuration Template

Use the `actions/export` endpoint to generate a new configuration template.

```bash theme={null}
curl --location '{{api_base_path}}/v3/configuration-templates/actions/export' \
--header 'X-Fabric-Tenant-Id: {{tenant_id}}' \
--header 'X-Fabric-Channel-Id: {{channel_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
  "entityTypes": ["networks"]
}'
```

**Sample Response:**

```json theme={null}
{
  "templateId": "template_2025-08-07T16-05-14-320205620Z",
  "entityTypes": ["networks"],
  "status": "INITIATED",
  "downloadUrl": null,
  "createdAt": "2025-08-07T16:05:14Z",
  "updatedAt": "2025-08-07T16:05:14Z"
}
```

## Step 2: Check the Export Status

Check the status until it reaches `FINISHED`.

```bash theme={null}
curl --location '{{api_base_path}}/v3/configuration-templates/{{template_id}}/actions/export-status' \
--header 'X-Fabric-Tenant-Id: {{tenant_id}}' \
--header 'X-Fabric-Channel-Id: {{channel_id}}' \
--header 'Authorization: Bearer {{access_token}}'
```

**Sample Response:**

```json theme={null}
{
  "templateId": "template_2025-08-07T16-05-14-320205620Z",
  "entityTypes": ["configs", "rules"],
  "status": "FINISHED",
  "downloadUrl": "https://<signed_s3_url>?X-Amz-SignedHeaders=...",
  "createdAt": "2025-08-07T16:05:14Z",
  "updatedAt": "2025-08-07T16:05:32Z"
}
```

<Tip> Copy the `downloadUrl` to use in the next step. </Tip>

## Step 3: Send the Template to your Production Tenant

Use the `downloadUrl` as the `<S3_URL>` value to configure your production account.

```bash theme={null}
curl --location '{{api_base_path}}/v3/organizations/{{orgId}}/tenants' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "testtenant1",
    "requesterFirstName": "<first_name>",
    "requesterLastName": "<last_name>",
    "configurations": {
        "OMS": {
            "omsTemplateFileUrl": "<S3_URL>"
        }
    }
}'
```

**Sample Response:**

A successful response returns a `200 OK` status.

Once complete, you must wait for the import to finish which can take up to 10 minutes. You can confirm if the import was successful by checking the UI or using an API GET endpoint for one of your configurations.

For example, if you imported geography configurations, you can use the [/v3/location-geographies/search](/v3/orders-and-inventory/api-reference/inventory/locations/geography/search) endpoint to make a POST request and review your data.

### Notes on Expiry & Reusability

* The `downloadUrl` expires **4 hours** after creation.
* To refresh, call the **export-status** endpoint again.
* Templates are **stateless** and may be reused until expiry.