Public API · API Reference

Product tags

Endpoints for Product tags, including exact routes, parameters, request bodies, and expandable response schemas.

9 endpoints/api/tagStableMachine-readable description ↗

{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/tag

Ready-to-use workflows

Start using Product tags

Use a dedicated API token and validate read operations with test data first.

Keep the token server-side and send it in the Authorization header.
Check required parameters and expand the request or response schema.
Handle the HTTP status and the stable error field in application errors.

PUTUpdate Tag DELETEUpdate Tag 1 PUTBind Tag To Product

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

ProductTag3 fields

idinteger · int64

Id.

read-only

namestring

Name.

Required

clientIdinteger · int64

Client Id.

read-only

FindResponseProductTag1 fields

rowsProductTag[]

Rows.

FindResponseProductTagInfo1 fields

rowsProductTagInfo[]

Rows.

ProductTagInfo2 fields

productIdinteger · int64

Product Id.

productTagsProductTag[]

Product Tags.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

文

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

ENUser locale is en

{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

PUT

Update Tag

/api/tag/{tagId}

Token with write access

Update Tag using PUT /api/tag/{tagId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.

Request body

application/json

Object fieldsProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

curl --request PUT 'https://api.selsup.ru/api/tag/1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/tag/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "id": 1001,
    "clientId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/tag/1001', {
  method: 'PUT',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "id": 1001,
    "clientId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.put(
    'https://api.selsup.ru/api/tag/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'id': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/1001',
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/tag/1001", strings.NewReader(`{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("PUT", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

Object fields ProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}

Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_id_and_name_required

Tag id and name are required

Endpoint-specific error. Use the stable error_tag_id_and_name_required code in application logic; localMessage contains the translation shown above.

400error_tag_id_required

Tag id is required

Endpoint-specific error. Use the stable error_tag_id_required code in application logic; localMessage contains the translation shown above.

400error_tag_update_failed

Failed to update tag with id: {0}

Endpoint-specific error. Use the stable error_tag_update_failed code in application logic; localMessage contains the translation shown above.

DELETE

Update Tag 1

/api/tag/{tagId}

Token with write access

Update Tag 1 using DELETE /api/tag/{tagId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.

curl --request DELETE 'https://api.selsup.ru/api/tag/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/tag/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/tag/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/1001',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/tag/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

PUT

Bind Tag To Product

/api/tag/product/{tagId}/{productId}

Token with write access

Bind Tag To Product using PUT /api/tag/product/{tagId}/{productId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.
`productId`	integer · int64	Yes	Product Id.

curl --request PUT 'https://api.selsup.ru/api/tag/product/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
  method: 'PUT',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
  method: 'PUT',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.put(
    'https://api.selsup.ru/api/tag/product/1001/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/product/1001/1001',
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/tag/product/1001/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/product/1001/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("PUT", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

The response has no body.

Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_duplicate_tag_association

Tag is already associated with the product

Endpoint-specific error. Use the stable error_duplicate_tag_association code in application logic; localMessage contains the translation shown above.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_and_product_id_required

tag and product ID required

Endpoint-specific error. Use the stable error_tag_and_product_id_required code in application logic; localMessage contains the translation shown above.

DELETE

Un Bind Tag To Product

/api/tag/product/{tagId}/{productId}

Token with write access

Un Bind Tag To Product using DELETE /api/tag/product/{tagId}/{productId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.
`productId`	integer · int64	Yes	Product Id.

curl --request DELETE 'https://api.selsup.ru/api/tag/product/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/tag/product/1001/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/tag/product/1001/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/product/1001/1001',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/tag/product/1001/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/product/1001/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

The response has no body.

Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_and_model_id_required

Tag id and model id are required

Endpoint-specific error. Use the stable error_tag_and_model_id_required code in application logic; localMessage contains the translation shown above.

PUT

Bind Tag To Model

/api/tag/model/{tagId}/{modelId}

Token with write access

Bind Tag To Model using PUT /api/tag/model/{tagId}/{modelId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.
`modelId`	integer · int64	Yes	Model Id.

curl --request PUT 'https://api.selsup.ru/api/tag/model/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
  method: 'PUT',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
  method: 'PUT',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.put(
    'https://api.selsup.ru/api/tag/model/1001/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/model/1001/1001',
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/tag/model/1001/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/model/1001/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("PUT", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

The response has no body.

Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_duplicate_tag_association

Tag is already associated with the product

Endpoint-specific error. Use the stable error_duplicate_tag_association code in application logic; localMessage contains the translation shown above.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_and_model_id_required

Tag id and model id are required

Endpoint-specific error. Use the stable error_tag_and_model_id_required code in application logic; localMessage contains the translation shown above.

DELETE

Un Bind Tag To Model

/api/tag/model/{tagId}/{modelId}

Token with write access

Un Bind Tag To Model using DELETE /api/tag/model/{tagId}/{modelId}.

Path parameters

Field	Type	Required	Description
`tagId`	integer · int64	Yes	Tag Id.
`modelId`	integer · int64	Yes	Model Id.

curl --request DELETE 'https://api.selsup.ru/api/tag/model/1001/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const response: Response = await fetch('https://api.selsup.ru/api/tag/model/1001/1001', {
  method: 'DELETE',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

import os
import requests

response = requests.delete(
    'https://api.selsup.ru/api/tag/model/1001/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/model/1001/1001',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("DELETE", "https://api.selsup.ru/api/tag/model/1001/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/model/1001/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("DELETE", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

The response has no body.

Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_and_model_id_required

Tag id and model id are required

Endpoint-specific error. Use the stable error_tag_and_model_id_required code in application logic; localMessage contains the translation shown above.

POST

Create Tag

/api/tag

Token with write access

Create Tag using POST /api/tag.

Request body

application/json

Object fieldsProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

curl --request POST 'https://api.selsup.ru/api/tag' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}'

const response = await fetch('https://api.selsup.ru/api/tag', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "id": 1001,
    "clientId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/tag', {
  method: 'POST',
  headers: {
    Authorization: process.env.SELSUP_API_TOKEN!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example",
    "id": 1001,
    "clientId": 1001
  }),
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/tag',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
    json={
        'name': 'Example',
        'id': 1001,
        'clientId': 1001
    },
)
response.raise_for_status()
result = response.json()

<?php

$payload = <<<'JSON'
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
JSON;

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/tag", strings.NewReader(`{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
    req.Header.Set("Content-Type", "application/json")

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}
"""))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

Object fields ProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

{
  "name": "Example",
  "id": 1001,
  "clientId": 1001
}

Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_duplicate_tag_name

Tag with this name already exists: {0}

Endpoint-specific error. Use the stable error_duplicate_tag_name code in application logic; localMessage contains the translation shown above.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_tag_name_required

Tag name is required

Endpoint-specific error. Use the stable error_tag_name_required code in application logic; localMessage contains the translation shown above.

GET

Find Tags

/api/tag/find

Token with read access

Find Tags using GET /api/tag/find.

Query parameters

Field	Type	Required	Description
`query`	string	No	Query.
`productId`	integer · int64	No	Product Id.
`limit`	integer · int32	No	Limit.
`page`	integer · int32	No	Page.
`count`	boolean	No	Count.
`sortBy`	stringID, NAME	No	Sort By.
`ascending`	boolean	No	Ascending.

curl --request GET 'https://api.selsup.ru/api/tag/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/find?limit=50&page=1', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/tag/find?limit=50&page=1', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/tag/find?limit=50&page=1',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/find?limit=50&page=1',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/tag/find?limit=50&page=1", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/find?limit=50&page=1"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

Object fields FindResponseProductTag

Field Type Required Description

rows ProductTag[] No Rows.

Array item structure ProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

{
  "rows": "string"
}

Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Find Model Tags

/api/tag/find/{modelId}

Token with read access

Find Model Tags using GET /api/tag/find/{modelId}.

Path parameters

Field	Type	Required	Description
`modelId`	integer · int64	Yes	Model Id.

curl --request GET 'https://api.selsup.ru/api/tag/find/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/tag/find/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/tag/find/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/tag/find/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/tag/find/1001',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

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

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/tag/find/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/tag/find/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Success response

200

Object fields FindResponseProductTagInfo

Field Type Required Description

rows ProductTagInfo[] No Rows.

Array item structure ProductTagInfo

Field Type Required Description

productId integer · int64 No Product Id.

productTags ProductTag[] No Product Tags.

Array item structure ProductTag

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`name`	string	Yes	Name.
`clientId`	integer · int64	No	Client Id.

{
  "rows": "string"
}

Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client

The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

Product tags

Ready-to-use workflows

Start using Product tags

Data structures

How application errors are returned

Endpoints

Update Tag

Path parameters

Request body

Success response

Update Tag 1

Path parameters

Success response

Bind Tag To Product

Path parameters

Success response

Un Bind Tag To Product

Path parameters

Success response

Bind Tag To Model

Path parameters

Success response

Un Bind Tag To Model

Path parameters

Success response

Create Tag

Request body

Success response

Find Tags

Query parameters

Success response

Find Model Tags

Path parameters

Success response

Token for test requests

Real request parameters

Live API response