Update Team

Update Team

PUT /api/v1/org/{orgId}/team/{teamId}

Update this organization team info.

Request to update an existing StackHawk Team.

Parameter	Default	Description
teamId	""	The UUID identifier of this tea,.
name	""	updated name for this team.
applicationIds	[]	updated applicationIds for this team.
userIds	[]	updated member ids for this team.
organizationId	""	The UUID identifier of this organization.

🧾 Audited This is recorded as TEAM_UPDATED User Activity.

Requires write:team permission.

Path parameters

orgIdstring · uuidrequired

UUID identifier for this StackHawk Organization.

teamIdstring · uuidrequired

UUID identifier for this StackHawk Team.

Body

applicationIds

string[]

updated applicationIds for this team.

name

string required

updated name for this team.

organizationId

string read-only

The UUID identifier of this organization.

teamId

string read-only

The UUID identifier of this tea,.

userIds

string[]

updated member ids for this team.

Response

team

organization.Team

Hide child attributesShow child attributes

team.applications

organization.TeamApplication[]

The applications that belong to this Team.

Hide child attributesShow child attributes

team.applications.applicationId

string

team.applications.applicationName

string

team.applications.environments

string[]

team.applications.lastScanTimestamp

integer<int64>

team.id

string

The UUID identifier of this team.

team.name

string

The name of this team.

team.organizationId

string

The StackHawk organization that owns this Team.

team.users

organization.TeamUser[]

The users that are members of this Team.

Hide child attributesShow child attributes

team.users.email

string

team.users.role

string

team.users.userId

string

team.users.userName

string

team

organization.Team

Hide child attributesShow child attributes

team.applications

organization.TeamApplication[]

The applications that belong to this Team.

Hide child attributesShow child attributes

team.applications.applicationId

string

team.applications.applicationName

string

team.applications.environments

string[]

team.applications.lastScanTimestamp

integer<int64>

team.id

string

The UUID identifier of this team.

team.name

string

The name of this team.

team.organizationId

string

The StackHawk organization that owns this Team.

team.users

organization.TeamUser[]

The users that are members of this Team.

Hide child attributesShow child attributes

team.users.email

string

team.users.role

string

team.users.userId

string

team.users.userName

string

Bad Request

Unauthorized

PUT /api/v1/org/{orgId}/team/{teamId}

cURL

curl --request PUT \
  --url 'https://api.stackhawk.com/api/v1/org/{orgId}/team/{teamId}' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

Copy

Update Team

Update Team

Path parameters

Body

Response

Your privacy settings