Create chat

Create a new Chat

post

Creates a chat with an icon using multipart form data.

Query parameters

Body

multipart/form-dataapplication/json

idstringOptional

namestringOptional

iconstring · nullableOptional

revisioninteger · int32Optional

descriptionstring · nullableOptional

Gets or sets the description associated with the chat.

typestring · enumOptionalPossible values:

Responses

200

OK

application/json

idstringOptional

namestringOptional

iconstring · nullableOptional

revisioninteger · int32Optional

descriptionstring · nullableOptional

Gets or sets the description associated with the chat.

typestring · enumOptionalPossible values:

201

Created

application/json

400

Bad Request

application/json

403

Forbidden

application/json

500

Internal Server Error

post/public/v1/helpdesk/chats

HTTPcURLJavaScriptPython

POST /public/v1/helpdesk/chats HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 974

{
  "id": "text",
  "audit": {
    "created": {
      "at": "2026-07-22T10:22:41.990Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "updated": {
      "at": "2026-07-22T10:22:41.990Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "name": "text",
  "icon": "text",
  "revision": 1,
  "description": "text",
  "type": "Direct",
  "participants": [
    {
      "id": "text",
      "revision": 1,
      "muted": true,
      "status": "Active"
    }
  ],
  "lastMessage": {
    "id": "text",
    "revision": 1,
    "content": "text",
    "visibility": "Public",
    "isDeleted": true
  },
  "attachments": [
    {
      "id": "text",
      "name": "text",
      "icon": "text",
      "revision": 1,
      "file": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-07-22T10:22:41.990Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-07-22T10:22:41.990Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "name": "text",
        "icon": "text",
        "revision": 1,
        "type": "Icon",
        "filename": "report.pdf",
        "size": 102400,
        "contentType": "application/pdf"
      }
    }
  ]
}

multipart/form-dataapplication/json

{
  "id": "text",
  "audit": {
    "created": {
      "at": "2026-07-22T10:22:41.990Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "updated": {
      "at": "2026-07-22T10:22:41.990Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "name": "text",
  "icon": "text",
  "revision": 1,
  "description": "text",
  "type": "Direct",
  "participants": [
    {
      "id": "text",
      "revision": 1,
      "muted": true,
      "status": "Active"
    }
  ],
  "lastMessage": {
    "id": "text",
    "revision": 1,
    "content": "text",
    "visibility": "Public",
    "isDeleted": true
  },
  "attachments": [
    {
      "id": "text",
      "name": "text",
      "icon": "text",
      "revision": 1,
      "file": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-07-22T10:22:41.990Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-07-22T10:22:41.990Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "name": "text",
        "icon": "text",
        "revision": 1,
        "type": "Icon",
        "filename": "report.pdf",
        "size": 102400,
        "contentType": "application/pdf"
      }
    }
  ]
}