Create a workspace
==================

+--------+--------------------+
| Method | Path               |
+========+====================+
| POST   | /api/v1/workspaces |
+--------+--------------------+

Parameters
----------

* ``name`` string | required

The name of your workspace. It must be at least 2 characters long.

* ``description`` string | optional

A description for your workspace. Maximum 255 characters long.

Example
"""""""

.. code-block:: bash

    curl --request POST 'https://app.yumisign.com/api/v1/workspaces' \
        --header 'Content-Type: application/json' \
        --data-raw '{"name": "My workspace"}'

.. code-block:: json

    {
        "tags": [],
        "integrations": [],
        "workspaceUsers": [
            {
                "profile": {
                    "email": "email@mail.com",
                    "picture": {
                        "file": null,
                        "thumb": null,
                        "format": " ",
                        "size": 0
                    },
                    "name": "lastname firstname",
                    "country": "FR",
                    "id": 2
                },
                "role": 1,
                "memberId": 2,
                "email": "email@mail.com",
                "id": 17
            }
        ],
        "description": null,
        "id": 2,
        "name": "My workspace"
    }