CreateTeam

POST/api/v1/teams

Create a team. The caller becomes its first owner unless owners are given.

Example request

US

curl -X POST \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "string" }' \
  "https://us.oblique.security/api/v1/teams"

Set OBLIQUE_API_KEY to your API key.

Europe

curl -X POST \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "string" }' \
  "https://eu.oblique.security/api/v1/teams"

Set OBLIQUE_API_KEY to your API key.

Query parameters

• teamIdstring

  ID of the team to create. This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/.

Request body

• namestring

  Assigned by Oblique. Name of the team of the format teams/{team}.

• displayNamestringrequired

  Displayed name of the team.

• descriptionstring

  Longer description.

• managementManagement

  How this team is managed. Set automatically by the server based on the calling client. Omitted from responses when the team is manually managed (the default).

  • managerstring
    Allowed values: TERRAFORM

    How the API object is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.

  • repoUristring

    URI of the VCS repository that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

  • repoDirstring

    Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

• createTimestring (date-time)read-only

  Create and update timestamps.

• updateTimestring (date-time)read-only
• deleteTimestring (date-time)read-only

  Teams can only be soft-deleted to preserve logs and history.

• memberCountinteger (int32)read-only

  The number of members in the team.

Response

200Team

A team represents a group of users. Teams can be hierarchical by specifying a single parent, but can’t be arbitrarily nested.

• namestring

  Assigned by Oblique. Name of the team of the format teams/{team}.

• displayNamestringrequired

  Displayed name of the team.

• descriptionstring

  Longer description.

• managementManagement

  How this team is managed. Set automatically by the server based on the calling client. Omitted from responses when the team is manually managed (the default).

  • managerstring
    Allowed values: TERRAFORM

    How the API object is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.

  • repoUristring

    URI of the VCS repository that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

  • repoDirstring

    Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this API object. Populated by the Oblique Terraform provider.

• createTimestring (date-time)read-only

  Create and update timestamps.

• updateTimestring (date-time)read-only
• deleteTimestring (date-time)read-only

  Teams can only be soft-deleted to preserve logs and history.

• memberCountinteger (int32)read-only

  The number of members in the team.

Errors

Status	Meaning
400	Malformed request
401	Missing or invalid API key
403	Not allowed for this API key
404	Not found
429	Too many requests
500	Internal server error