Create

POST /V1/company/role/

Create or update a role for a selected company.

Body

role object Required

Role data transfer object interface.
Hide role attributes Show role attributes object
- id integer
  
  Role id.
- role_name string
  
  Role name.
- permissions array[object] Required
  
  Permissions.
  Hide permissions attributes Show permissions attributes object
  
  Permission interface.
  
  id integer
  
  Id.
  
  role_id integer
  
  Role id.
  
  resource_id string Required
  
  Resource id.
  
  permission string Required
  
  Permission.
- company_id integer
  
  Company id.
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Company\Api\Data\RoleInterface

Body

role object Required

Role data transfer object interface.
Hide role attributes Show role attributes object
- id integer
  
  Role id.
- role_name string
  
  Role name.
- permissions array[object] Required
  
  Permissions.
  Hide permissions attributes Show permissions attributes object
  
  Permission interface.
  
  id integer
  
  Id.
  
  role_id integer
  
  Role id.
  
  resource_id string Required
  
  Resource id.
  
  permission string Required
  
  Permission.
- company_id integer
  
  Company id.
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Company\Api\Data\RoleInterface

Responses

200

application/json

application/json application/xml

200 Success.
Hide response attributes Show response attributes object
- id integer
  
  Role id.
- role_name string
  
  Role name.
- permissions array[object] Required
  
  Permissions.
  
  Hide permissions attributes Show permissions attributes object
  
  Permission interface.
  
  id integer
  
  Id.
  
  role_id integer
  
  Role id.
  
  resource_id string Required
  
  Resource id.
  
  permission string Required
  
  Permission.
- company_id integer
  
  Company id.
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Company\Api\Data\RoleInterface
Hide response attributes Show response attributes object
- id integer
  
  Role id.
- role_name string
  
  Role name.
- permissions array[object] Required
  
  Permissions.
  
  Hide permissions attributes Show permissions attributes object
  
  Permission interface.
  
  id integer
  
  Id.
  
  role_id integer
  
  Role id.
  
  resource_id string Required
  
  Resource id.
  
  permission string Required
  
  Permission.
- company_id integer
  
  Company id.
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Company\Api\Data\RoleInterface
401

application/json

application/json application/xml

401 Unauthorized
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
400

application/json

application/json application/xml

400 Bad Request
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
default

application/json

application/json application/xml

Unexpected error
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace

POST /V1/company/role/

curl \
 --request POST 'https://magento2.winkelstraat.mac/rest/all/V1/company/role/' \
 --header "Content-Type: application/json" \
 --data '{"role":{"id":42,"role_name":"string","permissions":[{"id":42,"role_id":42,"resource_id":"string","permission":"string"}],"company_id":42,"extension_attributes":{}}}'

curl \
 --request POST 'https://magento2.winkelstraat.mac/rest/all/V1/company/role/' \
 --header "Content-Type: application/xml"

Request examples

{
  "role": {
    "id": 42,
    "role_name": "string",
    "permissions": [
      {
        "id": 42,
        "role_id": 42,
        "resource_id": "string",
        "permission": "string"
      }
    ],
    "company_id": 42,
    "extension_attributes": {}
  }
}

Request examples

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <role>
    <id type="integer">42</id>
    <role-name>string</role-name>
    <permissions type="array">
      <permission>
        <id type="integer">42</id>
        <role-id type="integer">42</role-id>
        <resource-id>string</resource-id>
        <permission>string</permission>
      </permission>
    </permissions>
    <company-id type="integer">42</company-id>
    <extension-attributes>
    </extension-attributes>
  </role>
</root>

Response examples (200)

{
  "id": 42,
  "role_name": "string",
  "permissions": [
    {
      "id": 42,
      "role_id": 42,
      "resource_id": "string",
      "permission": "string"
    }
  ],
  "company_id": 42,
  "extension_attributes": {}
}

Response examples (200)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <id type="integer">42</id>
  <role-name>string</role-name>
  <permissions type="array">
    <permission>
      <id type="integer">42</id>
      <role-id type="integer">42</role-id>
      <resource-id>string</resource-id>
      <permission>string</permission>
    </permission>
  </permissions>
  <company-id type="integer">42</company-id>
  <extension-attributes>
  </extension-attributes>
</root>

Response examples (401)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (401)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>

Response examples (400)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (400)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>

Response examples (default)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (default)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>