Struct Docs
Struct.PIM 4
Struct.PIM 4
  • Struct PIM Documentation
  • API Reference
  • Latest updates from Struct HQ
  • Latest updates in Documentation
  • Fundamental concepts
    • Get familiar with Struct PIM
    • Catalogues & categories
    • Products & variants
    • Attributes
    • Product structures
    • Identifiers
    • Global lists
    • Localization & segmentation
    • Revisions & changelog
    • Publications
    • Supplier onboarding portal
  • Tutorials
    • Helpful guides
      • How to search efficiently
      • How to use Import
        • How to import products
        • How to import data into a list property on entities
        • How to import categories
        • How to import with media
        • How to use File templates
    • Example projects
      • Working with the API
  • Integration
    • Integrate with Struct PIM
    • Web API
    • Webhooks
  • Media format
  • API Reference
    • Introduction
    • Endpoints
      • AssetFolders
      • Assets
      • AssetTypes
      • AttributeGroups
      • Attributes
      • AttributeScopes
      • Browse
      • BusinessUnits
      • Catalogues
      • Categories
      • Dimensions
      • Exports
      • EnrichmentInsightSetups
      • GlobalLists
      • Languages
      • Maintenance
      • Miscellaneous
      • Messaging
      • Permissions
      • Products
      • ProductStructures
      • Publications
      • Transactions
      • UserGroup
      • UserRoles
      • Users
      • VariantGroups
      • UserTasks
      • Variants
      • Webhooks
      • Workflows
      • Models
Powered by GitBook
On this page
  1. API Reference
  2. Endpoints

BusinessUnits

PreviousBrowseNextCatalogues

Business units are used for advanced access policies where users have different permissions on different entities in the system depending on the business units they are part of and how these business units are related to the entities.

Get a specific business unit

get
Authorizations
Path parameters
uidstring · uuidRequired
Responses
200
OK
404
Not Found
get
GET /v1/businessunits/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Alias": "text",
  "Name": "text",
  "Created": "2025-05-09T11:30:39.326Z",
  "CreatedBy": "text",
  "LastModified": "2025-05-09T11:30:39.326Z",
  "LastModifiedBy": "text"
}

Delete a business unit

delete
Authorizations
Path parameters
uidstring · uuidRequired
Responses
200
OK
delete
DELETE /v1/businessunits/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

  • GETGet all business units
  • POSTCreate a business unit
  • PUTUpdate a business unit
  • GETGet a specific business unit
  • DELETEDelete a business unit

Get all business units

get
Authorizations
Responses
200
OK
get
GET /v1/businessunits HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "Alias": "text",
    "Name": "text",
    "Created": "2025-05-09T11:30:39.326Z",
    "CreatedBy": "text",
    "LastModified": "2025-05-09T11:30:39.326Z",
    "LastModifiedBy": "text"
  }
]

Create a business unit

post
Authorizations
Body

Model for creating a business unit

Uidstring · uuidOptional

Unique identifier of the business unit

Aliasstring | nullableOptional

Alias of the business unit

Namestring | nullableOptional

Name of the business unit

Responses
200
OK
post
POST /v1/businessunits HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 75

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Alias": "text",
  "Name": "text"
}
200

OK

No content

Update a business unit

put
Authorizations
Body

Model for updating a business unit

Uidstring · uuidOptional

Unique identifier of the business unit

Aliasstring | nullableOptional

Alias of the business unit

Namestring | nullableOptional

Name of the business unit

Responses
200
OK
put
PUT /v1/businessunits HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 75

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Alias": "text",
  "Name": "text"
}
200

OK

No content