Files

Files and uploads. Every example sets SOOQUNA_TOKEN from the environment; see authentication. Responses are from a test store, cut to two items per list.

Endpoint	Method	Path
Start a file upload	POST	/files/uploads
Finish a file upload	POST	/files/uploads/{id}/complete
Import a file from a URL	POST	/files/imports
List files	GET	/files
Get a file	GET	/files/{id}
Update a file’s alt text	PATCH	/files/{id}
Download a file	GET	/files/{id}/download
List where a file is used	GET	/files/{id}/usage
Delete a file	DELETE	/files/{id}

Start a file upload

POST /files/uploads · Scope: write_files

Returns a signed URL; PUT the file there, then complete the upload.

cURL

curl -X POST "https://api.sooquna.com/admin/api/2026-10/files/uploads" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "filename": "abaya-front.jpg",
  "content_type": "image/jpeg",
  "size": 482113,
  "purpose": "product_media"
}'

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/uploads", {
  method: "POST",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "filename": "abaya-front.jpg",
    "content_type": "image/jpeg",
    "size": 482113,
    "purpose": "product_media"
  }),
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.post(
    "https://api.sooquna.com/admin/api/2026-10/files/uploads",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
    json={
        "filename": "abaya-front.jpg",
        "content_type": "image/jpeg",
        "size": 482113,
        "purpose": "product_media",
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/uploads');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode([
        'filename' => 'abaya-front.jpg',
        'content_type' => 'image/jpeg',
        'size' => 482113,
        'purpose' => 'product_media',
    ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "strings"
)

func main() {
  body := `{
  "filename": "abaya-front.jpg",
  "content_type": "image/jpeg",
  "size": 482113,
  "purpose": "product_media"
}`
  req, err := http.NewRequest("POST", "https://api.sooquna.com/admin/api/2026-10/files/uploads", strings.NewReader(body))
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  req.Header.Set("Content-Type", "application/json")
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Post, "https://api.sooquna.com/admin/api/2026-10/files/uploads");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
req.Content = new StringContent("""
{
  "filename": "abaya-front.jpg",
  "content_type": "image/jpeg",
  "size": 482113,
  "purpose": "product_media"
}
""", Encoding.UTF8, "application/json");
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Finish a file upload

POST /files/uploads/{id}/complete · Scope: write_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X POST "https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN"

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete", {
  method: "POST",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.post(
    "https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("POST", "https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Post, "https://api.sooquna.com/admin/api/2026-10/files/uploads/0193a1b2-e283-7594-8a2c-0c28281e9c62/complete");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Import a file from a URL

POST /files/imports · Scope: write_files

cURL

curl -X POST "https://api.sooquna.com/admin/api/2026-10/files/imports" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://cdn.example.com/abaya-front.jpg",
  "purpose": "product_media"
}'

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/imports", {
  method: "POST",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://cdn.example.com/abaya-front.jpg",
    "purpose": "product_media"
  }),
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.post(
    "https://api.sooquna.com/admin/api/2026-10/files/imports",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
    json={
        "url": "https://cdn.example.com/abaya-front.jpg",
        "purpose": "product_media",
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/imports');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode([
        'url' => 'https://cdn.example.com/abaya-front.jpg',
        'purpose' => 'product_media',
    ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "strings"
)

func main() {
  body := `{
  "url": "https://cdn.example.com/abaya-front.jpg",
  "purpose": "product_media"
}`
  req, err := http.NewRequest("POST", "https://api.sooquna.com/admin/api/2026-10/files/imports", strings.NewReader(body))
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  req.Header.Set("Content-Type", "application/json")
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Post, "https://api.sooquna.com/admin/api/2026-10/files/imports");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
req.Content = new StringContent("""
{
  "url": "https://cdn.example.com/abaya-front.jpg",
  "purpose": "product_media"
}
""", Encoding.UTF8, "application/json");
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

List files

GET /files · Scope: read_files

Parameter	In	Description
kind	query	For example image.
limit	query	For example 20.

cURL

curl -X GET "https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN"

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20", {
  method: "GET",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.get(
    "https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("GET", "https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Get, "https://api.sooquna.com/admin/api/2026-10/files?kind=image&limit=20");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Response 200

{"data": [], "page_info": {"has_next_page": false}}

Get a file

GET /files/{id} · Scope: read_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X GET "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN"

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", {
  method: "GET",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.get(
    "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("GET", "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Get, "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Update a file’s alt text

PATCH /files/{id} · Scope: write_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X PATCH "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "alt": "Embroidered linen abaya",
  "alt_translations": {"ar": "عباية كتان مطرزة"},
  "version": 1
}'

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", {
  method: "PATCH",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "alt": "Embroidered linen abaya",
    "alt_translations": {"ar": "عباية كتان مطرزة"},
    "version": 1
  }),
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.patch(
    "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
    json={
        "alt": "Embroidered linen abaya",
        "alt_translations": {"ar": "عباية كتان مطرزة"},
        "version": 1,
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode([
        'alt' => 'Embroidered linen abaya',
        'alt_translations' => ['ar' => 'عباية كتان مطرزة'],
        'version' => 1,
    ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "strings"
)

func main() {
  body := `{
  "alt": "Embroidered linen abaya",
  "alt_translations": {"ar": "عباية كتان مطرزة"},
  "version": 1
}`
  req, err := http.NewRequest("PATCH", "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", strings.NewReader(body))
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  req.Header.Set("Content-Type", "application/json")
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Patch, "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
req.Content = new StringContent("""
{
  "alt": "Embroidered linen abaya",
  "alt_translations": {"ar": "عباية كتان مطرزة"},
  "version": 1
}
""", Encoding.UTF8, "application/json");
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Download a file

GET /files/{id}/download · Scope: read_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X GET "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN" \
  -o abaya-front.jpg

Node.js

import { writeFile } from "node:fs/promises";

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download", {
  method: "GET",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
await writeFile("abaya-front.jpg", Buffer.from(await res.arrayBuffer()));

Python

import os
import requests

res = requests.get(
    "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
with open("abaya-front.jpg", "wb") as f:
    f.write(res.content)

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
file_put_contents('abaya-front.jpg', $response);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("GET", "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  out, err := os.Create("abaya-front.jpg")
  if err != nil {
    panic(err)
  }
  defer out.Close()
  io.Copy(out, res.Body)
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Get, "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-98fc-7bd2-8bf0-91459d0341d6/download");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
await File.WriteAllBytesAsync("abaya-front.jpg", await res.Content.ReadAsByteArrayAsync());

List where a file is used

GET /files/{id}/usage · Scope: read_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X GET "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN"

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage", {
  method: "GET",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.get(
    "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("GET", "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Get, "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-346e-7c53-8e35-095de053aa58/usage");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());

Delete a file

DELETE /files/{id} · Scope: write_files

Parameter	In	Description
id	path	The resource’s ID.

cURL

curl -X DELETE "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475" \
  -H "X-Sooquna-Access-Token: $SOOQUNA_TOKEN"

Node.js

const res = await fetch("https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", {
  method: "DELETE",
  headers: {
    "X-Sooquna-Access-Token": process.env.SOOQUNA_TOKEN,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);

Python

import os
import requests

res = requests.delete(
    "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475",
    headers={
        "X-Sooquna-Access-Token": os.environ["SOOQUNA_TOKEN"],
    },
)
res.raise_for_status()
print(res.json())

PHP

<?php
$ch = curl_init('https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => [
        'X-Sooquna-Access-Token: ' . getenv('SOOQUNA_TOKEN'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 300) {
    throw new RuntimeException("$status: $response");
}
$data = json_decode($response, true);
print_r($data);

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, err := http.NewRequest("DELETE", "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("X-Sooquna-Access-Token", os.Getenv("SOOQUNA_TOKEN"))
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()
  if res.StatusCode >= 300 {
    data, _ := io.ReadAll(res.Body)
    panic(fmt.Sprintf("%d: %s", res.StatusCode, data))
  }
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

C#

using System.Text;

using var client = new HttpClient();
var req = new HttpRequestMessage(HttpMethod.Delete, "https://api.sooquna.com/admin/api/2026-10/files/0193a1b2-b156-780e-84f5-048f32443475");
req.Headers.Add("X-Sooquna-Access-Token", Environment.GetEnvironmentVariable("SOOQUNA_TOKEN"));
var res = await client.SendAsync(req);
if (!res.IsSuccessStatusCode) throw new Exception($"{(int)res.StatusCode}: {await res.Content.ReadAsStringAsync()}");
Console.WriteLine(await res.Content.ReadAsStringAsync());