Skip to content
Seamless Documentation

Project workspace

AI translated from the German original

Create workspaces automatically from a project portal.

A project portal automatically creates a workspace for every new project. The process combines the endpoints of the Seamless API.

  1. Get an access token with the API key. It is valid for 24 hours.

  2. Determine the organisation with List organisations. If you already know the identifier, e.g. contoso, you can skip this step.

  3. Determine the template with Get an organisation. displayNamePattern and mailNicknamePattern show how to build the name and email address from the project data. Seamless does not apply the naming convention via the API, so you build the names yourself.

    Example: {{projectCode}} - {{name}} and the project 260215.001 named Project Atlas result in 260215.001 - Project Atlas.

  4. Create the workspace with Create a workspace. Enter the project lead as the primary contact.

  5. Store the teamId in the project portal. You use it to rename the workspace when the project name changes.

Next steps

WebhooksStart your own processes on events

Learn more

Get an access tokenPOST /tokenList organisationsGET /organisationsGet an organisationGET /organisations/{idOrIdentifier}Create a workspacePOST /teamsRename a workspacePATCH /teams/{teamId}/nameNaming conventionsEnforce consistent names for workspacesProvisioningTrack provisioning