Create Request

Create a new request.

Creates a new request.

post

Query parameters

languagestringOptional

Body

application/jsontext/jsonapplication/*+json

externalIdstring · max: 250 · nullableOptional

namestring · min: 1 · max: 1000Required

statusstring · min: 1Required

Responses

201

Created

application/json

idstringOptional

externalIdstring · nullableOptional

namestringOptional

statusstringOptional

errorstring · nullableOptional

400

Bad Request

application/json

post

/public/v1/commerce/requests

HTTPcURLJavaScriptPython

POST /public/v1/commerce/requests HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 229

{
  "externalId": "text",
  "name": "text",
  "status": "text",
  "from": {
    "id": "text"
  },
  "requester": {
    "id": "text"
  },
  "assignee": {
    "id": "text"
  },
  "to": {
    "id": "text"
  },
  "product": {
    "id": "text"
  },
  "parameters": [
    {
      "parameterDefinitionId": "text",
      "value": "text"
    }
  ]
}

application/jsontext/jsonapplication/*+json

{
  "id": "text",
  "audit": {
    "created": {
      "at": "2026-03-24T06:16:16.830Z",
      "by": {}
    },
    "updated": {
      "at": "2026-03-24T06:16:16.830Z",
      "by": {}
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "externalId": "text",
  "name": "text",
  "status": "text",
  "error": "text",
  "from": {
    "id": "text",
    "icon": "text",
    "type": "text",
    "status": "text",
    "name": "text"
  },
  "requester": {
    "id": "text",
    "icon": "text",
    "name": "text"
  },
  "assignee": {
    "id": "text",
    "icon": "text",
    "name": "text"
  },
  "to": {
    "id": "text",
    "icon": "text",
    "type": "text",
    "status": "text",
    "name": "text"
  },
  "product": {
    "id": "text",
    "name": "text",
    "externalIds": {
      "operations": "text",
      "defaultErpItem": "text"
    },
    "icon": "text",
    "status": "text"
  },
  "parameters": [
    {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-03-24T06:16:16.830Z",
          "by": {}
        },
        "updated": {
          "at": "2026-03-24T06:16:16.830Z",
          "by": {}
        }
      },
      "externalId": "text",
      "title": "text",
      "description": "text",
      "value": "text",
      "displayOrder": 1,
      "constraints": {
        "isReadonly": true,
        "isOptional": true
      },
      "typeOptions": null,
      "errorMessage": "text",
      "errorCode": "text",
      "request": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-03-24T06:16:16.830Z",
            "by": {}
          },
          "updated": {
            "at": "2026-03-24T06:16:16.830Z",
            "by": {}
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "externalId": "text",
        "name": "text",
        "status": "text",
        "error": "text",
        "from": {
          "id": "text",
          "icon": "text",
          "type": "text",
          "status": "text",
          "name": "text"
        },
        "requester": {
          "id": "text",
          "icon": "text",
          "name": "text"
        },
        "assignee": {
          "id": "text",
          "icon": "text",
          "name": "text"
        },
        "to": {
          "id": "text",
          "icon": "text",
          "type": "text",
          "status": "text",
          "name": "text"
        },
        "product": {
          "id": "text",
          "name": "text",
          "externalIds": {
            "operations": "text",
            "defaultErpItem": "text"
          },
          "icon": "text",
          "status": "text"
        },
        "parameters": [
          "[Circular Reference]"
        ],
        "messages": [
          "[Circular Reference]"
        ]
      }
    }
  ],
  "messages": [
    {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-03-24T06:16:16.830Z",
          "by": {}
        },
        "updated": {
          "at": "2026-03-24T06:16:16.830Z",
          "by": {}
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "visibility": {
        "client": true,
        "operations": true,
        "vendor": true
      },
      "account": {
        "id": "text",
        "icon": "text",
        "type": "text",
        "status": "text",
        "name": "text"
      },
      "type": "text",
      "content": "text",
      "request": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-03-24T06:16:16.830Z",
            "by": {}
          },
          "updated": {
            "at": "2026-03-24T06:16:16.830Z",
            "by": {}
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "externalId": "text",
        "name": "text",
        "status": "text",
        "error": "text",
        "from": {
          "id": "text",
          "icon": "text",
          "type": "text",
          "status": "text",
          "name": "text"
        },
        "requester": {
          "id": "text",
          "icon": "text",
          "name": "text"
        },
        "assignee": {
          "id": "text",
          "icon": "text",
          "name": "text"
        },
        "to": {
          "id": "text",
          "icon": "text",
          "type": "text",
          "status": "text",
          "name": "text"
        },
        "product": {
          "id": "text",
          "name": "text",
          "externalIds": {
            "operations": "text",
            "defaultErpItem": "text"
          },
          "icon": "text",
          "status": "text"
        },
        "parameters": [
          {
            "id": "text",
            "audit": {
              "created": {
                "at": "2026-03-24T06:16:16.830Z",
                "by": {}
              },
              "updated": {
                "at": "2026-03-24T06:16:16.830Z",
                "by": {}
              }
            },
            "externalId": "text",
            "title": "text",
            "description": "text",
            "value": "text",
            "displayOrder": 1,
            "constraints": {
              "isReadonly": true,
              "isOptional": true
            },
            "typeOptions": null,
            "errorMessage": "text",
            "errorCode": "text",
            "request": {
              "id": "text",
              "audit": {
                "created": {
                  "at": "2026-03-24T06:16:16.830Z",
                  "by": {}
                },
                "updated": {
                  "at": "2026-03-24T06:16:16.830Z",
                  "by": {}
                }
              },
              "$meta": {
                "omitted": [
                  "text"
                ]
              },
              "externalId": "text",
              "name": "text",
              "status": "text",
              "error": "text",
              "from": {
                "id": "text",
                "icon": "text",
                "type": "text",
                "status": "text",
                "name": "text"
              },
              "requester": {
                "id": "text",
                "icon": "text",
                "name": "text"
              },
              "assignee": {
                "id": "text",
                "icon": "text",
                "name": "text"
              },
              "to": {
                "id": "text",
                "icon": "text",
                "type": "text",
                "status": "text",
                "name": "text"
              },
              "product": {
                "id": "text",
                "name": "text",
                "externalIds": {
                  "operations": "text",
                  "defaultErpItem": "text"
                },
                "icon": "text",
                "status": "text"
              },
              "parameters": [
                "[Circular Reference]"
              ],
              "messages": [
                "[Circular Reference]"
              ]
            }
          }
        ],
        "messages": [
          "[Circular Reference]"
        ]
      }
    }
  ]
}