Skip to content

Set an app's sharing scope (My Apps <-> Workspace)

PATCH
/api/workspaces/{workspaceId}/apps/{id}/access
curl --request PATCH \
--url http://localhost:8080/api/workspaces/example/apps/example/access \
--header 'Content-Type: application/json' \
--cookie auth_session=<auth_session> \
--data '{ "access": "private" }'

The v1 rail’s drag-between-sections, for v2: private = the owner’s own list, workspace = everyone’s. Folder-only apps get their row here (restricting is one of the three row-creating acts, §13.6).

workspaceId
required
string
id
required
string
Media typeapplication/json
object
access
required
string
Allowed values: private workspace

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"
}