Get Workspace

curl --request GET \
  --url https://api.studio.prisme.ai/v2/workspaces/{workspaceId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.studio.prisme.ai/v2/workspaces/{workspaceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "name": "<string>",
  "description": {
    "fr": "Bonjour",
    "en": "Hello"
  },
  "photo": "<string>",
  "config": {
    "schema": {},
    "block": "<string>",
    "value": "<unknown>"
  },
  "blocks": {},
  "slug": "<string>",
  "id": "<string>",
  "labels": [
    "<string>"
  ],
  "customDomains": [
    "<string>"
  ],
  "registerWorkspace": true,
  "repositories": {},
  "platformRepositories": {},
  "secrets": {
    "schema": {}
  },
  "events": {
    "mapping": {},
    "types": {}
  },
  "writeLock": {
    "lockedAt": "<string>",
    "lockedBy": "<string>",
    "reason": "<string>"
  },
  "generation": 123,
  "automations": {},
  "pages": {},
  "imports": {},
  "groups": [
    "<string>"
  ],
  "dependsOn": [
    "<string>"
  ],
  "app": {
    "slug": "<string>",
    "name": "<string>",
    "description": {
      "fr": "Bonjour",
      "en": "Hello"
    }
  },
  "version": {
    "name": "<string>",
    "type": "import",
    "exportedAt": "<string>",
    "importedAt": "<string>",
    "source": "<string>"
  },
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "createdBy": "<string>"
}

{
  "error": "AuthenticationError",
  "message": "Unauthenticated"
}

{
  "error": "ForbiddenError",
  "message": "Forbidden"
}

{
  "error": "ObjectNotFound",
  "message": "<string>"
}

GET

workspaces

{workspaceId}

Get Workspace

curl --request GET \
  --url https://api.studio.prisme.ai/v2/workspaces/{workspaceId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.studio.prisme.ai/v2/workspaces/{workspaceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "name": "<string>",
  "description": {
    "fr": "Bonjour",
    "en": "Hello"
  },
  "photo": "<string>",
  "config": {
    "schema": {},
    "block": "<string>",
    "value": "<unknown>"
  },
  "blocks": {},
  "slug": "<string>",
  "id": "<string>",
  "labels": [
    "<string>"
  ],
  "customDomains": [
    "<string>"
  ],
  "registerWorkspace": true,
  "repositories": {},
  "platformRepositories": {},
  "secrets": {
    "schema": {}
  },
  "events": {
    "mapping": {},
    "types": {}
  },
  "writeLock": {
    "lockedAt": "<string>",
    "lockedBy": "<string>",
    "reason": "<string>"
  },
  "generation": 123,
  "automations": {},
  "pages": {},
  "imports": {},
  "groups": [
    "<string>"
  ],
  "dependsOn": [
    "<string>"
  ],
  "app": {
    "slug": "<string>",
    "name": "<string>",
    "description": {
      "fr": "Bonjour",
      "en": "Hello"
    }
  },
  "version": {
    "name": "<string>",
    "type": "import",
    "exportedAt": "<string>",
    "importedAt": "<string>",
    "source": "<string>"
  },
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "createdBy": "<string>"
}

{
  "error": "AuthenticationError",
  "message": "Unauthenticated"
}

{
  "error": "ForbiddenError",
  "message": "Forbidden"
}

{
  "error": "ObjectNotFound",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

workspaceId

string

required

Workspace id

Query Parameters

version

string

Optional version

metadata

boolean

When true, enrich the response with the .import.yml metadata (groups / dependsOn / app / version). Off by default so regular reads (e.g. the frontend) skip the extra lookups.

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,

integer,

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

config.schema.{key}.secret

boolean

config.schema.{key}.redact

boolean

Path-redact this field from runtime execution events (runtime.automations.executed), whatever its size. Redact itself never tracks the value: each automation the value transits through must re-declare redact on its own schema. It does not disable a secret declaration on the same or a nested field — secret takes precedence, so a field marked both is value-tracked AND path-redacted. Only reachable through nested properties: a marker inside items, additionalProperties or oneOf-style keywords is ignored (redact the parent field itself).

config.schema.{key}.required

string[]

config.schema.{key}.event

boolean

Example:

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

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,

integer,

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

blocks.{key}.edit.secret

boolean

blocks.{key}.edit.redact

boolean

blocks.{key}.edit.required

string[]

blocks.{key}.edit.event

boolean

Example:

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

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,

integer,

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

blocks.{key}.schema.secret

boolean

blocks.{key}.schema.redact

boolean

blocks.{key}.schema.required

string[]

blocks.{key}.schema.event

boolean

Example:

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

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,

integer,

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

secrets.schema.{key}.secret

boolean

secrets.schema.{key}.redact

boolean

secrets.schema.{key}.required

string[]

secrets.schema.{key}.event

boolean

Example:

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

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,

integer,

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

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

boolean

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

boolean

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

string[]

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

boolean

Example:

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

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)

generation

integer

Monotonic counter incremented on every workspace modification. Used by the runtime to detect a stale runtime.yml (e.g. after a crash during import) and trigger a rebuild.

automations

object

Hide child attributes

automations.{key}

object

Hide child attributes

automations.{key}.name

required

Hide child attributes

automations.{key}.name.{key}

string

Example:

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

automations.{key}.description

Hide child attributes

automations.{key}.description.{key}

string

Example:

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

automations.{key}.private

boolean

Set this to true if you don't want your automation to be accessible outside of your app. Default is false.

Example:

false

automations.{key}.disabled

boolean

Set this to true if you want to turn off this automation.

Example:

true

automations.{key}.slug

string

Unique & human readable id across current workspace's automations

automations.{key}.arguments

object

Hide child attributes

automations.{key}.arguments.{key}

object

Hide child attributes

automations.{key}.arguments.{key}.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

automations.{key}.arguments.{key}.format

string

automations.{key}.arguments.{key}.properties

object

Hide child attributes

automations.{key}.arguments.{key}.properties.{key}

object

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

automations.{key}.arguments.{key}.title

Hide child attributes

automations.{key}.arguments.{key}.title.{key}

string

Example:

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

automations.{key}.arguments.{key}.description

Hide child attributes

automations.{key}.arguments.{key}.description.{key}

string

Example:

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

automations.{key}.arguments.{key}.items

object

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

automations.{key}.arguments.{key}.ui:widget

string

automations.{key}.arguments.{key}.ui:options

object

automations.{key}.arguments.{key}.secret

boolean

automations.{key}.arguments.{key}.redact

boolean

automations.{key}.arguments.{key}.required

string[]

automations.{key}.arguments.{key}.event

boolean

Example:

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

automations.{key}.schemas

object[]

Conditional input/output schemas. Takes precedence over arguments for validation when present; arguments-declared secret & redact markers remain enforced on every branch, while branch-declared secrets only apply to calls matching their branch.

Hide child attributes

automations.{key}.schemas.conditions

object

Every entry must equal the corresponding payload variable for the branch to match. Keys are dot-paths resolved from the payload root (method, body.kind…); method is matched case-insensitively. Values are compared as strings after scalar coercion (2 matches "2" — query parameters always arrive as strings); an object or array value never matches.

automations.{key}.schemas.payload

object

Hide child attributes

automations.{key}.schemas.payload.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

automations.{key}.schemas.payload.format

string

automations.{key}.schemas.payload.properties

object

Hide child attributes

automations.{key}.schemas.payload.properties.{key}

object

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

automations.{key}.schemas.payload.title

Hide child attributes

automations.{key}.schemas.payload.title.{key}

string

Example:

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

automations.{key}.schemas.payload.description

Hide child attributes

automations.{key}.schemas.payload.description.{key}

string

Example:

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

automations.{key}.schemas.payload.items

object

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

automations.{key}.schemas.payload.ui:widget

string

automations.{key}.schemas.payload.ui:options

object

automations.{key}.schemas.payload.secret

boolean

automations.{key}.schemas.payload.redact

boolean

automations.{key}.schemas.payload.required

string[]

automations.{key}.schemas.payload.event

boolean

Example:

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

automations.{key}.schemas.output

object

Hide child attributes

automations.{key}.schemas.output.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

automations.{key}.schemas.output.format

string

automations.{key}.schemas.output.properties

object

Hide child attributes

automations.{key}.schemas.output.properties.{key}

object

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

automations.{key}.schemas.output.title

Hide child attributes

automations.{key}.schemas.output.title.{key}

string

Example:

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

automations.{key}.schemas.output.description

Hide child attributes

automations.{key}.schemas.output.description.{key}

string

Example:

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

automations.{key}.schemas.output.items

object

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

automations.{key}.schemas.output.ui:widget

string

automations.{key}.schemas.output.ui:options

object

automations.{key}.schemas.output.secret

boolean

automations.{key}.schemas.output.redact

boolean

automations.{key}.schemas.output.required

string[]

automations.{key}.schemas.output.event

boolean

Example:

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

automations.{key}.validateArguments

boolean

automations.{key}.when

object

Option 1
Option 2
Option 3
Option 4

Hide child attributes

automations.{key}.when.events

string[]

required

Example:

["prismeaiMessenger.event"]

automations.{key}.when.schedules

string[]

Example:

["2021-12-25T00:00", "* * 1 * *"]

automations.{key}.when.endpoint

Example:

"Set to true in order to activate HTTP endpoint. Slug will be trigger name by default"

automations.{key}.labels

string[]

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

automations.{key}.events

object

Hide child attributes

automations.{key}.events.emit

string[]

automations.{key}.events.listen

string[]

automations.{key}.events.autocomplete

object[]

Hide child attributes

automations.{key}.events.autocomplete.event

string

required

Example:

"prismeaiMessenger.message"

automations.{key}.events.autocomplete.autocomplete

object

Hide child attributes

automations.{key}.events.autocomplete.autocomplete.{key}

object

Hide child attributes

automations.{key}.events.autocomplete.autocomplete.{key}.from

string

automations.{key}.events.autocomplete.autocomplete.{key}.path

string

automations.{key}.events.autocomplete.autocomplete.{key}.template

string

automations.{key}.updatedAt

string

automations.{key}.createdAt

string

automations.{key}.updatedBy

string

automations.{key}.createdBy

string

automations.{key}.checksum

string

pages

object

Hide child attributes

pages.{key}

object

Page

Hide child attributes

pages.{key}.name

required

Hide child attributes

pages.{key}.name.{key}

string

Example:

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

pages.{key}.description

Hide child attributes

pages.{key}.description.{key}

string

Example:

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

pages.{key}.workspaceId

string

pages.{key}.workspaceSlug

string

pages.{key}.id

string

pages.{key}.slug

string

pages.{key}.blocks

object[]

Hide child attributes

pages.{key}.blocks.slug

string

pages.{key}.blocks.appInstance

string

pages.{key}.labels

string[]

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

pages.{key}.events

object

Hide child attributes

pages.{key}.events.emit

string[]

pages.{key}.events.listen

string[]

pages.{key}.events.autocomplete

object[]

Hide child attributes

pages.{key}.events.autocomplete.event

string

required

Example:

"prismeaiMessenger.message"

pages.{key}.events.autocomplete.autocomplete

object

Hide child attributes

pages.{key}.events.autocomplete.autocomplete.{key}

object

Hide child attributes

pages.{key}.events.autocomplete.autocomplete.{key}.from

string

pages.{key}.events.autocomplete.autocomplete.{key}.path

string

pages.{key}.events.autocomplete.autocomplete.{key}.template

string

pages.{key}.createdBy

string

pages.{key}.updatedBy

string

pages.{key}.createdAt

string

pages.{key}.updatedAt

string

pages.{key}.permissions

object

Hide child attributes

pages.{key}.permissions.{key}

object

Hide child attributes

pages.{key}.permissions.{key}.role

string

pages.{key}.permissions.{key}.policies

object

Hide child attributes

pages.{key}.permissions.{key}.policies.read

boolean

pages.{key}.permissions.{key}.policies.write

boolean

pages.{key}.permissions.{key}.policies.update

boolean

pages.{key}.permissions.{key}.policies.create

boolean

pages.{key}.permissions.{key}.policies.manage_permissions

boolean

pages.{key}.customDomains

string[]

pages.{key}.colorScheme

enum<string>

Available options:

auto,

light,

dark

pages.{key}.checksum

string

pages.{key}.favicon

string

imports

object

Hide child attributes

imports.{key}

object

Hide child attributes

imports.{key}.appSlug

string

required

App unique id

imports.{key}.slug

string

required

Unique & human readable id across current workspace's appInstances, which will be used to call this app automations

imports.{key}.automations

object[]

required

Hide child attributes

imports.{key}.automations.slug

string

required

imports.{key}.automations.name

required

Hide child attributes

imports.{key}.automations.name.{key}

string

Example:

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

imports.{key}.automations.arguments

object

required

Hide child attributes

imports.{key}.automations.arguments.{key}

object

Hide child attributes

imports.{key}.automations.arguments.{key}.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

imports.{key}.automations.arguments.{key}.format

string

imports.{key}.automations.arguments.{key}.properties

object

Hide child attributes

imports.{key}.automations.arguments.{key}.properties.{key}

object

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

imports.{key}.automations.arguments.{key}.title

Hide child attributes

imports.{key}.automations.arguments.{key}.title.{key}

string

Example:

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

imports.{key}.automations.arguments.{key}.description

Hide child attributes

imports.{key}.automations.arguments.{key}.description.{key}

string

Example:

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

imports.{key}.automations.arguments.{key}.items

object

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

imports.{key}.automations.arguments.{key}.ui:widget

string

imports.{key}.automations.arguments.{key}.ui:options

object

imports.{key}.automations.arguments.{key}.secret

boolean

imports.{key}.automations.arguments.{key}.redact

boolean

imports.{key}.automations.arguments.{key}.required

string[]

imports.{key}.automations.arguments.{key}.event

boolean

Example:

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

imports.{key}.automations.description

Hide child attributes

imports.{key}.automations.description.{key}

string

Example:

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

imports.{key}.automations.schemas

object[]

Hide child attributes

imports.{key}.automations.schemas.conditions

object

imports.{key}.automations.schemas.payload

object

Hide child attributes

imports.{key}.automations.schemas.payload.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

imports.{key}.automations.schemas.payload.format

string

imports.{key}.automations.schemas.payload.properties

object

Hide child attributes

imports.{key}.automations.schemas.payload.properties.{key}

object

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

imports.{key}.automations.schemas.payload.title

Hide child attributes

imports.{key}.automations.schemas.payload.title.{key}

string

Example:

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

imports.{key}.automations.schemas.payload.description

Hide child attributes

imports.{key}.automations.schemas.payload.description.{key}

string

Example:

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

imports.{key}.automations.schemas.payload.items

object

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

imports.{key}.automations.schemas.payload.ui:widget

string

imports.{key}.automations.schemas.payload.ui:options

object

imports.{key}.automations.schemas.payload.secret

boolean

imports.{key}.automations.schemas.payload.redact

boolean

imports.{key}.automations.schemas.payload.required

string[]

imports.{key}.automations.schemas.payload.event

boolean

Example:

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

imports.{key}.automations.schemas.output

object

Hide child attributes

imports.{key}.automations.schemas.output.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

imports.{key}.automations.schemas.output.format

string

imports.{key}.automations.schemas.output.properties

object

Hide child attributes

imports.{key}.automations.schemas.output.properties.{key}

object

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

imports.{key}.automations.schemas.output.title

Hide child attributes

imports.{key}.automations.schemas.output.title.{key}

string

Example:

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

imports.{key}.automations.schemas.output.description

Hide child attributes

imports.{key}.automations.schemas.output.description.{key}

string

Example:

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

imports.{key}.automations.schemas.output.items

object

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

imports.{key}.automations.schemas.output.ui:widget

string

imports.{key}.automations.schemas.output.ui:options

object

imports.{key}.automations.schemas.output.secret

boolean

imports.{key}.automations.schemas.output.redact

boolean

imports.{key}.automations.schemas.output.required

string[]

imports.{key}.automations.schemas.output.event

boolean

Example:

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

imports.{key}.events

object

required

Hide child attributes

imports.{key}.events.emit

string[]

imports.{key}.events.listen

string[]

imports.{key}.events.autocomplete

object[]

Hide child attributes

imports.{key}.events.autocomplete.event

string

required

Example:

"prismeaiMessenger.message"

imports.{key}.events.autocomplete.autocomplete

object

Hide child attributes

imports.{key}.events.autocomplete.autocomplete.{key}

object

Hide child attributes

imports.{key}.events.autocomplete.autocomplete.{key}.from

string

imports.{key}.events.autocomplete.autocomplete.{key}.path

string

imports.{key}.events.autocomplete.autocomplete.{key}.template

string

imports.{key}.blocks

object[]

required

Hide child attributes

imports.{key}.blocks.slug

string

required

imports.{key}.blocks.url

string

imports.{key}.blocks.edit

object

Hide child attributes

imports.{key}.blocks.edit.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

imports.{key}.blocks.edit.format

string

imports.{key}.blocks.edit.properties

object

Hide child attributes

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

object

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

imports.{key}.blocks.edit.title

Hide child attributes

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

string

Example:

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

imports.{key}.blocks.edit.description

Hide child attributes

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

string

Example:

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

imports.{key}.blocks.edit.items

object

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

imports.{key}.blocks.edit.ui:widget

string

imports.{key}.blocks.edit.ui:options

object

imports.{key}.blocks.edit.secret

boolean

imports.{key}.blocks.edit.redact

boolean

imports.{key}.blocks.edit.required

string[]

imports.{key}.blocks.edit.event

boolean

Example:

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

imports.{key}.blocks.name

Hide child attributes

imports.{key}.blocks.name.{key}

string

Example:

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

imports.{key}.blocks.description

Hide child attributes

imports.{key}.blocks.description.{key}

string

Example:

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

imports.{key}.blocks.arguments

object

Hide child attributes

imports.{key}.blocks.arguments.{key}

object

Hide child attributes

imports.{key}.blocks.arguments.{key}.type

enum<string>

Available options:

string,

number,

integer,

object,

array,

boolean,

localized:string,

localized:number,

localized:boolean

imports.{key}.blocks.arguments.{key}.format

string

imports.{key}.blocks.arguments.{key}.properties

object

Hide child attributes

imports.{key}.blocks.arguments.{key}.properties.{key}

object

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

imports.{key}.blocks.arguments.{key}.title

Hide child attributes

imports.{key}.blocks.arguments.{key}.title.{key}

string

Example:

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

imports.{key}.blocks.arguments.{key}.description

Hide child attributes

imports.{key}.blocks.arguments.{key}.description.{key}

string

Example:

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

imports.{key}.blocks.arguments.{key}.items

object

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

imports.{key}.blocks.arguments.{key}.ui:widget

string

imports.{key}.blocks.arguments.{key}.ui:options

object

imports.{key}.blocks.arguments.{key}.secret

boolean

imports.{key}.blocks.arguments.{key}.redact

boolean

imports.{key}.blocks.arguments.{key}.required

string[]

imports.{key}.blocks.arguments.{key}.event

boolean

Example:

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

imports.{key}.appName

Hide child attributes

imports.{key}.appName.{key}

string

Example:

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

imports.{key}.appVersion

string

Defaults to the latest known app version

imports.{key}.disabled

boolean

If disabled, this appInstance will be ignored during execution

imports.{key}.labels

string[]

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

imports.{key}.updatedAt

string

imports.{key}.createdAt

string

imports.{key}.updatedBy

string

imports.{key}.createdBy

string

imports.{key}.checksum

string

imports.{key}.photo

string

imports.{key}.appMissing

boolean

True when the referenced app no longer exists in the platform (uninstalled/deleted). The instance is kept in the list so it stays visible and removable.

groups

string[]

Workspace groups deduced from labels (mirrors .import.yml). Used by the workspaces repo tooling to rebuild .import.yml from the live workspace. The .import.yml workspaceId maps to this response id field.

dependsOn

string[]

Source app slugs this workspace depends on, e.g. "app/Collection" (mirrors .import.yml).

app

object

App store publication of this workspace, if any (mirrors .import.yml app section).

Hide child attributes

app.slug

string

app.name

string

app.description

Hide child attributes

app.description.{key}

string

Example:

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

version

object

Last published/export version (mirrors .import.yml version section).

Hide child attributes

version.name

string

version.type

enum<string>

Available options:

import,

export

version.exportedAt

string

version.importedAt

string

version.source

string

createdAt

string

updatedAt

string

createdBy

string

Introduction

Platform API

Agent Creator API

LLM Gateway API

Governance API

Knowledges API

Collections API

Get Workspace

Authorizations

Path Parameters

Query Parameters

Response