Theme widgets
Import a shared widget into a theme
Creates an independent widget in one of the recipient company themes, including owned assets, auxiliary templates and translations. The share snapshot grants no access to other source-company resources. Requires authenticated administrator access and destination theme update permission. Revoked or malformed tokens return the same unavailable 404. Imports do not activate the destination theme, place the widget on a page, or replace an existing widget; imports receive an independent name. An optional operation_id UUID identifies one import intent: retrying the same share into the same theme returns its original widget. Use a new UUID to intentionally import another copy. Authorization and token revocation are checked before replay. Theme branches change through branch publication and cannot receive direct imports. Every response is private and must not be cached.
POST
/
api
/
v202604
/
theme-widget-shares
/
{token}
/
imports
Import a shared widget into a theme
curl --request POST \
--url https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"theme_id": 48213,
"operation_id": "019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051"
}
'import requests
url = "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports"
payload = {
"theme_id": 48213,
"operation_id": "019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({theme_id: 48213, operation_id: '019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051'})
};
fetch('https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'theme_id' => 48213,
'operation_id' => '019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports"
payload := strings.NewReader("{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}"
response = http.request(request)
puts response.read_body{
"template": {
"id": 8621,
"name": "care-card",
"application_theme_id": 247,
"themeable_type": "widgets"
},
"status": 201,
"meta": {}
}{
"message": "<string>",
"error": "<string>"
}{
"message": "<string>",
"error": "<string>"
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Opaque bearer token from the shared link.
Body
application/json
Response
The independently owned imported widget.
A template including its Liquid content. Fluid native widgets and theme copies use the widgets themeable type. Droplet extension sections retain their own type and identity. Native and droplet widgets expose metadata and settings only; content contains only the declarative settings schema.
Show child attributes
Show child attributes
⌘I
Import a shared widget into a theme
curl --request POST \
--url https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"theme_id": 48213,
"operation_id": "019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051"
}
'import requests
url = "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports"
payload = {
"theme_id": 48213,
"operation_id": "019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({theme_id: 48213, operation_id: '019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051'})
};
fetch('https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'theme_id' => 48213,
'operation_id' => '019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports"
payload := strings.NewReader("{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/theme-widget-shares/{token}/imports")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"theme_id\": 48213,\n \"operation_id\": \"019a2b3c-4d5e-7f60-8a9b-0c1d2e3f4051\"\n}"
response = http.request(request)
puts response.read_body{
"template": {
"id": 8621,
"name": "care-card",
"application_theme_id": 247,
"themeable_type": "widgets"
},
"status": 201,
"meta": {}
}{
"message": "<string>",
"error": "<string>"
}{
"message": "<string>",
"error": "<string>"
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {}
}{
"error": {
"message": "<string>",
"details": {}
},
"status": 123,
"meta": {}
}