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

Permissions

PreviousMessagingNextProducts

Use security endpoint to manage permissions and security settings in the system programmatically. Permissions can be created and added to resource actions to define granular permission control of what users can do in the system

Get a specific permission

get
Authorizations
Path parameters
uidstring · uuidRequired
Responses
200
OK
404
Not Found
get
GET /v1/permissions/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionGroupUid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionName": "text",
  "Description": "text"
}

Delete a permission

delete
Authorizations
Path parameters
uidstring · uuidRequired

the Unique id of the permission

Responses
200
OK
delete
DELETE /v1/permissions/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

Get all permission groups added to the system

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

OK

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

Get a specific permission group

get
Authorizations
Path parameters
uidstring · uuidRequired
Responses
200
OK
404
Not Found
get
GET /v1/permissiongroups/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text"
}

Delete a permission group

delete
Authorizations
Path parameters
uidstring · uuidRequired

The unique id of the permission group

Responses
200
OK
delete
DELETE /v1/permissiongroups/{uid} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

No content

  • GETGet all permissions added to the system
  • POSTAdd permission to system
  • PUTUpdate a permission
  • GETGet a specific permission
  • DELETEDelete a permission
  • GETGet all permission groups added to the system
  • POSTAdd permission group to system
  • PUTUpdate a permission group
  • GETGet a specific permission group
  • DELETEDelete a permission group

Get all permissions added to the system

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

OK

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "PermissionGroupUid": "123e4567-e89b-12d3-a456-426614174000",
    "PermissionName": "text",
    "Description": "text"
  }
]

Add permission to system

post
Authorizations
Body

Representing a permission in the system

Uidstring · uuidOptional

Unique id of permission

PermissionGroupUidstring · uuidOptional

Uid of group to place permission in

PermissionNamestring | nullableOptional

Name of permission

Descriptionstring | nullableOptional

Description of permission

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

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionGroupUid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionName": "text",
  "Description": "text"
}
200

OK

No content

Update a permission

put
Authorizations
Body

Representing a permission in the system

Uidstring · uuidOptional

Unique id of permission

PermissionGroupUidstring · uuidOptional

Uid of group to place permission in

PermissionNamestring | nullableOptional

Name of permission

Descriptionstring | nullableOptional

Description of permission

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

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionGroupUid": "123e4567-e89b-12d3-a456-426614174000",
  "PermissionName": "text",
  "Description": "text"
}
200

OK

No content

Add permission group to system

post
Authorizations
Body

Represents a group of permissions

Uidstring · uuidOptional

Unique id of permission group

Namestring | nullableOptional

Name of permission group

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

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

OK

No content

Update a permission group

put
Authorizations
Body

Represents a group of permissions

Uidstring · uuidOptional

Unique id of permission group

Namestring | nullableOptional

Name of permission group

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

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

OK

No content