Teams

Apply teams by stable key

Changed on

Creates or replaces an organization-scoped resource. Names do not identify resources; existing unkeyed resources are never adopted automatically. Assignments are replaced. Omitted write-only secrets are preserved. Concurrent writes are last-write-wins; conditional headers are not supported on this route.

put/v1/teams/by-key/{externalKey}

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/teams/by-key/{externalKey}
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

externalKeystring required

Request body

namestring required
memberIdsstring[]
grantsOrganizationAdminboolean

Response

The existing resource was replaced.

Changes

    • info

      added the optional property to the response with the status

    • info

      the endpoint scheme security bearerAuth was added to the API

    • info

      the endpoint scheme security denApiKey was added to the API