POST /enterprises/{enterprise}/teams

To create an enterprise team, the authenticated user must be an owner of the enterprise.

Servers

Path parameters

Name Type Required Description
enterprise String Yes

The slug version of the enterprise name.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
name String Yes

The name of the team.

organization_selection_type String No

Specifies which organizations in the enterprise should have access to this team. Can be one of disabled, selected, or all. disabled: The team is not assigned to any organizations. This is the default when you create a new team. selected: The team is assigned to specific organizations. You can then use the add organization assignments API endpoint. all: The team is assigned to all current and future organizations in the enterprise.

Valid values:

  • "disabled"
  • "selected"
  • "all"

Default value: "disabled"

description String No

A description of the team.

sync_to_organizations String No

Retired: this field is no longer supported. Whether the enterprise team should be reflected in each organization. This value cannot be set.

Valid values:

  • "disabled"
  • "all"

Default value: "disabled"

group_id String No

The ID of the IdP group to assign team membership with. You can get this value from the REST API endpoints for SCIM.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.