SIsimscale
Projects

Update an existing project

Changed on

Set 'visibility' to change between public and private. When omitted, the visibility is kept.

put/projects/{projectId}

Request

  • Base URL
    https://api.simscale.com/v1
  • URL
    https://api.simscale.com/v1/projects/{projectId}
  • Auth
    API key in header X-API-KEY

Request body

projectIdstring
spaceIdstring uuid

Always returned by the backend. Optional at project creation. If missing, the project will be created in the Personal Space of the user.

parentFolderIdstring uuid

If missing, the project is located at the root level of the Space.

createdAtstring date-time
namestring required

The project title should contain the application you want to analyze as well as the simulation method you want to use, e.g. 'Heat exchanger - CHT simulation'.

descriptionstring

A meaningful description of the project.

measurementSystem'SI' | 'US_CUSTOMARY'

The measurement system of the project. Can't be modified. Only applies to SIMULATION projects, SI is used when it is omitted. PHYSICS_AI projects have no measurement system.

projectTypestring

The type of the project. Can only be set when the project is created, 'SIMULATION' is used when it is omitted. The possible values are 'SIMULATION' and 'PHYSICS_AI'.

visibility'PUBLIC' | 'PRIVATE'

Whether the project can be found, read and copied by anyone. Projects of Community accounts are always PUBLIC. Private projects require a Professional plan. When omitted at creation the plan default applies, when omitted on update the visibility is kept, and a copy is private on a Professional plan and has the visibility of the source project otherwise.

ownerUserIdstring

The userId of the user who owns the project.

tagsstring[]

Example request

{
  "projectId": "1234123412341234",
  "spaceId": "49eb49eb-49eb-49eb-49eb-49eb49eb49eb",
  "parentFolderId": "4e9c4e9c-4e9c-4e9c-4e9c-4e9c4e9c4e9c",
  "createdAt": "2020-01-01T01:00:00Z",
  "name": "My first project",
  "description": "My first project description",
  "measurementSystem": "SI",
  "visibility": "PUBLIC",
  "ownerUserId": "123456",
  "tags": [
    "FEA",
    "CFD"
  ]
}

Response

Successful update of the project

Changes

  • 50d7c3621f21Revision changes
    • info

      added the new optional request property

    • info

      added the non-success response with the status

  • 5531997ccdeeRevision changes
    • info

      added the new optional request property

    • info

      the request property became optional