Skip to main content
POST
Update a file or canvas's sharing

Authorizations

The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page.

Body

application/json
workspaceId
string<uuid>
required

The chat's workspace.

sourceType
enum<string>
required
Available options:
file,
canvas
sourceId
string<uuid>
required
internalAccess
enum<string>
required

chat = people who can open the chat; workspace = everyone in the workspace.

Available options:
chat,
workspace
externalAccess
enum<string>
required

anyone turns on the public link.

Available options:
invited,
anyone
members
string<uuid>[]

Extra workspace members who can open it. Replaces the current list.

Maximum array length: 200
password
string | null

Protects the public link. Omit to keep the current password, null to remove it. Needs externalAccess set to anyone.

Required string length: 10 - 256
expectedRevision
integer | null

The revision you read, or null if the item had never been shared.

Response

The saved settings.

canManage
boolean

True when you can change this sharing.

ownerId
string<uuid> | null

The chat's owner.

internalAccess
enum<string>
Available options:
chat,
workspace
members
string<uuid>[]
externalAccess
enum<string>
Available options:
invited,
anyone
hasPassword
boolean
privatePath
string

Path of the in-app link for teammates, such as /artifacts/<id>. Prefix it with https://connie.ai.

publicPath
string | null

Path of the public link. Shown only to people who can change the sharing.

revision
integer | null

Pass back as expectedRevision when you update.