Create Workspace - Prisme.ai

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

Pattern: ^[0-9A-Za-zÀ-ÖØ-öø-ÿ ,.'- ]{1,60}$

description

Hide child attributes

description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

photo

string

config

object

Hide child attributes

config.schema

object

Hide child attributes

config.schema.{key}

object

Hide child attributes

config.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

config.schema.{key}.format

string

config.schema.{key}.properties

object

Hide child attributes

config.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

config.schema.{key}.title

Hide child attributes

config.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

config.schema.{key}.description

Hide child attributes

config.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

config.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

config.schema.{key}.ui:widget

string

config.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

config.block

string

config.value

any

blocks

object

Hide child attributes

blocks.{key}

object

Block

Hide child attributes

blocks.{key}.description

Hide child attributes

blocks.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.name

Hide child attributes

blocks.{key}.name.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.photo

string

blocks.{key}.url

string

deprecated

A block can be a javascript bundled file. Host it on the internet and put its url here.

blocks.{key}.edit

object

deprecated

Hide child attributes

blocks.{key}.edit.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

blocks.{key}.edit.format

string

blocks.{key}.edit.properties

object

Hide child attributes

blocks.{key}.edit.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.edit.title

Hide child attributes

blocks.{key}.edit.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.edit.description

Hide child attributes

blocks.{key}.edit.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.edit.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.edit.ui:widget

string

blocks.{key}.edit.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

blocks.{key}.block

string

deprecated

A block can extends another one by giving its name here

blocks.{key}.config

any

deprecated

default config applied to the Block. Usefull for extended Blocks.

blocks.{key}.automation

blocks.{key}.blocks

object[]

Hide child attributes

blocks.{key}.blocks.slug

string

required

blocks.{key}.blocks.appInstance

string

blocks.{key}.blocks.onInit

blocks.{key}.blocks.updateOn

string

blocks.{key}.blocks.automation

blocks.{key}.css

string

Css applied to Block

blocks.{key}.schema

object

Hide child attributes

blocks.{key}.schema.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

blocks.{key}.schema.format

string

blocks.{key}.schema.properties

object

Hide child attributes

blocks.{key}.schema.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.schema.title

Hide child attributes

blocks.{key}.schema.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.schema.description

Hide child attributes

blocks.{key}.schema.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.schema.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.schema.ui:widget

string

blocks.{key}.schema.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

slug

string

labels

string[]

Pattern: ^[0-9A-Za-z._:-]{2,60}$

customDomains

string[]

registerWorkspace

boolean

If true, make this workspace metadata available to all workspaces with this variable : {{global.workspacesRegistry[WORKSPACE_SLUG]}}

repositories

object

Remote versioning repositories

Hide child attributes

repositories.{key}

object

Hide child attributes

repositories.{key}.name

string

required

repositories.{key}.config

object

required

Option 1
Option 2
Option 3

Hide child attributes

repositories.{key}.config.url

string

required

repositories.{key}.config.branch

string

required

repositories.{key}.config.dirpath

string

Sub-directory path within the repository where the workspace is stored

repositories.{key}.config.auth

object

Hide child attributes

repositories.{key}.config.auth.user

string

repositories.{key}.config.auth.password

string

repositories.{key}.config.auth.sshkey

string

repositories.{key}.type

enum<string>

Available options:

git,

archive,

filesystem

repositories.{key}.mode

enum<string>

Available options:

read-write,

read-only

repositories.{key}.groups

string[]

Only for platform repositories fetched from the Platform workspaces ; indicates which groups can be pulled/pushed

repositories.{key}.pull

object

Hide child attributes

repositories.{key}.pull.exclude

object[]

Hide child attributes

repositories.{key}.pull.exclude.path

string

required

platformRepositories

object

Platform remote versioning repositories

Hide child attributes

platformRepositories.{key}

object

Hide child attributes

platformRepositories.{key}.name

string

required

platformRepositories.{key}.config

object

required

Option 1
Option 2
Option 3

Hide child attributes

platformRepositories.{key}.config.url

string

required

platformRepositories.{key}.config.branch

string

required

platformRepositories.{key}.config.dirpath

string

Sub-directory path within the repository where the workspace is stored

platformRepositories.{key}.config.auth

object

Hide child attributes

platformRepositories.{key}.config.auth.user

string

platformRepositories.{key}.config.auth.password

string

platformRepositories.{key}.config.auth.sshkey

string

platformRepositories.{key}.type

enum<string>

Available options:

git,

archive,

filesystem

platformRepositories.{key}.mode

enum<string>

Available options:

read-write,

read-only

platformRepositories.{key}.groups

string[]

Only for platform repositories fetched from the Platform workspaces ; indicates which groups can be pulled/pushed

platformRepositories.{key}.pull

object

Hide child attributes

platformRepositories.{key}.pull.exclude

object[]

Hide child attributes

platformRepositories.{key}.pull.exclude.path

string

required

secrets

object

Hide child attributes

secrets.schema

object

Hide child attributes

secrets.schema.{key}

object

Hide child attributes

secrets.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

secrets.schema.{key}.format

string

secrets.schema.{key}.properties

object

Hide child attributes

secrets.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

secrets.schema.{key}.title

Hide child attributes

secrets.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

secrets.schema.{key}.description

Hide child attributes

secrets.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

secrets.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

secrets.schema.{key}.ui:widget

string

secrets.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

events

object

Hide child attributes

events.mapping

object

Custom mapping which will be directly sent to underlying database (Elasticsearch/Opensearch)

events.types

object

Custom configuration per event type

Hide child attributes

events.types.{key}

object

Hide child attributes

events.types.{key}.schema

object

Hide child attributes

events.types.{key}.schema.{key}

object

Hide child attributes

events.types.{key}.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

events.types.{key}.schema.{key}.format

string

events.types.{key}.schema.{key}.properties

object

Hide child attributes

events.types.{key}.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

events.types.{key}.schema.{key}.title

Hide child attributes

events.types.{key}.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

events.types.{key}.schema.{key}.description

Hide child attributes

events.types.{key}.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

events.types.{key}.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

events.types.{key}.schema.{key}.ui:widget

string

events.types.{key}.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

writeLock

object

Lock preventing writes during versioning operations or unresolved merge conflicts

Hide child attributes

writeLock.lockedAt

string

writeLock.lockedBy

string

User ID who initiated the lock

writeLock.reason

string

Reason for the lock (e.g., pull_in_progress, merge_conflict)

Response

Success Response

name

string

required

Pattern: ^[0-9A-Za-zÀ-ÖØ-öø-ÿ ,.'- ]{1,60}$

description

Hide child attributes

description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

photo

string

config

object

Hide child attributes

config.schema

object

Hide child attributes

config.schema.{key}

object

Hide child attributes

config.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

config.schema.{key}.format

string

config.schema.{key}.properties

object

Hide child attributes

config.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

config.schema.{key}.title

Hide child attributes

config.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

config.schema.{key}.description

Hide child attributes

config.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

config.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

config.schema.{key}.ui:widget

string

config.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

config.block

string

config.value

any

blocks

object

Hide child attributes

blocks.{key}

object

Block

Hide child attributes

blocks.{key}.description

Hide child attributes

blocks.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.name

Hide child attributes

blocks.{key}.name.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.photo

string

blocks.{key}.url

string

deprecated

A block can be a javascript bundled file. Host it on the internet and put its url here.

blocks.{key}.edit

object

deprecated

Hide child attributes

blocks.{key}.edit.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

blocks.{key}.edit.format

string

blocks.{key}.edit.properties

object

Hide child attributes

blocks.{key}.edit.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.edit.title

Hide child attributes

blocks.{key}.edit.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.edit.description

Hide child attributes

blocks.{key}.edit.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.edit.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.edit.ui:widget

string

blocks.{key}.edit.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

blocks.{key}.block

string

deprecated

A block can extends another one by giving its name here

blocks.{key}.config

any

deprecated

default config applied to the Block. Usefull for extended Blocks.

blocks.{key}.automation

blocks.{key}.blocks

object[]

Hide child attributes

blocks.{key}.blocks.slug

string

required

blocks.{key}.blocks.appInstance

string

blocks.{key}.blocks.onInit

blocks.{key}.blocks.updateOn

string

blocks.{key}.blocks.automation

blocks.{key}.css

string

Css applied to Block

blocks.{key}.schema

object

Hide child attributes

blocks.{key}.schema.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

blocks.{key}.schema.format

string

blocks.{key}.schema.properties

object

Hide child attributes

blocks.{key}.schema.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.schema.title

Hide child attributes

blocks.{key}.schema.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.schema.description

Hide child attributes

blocks.{key}.schema.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

blocks.{key}.schema.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

blocks.{key}.schema.ui:widget

string

blocks.{key}.schema.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

slug

string

labels

string[]

Pattern: ^[0-9A-Za-z._:-]{2,60}$

customDomains

string[]

registerWorkspace

boolean

If true, make this workspace metadata available to all workspaces with this variable : {{global.workspacesRegistry[WORKSPACE_SLUG]}}

repositories

object

Remote versioning repositories

Hide child attributes

repositories.{key}

object

Hide child attributes

repositories.{key}.name

string

required

repositories.{key}.config

object

required

Option 1
Option 2
Option 3

Hide child attributes

repositories.{key}.config.url

string

required

repositories.{key}.config.branch

string

required

repositories.{key}.config.dirpath

string

Sub-directory path within the repository where the workspace is stored

repositories.{key}.config.auth

object

Hide child attributes

repositories.{key}.config.auth.user

string

repositories.{key}.config.auth.password

string

repositories.{key}.config.auth.sshkey

string

repositories.{key}.type

enum<string>

Available options:

git,

archive,

filesystem

repositories.{key}.mode

enum<string>

Available options:

read-write,

read-only

repositories.{key}.groups

string[]

Only for platform repositories fetched from the Platform workspaces ; indicates which groups can be pulled/pushed

repositories.{key}.pull

object

Hide child attributes

repositories.{key}.pull.exclude

object[]

Hide child attributes

repositories.{key}.pull.exclude.path

string

required

platformRepositories

object

Platform remote versioning repositories

Hide child attributes

platformRepositories.{key}

object

Hide child attributes

platformRepositories.{key}.name

string

required

platformRepositories.{key}.config

object

required

Option 1
Option 2
Option 3

Hide child attributes

platformRepositories.{key}.config.url

string

required

platformRepositories.{key}.config.branch

string

required

platformRepositories.{key}.config.dirpath

string

Sub-directory path within the repository where the workspace is stored

platformRepositories.{key}.config.auth

object

Hide child attributes

platformRepositories.{key}.config.auth.user

string

platformRepositories.{key}.config.auth.password

string

platformRepositories.{key}.config.auth.sshkey

string

platformRepositories.{key}.type

enum<string>

Available options:

git,

archive,

filesystem

platformRepositories.{key}.mode

enum<string>

Available options:

read-write,

read-only

platformRepositories.{key}.groups

string[]

Only for platform repositories fetched from the Platform workspaces ; indicates which groups can be pulled/pushed

platformRepositories.{key}.pull

object

Hide child attributes

platformRepositories.{key}.pull.exclude

object[]

Hide child attributes

platformRepositories.{key}.pull.exclude.path

string

required

secrets

object

Hide child attributes

secrets.schema

object

Hide child attributes

secrets.schema.{key}

object

Hide child attributes

secrets.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

secrets.schema.{key}.format

string

secrets.schema.{key}.properties

object

Hide child attributes

secrets.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

secrets.schema.{key}.title

Hide child attributes

secrets.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

secrets.schema.{key}.description

Hide child attributes

secrets.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

secrets.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

secrets.schema.{key}.ui:widget

string

secrets.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

events

object

Hide child attributes

events.mapping

object

Custom mapping which will be directly sent to underlying database (Elasticsearch/Opensearch)

events.types

object

Custom configuration per event type

Hide child attributes

events.types.{key}

object

Hide child attributes

events.types.{key}.schema

object

Hide child attributes

events.types.{key}.schema.{key}

object

Hide child attributes

events.types.{key}.schema.{key}.type

enum<string>

Available options:

string,

number,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

events.types.{key}.schema.{key}.format

string

events.types.{key}.schema.{key}.properties

object

Hide child attributes

events.types.{key}.schema.{key}.properties.{key}

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

events.types.{key}.schema.{key}.title

Hide child attributes

events.types.{key}.schema.{key}.title.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

events.types.{key}.schema.{key}.description

Hide child attributes

events.types.{key}.schema.{key}.description.{key}

string

Example:

{ "fr": "Bonjour", "en": "Hello" }

events.types.{key}.schema.{key}.items

object

Recursive reference to TypedArgument — nesting is truncated here to avoid the infinite expansion that crashes the API reference renderer.

events.types.{key}.schema.{key}.ui:widget

string

events.types.{key}.schema.{key}.ui:options

object

Example:

{
  "type": "string",
  "title": { "en": "User ID" },
  "description": { "en": "The unique identifier of the user" },
  "secret": { "type": "boolean" },
  "event": { "type": "boolean" }
}

writeLock

object

Lock preventing writes during versioning operations or unresolved merge conflicts

Hide child attributes

writeLock.lockedAt

string

writeLock.lockedBy

string

User ID who initiated the lock

writeLock.reason

string

Reason for the lock (e.g., pull_in_progress, merge_conflict)