Arbeitsraum erstellen

POST https://sml-api.io/teams

Erstellt einen Arbeitsraum aus einer Vorlage. Seamless richtet die Microsoft 365 Gruppe, das Team und die SharePoint Site genau so ein wie bei einem Antrag in der App: mit Kanälen, Bibliotheken, Berechtigungen und Regeln der Vorlage.

Namenskonvention

Über die API wendet Seamless die Namenskonvention der Vorlage nicht an. Übergeben Sie displayName und mailNickName genau so, wie der Arbeitsraum heissen soll. Die Regeln der Vorlage erhalten Sie mit Organisation abrufen.

Parameter

Feld	Typ	Beschreibung
displayName	Text	Anzeigename des Arbeitsraums
description	Text, optional	Beschreibung
mailNickName	Text	Eindeutiger Teil der E-Mail Adresse vor dem @
responsible	Text	Hauptkontakt, als E-Mail Adresse oder Benutzer ID
deputy	Text, optional	Stellvertretung, als E-Mail Adresse oder Benutzer ID
organisationIdOrIdentifier	Text	ID oder Identifier der Organisation
templateIdOrIdentifier	Text	ID oder Identifier der Vorlage. Die Vorlage muss unter Availability für die API freigegeben sein (App & API oder API).
owners	Liste	Besitzer, als E-Mail Adressen oder Benutzer IDs
members	Liste	Mitglieder, als E-Mail Adressen oder Benutzer IDs

Anfrage

cURL

curl -X POST https://sml-api.io/teams \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "260215.001 - Projekt Atlas",
    "description": "Neubau Bürogebäude Atlas",
    "mailNickName": "prj-260215.001",
    "responsible": "anna.muster@contoso.com",
    "deputy": "marco.rossi@contoso.com",
    "organisationIdOrIdentifier": "contoso",
    "templateIdOrIdentifier": "prj",
    "owners": ["anna.muster@contoso.com", "marco.rossi@contoso.com"],
    "members": ["lea.meier@contoso.com", "jonas.keller@contoso.com"]
  }'

PowerShell

$body = @{
  displayName                = '260215.001 - Projekt Atlas'
  description                = 'Neubau Bürogebäude Atlas'
  mailNickName               = 'prj-260215.001'
  responsible                = 'anna.muster@contoso.com'
  deputy                     = 'marco.rossi@contoso.com'
  organisationIdOrIdentifier = 'contoso'
  templateIdOrIdentifier     = 'prj'
  owners                     = @('anna.muster@contoso.com', 'marco.rossi@contoso.com')
  members                    = @('lea.meier@contoso.com', 'jonas.keller@contoso.com')
} | ConvertTo-Json

Invoke-RestMethod -Method Post -Uri 'https://sml-api.io/teams' -Headers $headers `
  -ContentType 'application/json; charset=utf-8' -Body $body

C#

var res = await http.PostAsJsonAsync("/teams", new {
    displayName = "260215.001 - Projekt Atlas",
    description = "Neubau Bürogebäude Atlas",
    mailNickName = "prj-260215.001",
    responsible = "anna.muster@contoso.com",
    deputy = "marco.rossi@contoso.com",
    organisationIdOrIdentifier = "contoso",
    templateIdOrIdentifier = "prj",
    owners = new[] { "anna.muster@contoso.com", "marco.rossi@contoso.com" },
    members = new[] { "lea.meier@contoso.com", "jonas.keller@contoso.com" }
});

Antwort

{
  "status": "…",
  "teamId": "…",
  "statusUrl": "…"
}

Feld	Beschreibung
status	Stand der Erstellung
teamId	ID des neuen Arbeitsraums
statusUrl	Adresse, unter der Sie den Stand der Erstellung abfragen

Hinweis

Die Erstellung läuft im Hintergrund und dauert je nach Vorlage eine bis mehrere Minuten. Den Stand sehen Sie auch im Admin Center unter Monitoring → Provisioning.

Nächste Schritte

Arbeitsraum umbenennenPATCH /teams/{teamId}/name

Mehr erfahren

Organisationen auflistenGET /organisationsOrganisation abrufenGET /organisations/{idOrIdentifier}NamenskonventionenEinheitliche Namen für Arbeitsräume durchsetzenVorlagen einrichtenVerfügbarkeit und IdentifierArbeitsraum beantragenWizard in der Seamless AppHauptkontaktEin Hauptkontakt pro ArbeitsraumProvisioningBereitstellung verfolgen