Skip to content

Move a personal app into the Workspace tree

POST
/api/workspaces/{workspaceId}/apps/{id}/share-with-workspace
curl --request POST \
--url http://localhost:8080/api/workspaces/example/apps/example/share-with-workspace \
--header 'Content-Type: application/json' \
--cookie auth_session=<auth_session> \
--data '{ "description": "example", "folder": "example" }'

The explicit step that turns a personal app (users/<me>/apps/…) into workspace content: one commit on main moving its folder under apps/ (or the given workspace folder) and writing the one-line description into mako.json. The app keeps its id, so its deployment, sharing and favourites follow it. Only the app’s owner, with an editing role, can do this.

workspaceId
required
string
id
required
string
Media typeapplication/json
object
description
required
string
>= 1 characters <= 300 characters
folder
string
>= 1 characters

Example generated

{
"description": "example",
"folder": "example"
}

Successful response

Media typeapplication/json
object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
error
string

Example

{
"message": "Operation completed",
"error": "Error message"
}

Invalid request

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}

Internal server error

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}