Skip to content
View as Markdown

Workspace Commands

Commands for managing workspaces and profiles.

workspace

Manage Tailor Platform workspaces.

Usage

tailor workspace [command]

See Global Options for options available to all commands.

Commands

CommandDescription
workspace appManage workspace applications
workspace createCreate a new Tailor Platform workspace.
workspace deleteDelete a Tailor Platform workspace.
workspace getShow detailed information about a workspace
workspace listList all Tailor Platform workspaces.
workspace restoreRestore a deleted workspace
workspace userManage workspace users

workspace app

Manage workspace applications

Usage

tailor workspace app [command]

See Global Options for options available to all commands.

Commands

CommandDescription
workspace app healthCheck application schema health
workspace app listList applications in a workspace

workspace app health

Check application schema health

Usage

tailor workspace app health [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--name <NAME>-nApplication nameYes--

See Global Options for options available to all commands.

workspace app list

List applications in a workspace

Usage

tailor workspace app list [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--order <ORDER>-Sort order (asc or desc)No"desc"-
--limit <LIMIT>-lMaximum number of items to return (0 or omit: unlimited)No--

See Global Options for options available to all commands.

workspace create

Create a new Tailor Platform workspace.

Usage

tailor workspace create [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--name <NAME>-nWorkspace nameYes--
--region <REGION>-rWorkspace region (us-west, asia-northeast)Yes--
--delete-protection-dEnable delete protectionNofalse-
--organization-id <ORGANIZATION_ID>-oOrganization ID to workspace associate withNo-TAILOR_PLATFORM_ORGANIZATION_ID
--folder-id <FOLDER_ID>-fFolder ID to workspace associate withNo-TAILOR_PLATFORM_FOLDER_ID
--profile-name <PROFILE_NAME>-pProfile name to createNo--
--profile <PROFILE>-Workspace profile used for authentication and Platform selectionNo-TAILOR_PLATFORM_PROFILE
--profile-user <PROFILE_USER>-User email address or machine user client ID for the profile (defaults to current user)No--
--permission <PERMISSION>-Profile permission (requires --profile-name). 'read' blocks all write commands while the profile is active.No"write"-

See Global Options for options available to all commands.

workspace delete

Delete a Tailor Platform workspace.

Usage

tailor workspace delete [options]

Options

OptionAliasDescriptionRequiredDefault
--workspace-id <WORKSPACE_ID>-wWorkspace IDYes-
--yes-ySkip confirmation promptsNofalse

See Global Options for options available to all commands.

workspace get

Show detailed information about a workspace

Usage

tailor workspace get [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE

See Global Options for options available to all commands.

workspace list

List all Tailor Platform workspaces.

Usage

tailor workspace list [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--order <ORDER>-Sort order (asc or desc)No"desc"-
--limit <LIMIT>-lMaximum number of items to return (0 or omit: unlimited)No--
--profile <PROFILE>-Workspace profile used for authentication and Platform selectionNo-TAILOR_PLATFORM_PROFILE

See Global Options for options available to all commands.

workspace restore

Restore a deleted workspace

Usage

tailor workspace restore [options]

Options

OptionAliasDescriptionRequiredDefault
--workspace-id <WORKSPACE_ID>-wWorkspace IDYes-
--yes-ySkip confirmation promptsNofalse

See Global Options for options available to all commands.

workspace user

Manage workspace users

Usage

tailor workspace user [command]

See Global Options for options available to all commands.

Commands

CommandDescription
workspace user inviteInvite a user to a workspace
workspace user listList users in a workspace
workspace user removeRemove a user from a workspace
workspace user updateUpdate a user's role in a workspace

workspace user invite

Invite a user to a workspace

Usage

tailor workspace user invite [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--email <EMAIL>-Email address of the user to inviteYes--
--role <ROLE>-rRole to assign (admin, editor, viewer)Yes--

See Global Options for options available to all commands.

workspace user list

List users in a workspace

Usage

tailor workspace user list [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--order <ORDER>-Sort order (asc or desc)No"desc"-
--limit <LIMIT>-lMaximum number of items to return (0 or omit: unlimited)No--

See Global Options for options available to all commands.

workspace user remove

Remove a user from a workspace

Usage

tailor workspace user remove [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--email <EMAIL>-Email address of the user to removeYes--
--yes-ySkip confirmation promptsNofalse-

See Global Options for options available to all commands.

workspace user update

Update a user's role in a workspace

Usage

tailor workspace user update [options]

Options

OptionAliasDescriptionRequiredDefaultEnv
--workspace-id <WORKSPACE_ID>-wWorkspace IDNo-TAILOR_PLATFORM_WORKSPACE_ID
--profile <PROFILE>-pWorkspace profileNo-TAILOR_PLATFORM_PROFILE
--email <EMAIL>-Email address of the user to updateYes--
--role <ROLE>-rNew role to assign (admin, editor, viewer)Yes--

See Global Options for options available to all commands.

profile

Manage workspace profiles (user + workspace combinations).

Usage

tailor profile [command]

See Global Options for options available to all commands.

Commands

CommandDescription
profile createCreate a new profile.
profile deleteDelete a profile.
profile listList all profiles.
profile updateUpdate profile properties.

profile create

Create a new profile.

Usage

tailor profile create [options] <name>

Arguments

ArgumentDescriptionRequired
nameProfile nameYes

Options

OptionAliasDescriptionRequiredDefaultEnv
--user <USER>-uUser email address or machine user client IDYes--
--workspace-id <WORKSPACE_ID>-wWorkspace IDYes--
--permission <PERMISSION>-Profile permission. 'read' blocks all write commands while the profile is active.No"write"-
--machine-user <MACHINE_USER>-mDefault machine user name for application-data commands (query, workflow start, function test-run, machineuser token).No--
--machine-user-override <MACHINE_USER_OVERRIDE>-Whether the command line or TAILOR_PLATFORM_MACHINE_USER_NAME may override the profile's machine user. 'deny' requires --machine-user.No--
--platform-url <PLATFORM_URL>-Platform API base URL for this profile.No-TAILOR_PLATFORM_URL
--oauth2-client-id <OAUTH2_CLIENT_ID>-OAuth2 client ID for logging in to this profile's platform.No-TAILOR_PLATFORM_OAUTH2_CLIENT_ID
--console-url <CONSOLE_URL>-Console base URL for this profile.No-TAILOR_PLATFORM_CONSOLE_URL

See Global Options for options available to all commands.

profile delete

Delete a profile.

Usage

tailor profile delete <name>

Arguments

ArgumentDescriptionRequired
nameProfile nameYes

See Global Options for options available to all commands.

profile list

List all profiles.

Usage

tailor profile list

See Global Options for options available to all commands.

profile update

Update profile properties.

Usage

tailor profile update [options] <name>

Arguments

ArgumentDescriptionRequired
nameProfile nameYes

Options

OptionAliasDescriptionRequiredDefault
--user <USER>-uNew user email address or machine user client IDNo-
--workspace-id <WORKSPACE_ID>-wNew workspace IDNo-
--permission <PERMISSION>-Profile permission. 'read' blocks all write commands; 'write' lifts the restriction.No-
--machine-user <MACHINE_USER>-mDefault machine user name for application-data commands (query, workflow start, function test-run, machineuser token). Pass an empty string to clear.No-
--machine-user-override <MACHINE_USER_OVERRIDE>-Whether the command line or TAILOR_PLATFORM_MACHINE_USER_NAME may override the profile's machine user. 'deny' requires --machine-user; 'allow' lifts the restriction.No-
--platform-url <PLATFORM_URL>-Platform API base URL for this profile. Pass an empty string to clear.No-
--oauth2-client-id <OAUTH2_CLIENT_ID>-OAuth2 client ID for logging in to this profile's platform. Pass an empty string to clear.No-
--console-url <CONSOLE_URL>-Console base URL for this profile. Pass an empty string to clear.No-

See Global Options for options available to all commands.