{"components":{"schemas":{"PublicApiBulkOperationRequest":{"properties":{"teamIds":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["teamIds"],"type":"object"},"PublicApiBulkOperationResponse":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/PublicApiBulkTeamOperationError"},"type":"array"},"successfulTeamIds":{"items":{"type":"string"},"type":"array"}},"required":["errors","successfulTeamIds"],"type":"object"},"PublicApiBulkTeamOperationError":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"teamId":{"type":"string"}},"required":["code","message","teamId"],"type":"object"},"PublicApiExternalReference":{"properties":{"id":{"type":"string"},"source":{"enum":["ATLASSIAN_GROUP"],"type":"string"}},"required":["id","source"],"type":"object"},"PublicApiExternalTeamCreationPayload":{"properties":{"description":{"maxLength":360,"minLength":0,"type":"string"},"externalReference":{"$ref":"#/components/schemas/PublicApiExternalReference"},"siteId":{"description":"[Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","maxLength":255,"minLength":1,"nullable":true,"type":"string"}},"required":["description","externalReference"],"type":"object"},"PublicApiFetchResponsePublicApiMembershipString":{"properties":{"pageInfo":{"$ref":"#/components/schemas/PublicApiPageInfoString"},"results":{"items":{"$ref":"#/components/schemas/PublicApiMembership"},"type":"array"}},"required":["pageInfo","results"],"type":"object"},"PublicApiLinkTeamToExternalSourcePayload":{"properties":{"externalReference":{"$ref":"#/components/schemas/PublicApiExternalReference"},"siteId":{"description":"The siteId to help locate the externalReference. For example, when the externalReference is a group belonging to a site. [Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","maxLength":255,"minLength":1,"nullable":true,"type":"string"}},"required":["externalReference"],"type":"object"},"PublicApiMembership":{"properties":{"accountId":{"type":"string"}},"required":["accountId"],"type":"object"},"PublicApiMembershipAddPayload":{"properties":{"members":{"items":{"$ref":"#/components/schemas/PublicApiMembership"},"maxItems":50,"minItems":1,"type":"array","uniqueItems":true}},"required":["members"],"type":"object"},"PublicApiMembershipAddResponse":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/PublicApiMembershipCodedError"},"type":"array","uniqueItems":true},"members":{"items":{"$ref":"#/components/schemas/PublicApiMembership"},"type":"array","uniqueItems":true}},"required":["errors","members"],"type":"object"},"PublicApiMembershipCodedError":{"properties":{"accountId":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["accountId","code","message"],"type":"object"},"PublicApiMembershipFetchPayload":{"properties":{"after":{"description":"Pagination cursor, only members after the cursor will be returned","nullable":true,"type":"string"},"first":{"default":50,"description":"Maximum number of members to be returned","exclusiveMinimum":true,"format":"int32","maximum":50,"minimum":0,"type":"integer"}},"type":"object"},"PublicApiMembershipRemovePayload":{"properties":{"members":{"items":{"$ref":"#/components/schemas/PublicApiMembership"},"maxItems":50,"minItems":1,"type":"array","uniqueItems":true}},"required":["members"],"type":"object"},"PublicApiMembershipRemoveResponse":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/PublicApiMembershipCodedError"},"type":"array","uniqueItems":true}},"required":["errors"],"type":"object"},"PublicApiOverallCodedError":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"PublicApiPageInfoString":{"properties":{"endCursor":{"nullable":true,"type":"string"},"hasNextPage":{"type":"boolean"}},"required":["hasNextPage"],"type":"object"},"PublicApiTeam":{"properties":{"creatorId":{"nullable":true,"type":"string"},"description":{"type":"string"},"displayName":{"type":"string"},"externalReference":{"allOf":[{"$ref":"#/components/schemas/PublicApiTeamExternalReference"}],"nullable":true},"organizationId":{"type":"string"},"state":{"enum":["ACTIVE","ARCHIVED"],"type":"string"},"teamId":{"type":"string"},"teamType":{"enum":["OPEN","MEMBER_INVITE","EXTERNAL","ORG_ADMIN_MANAGED"],"type":"string"}},"required":["description","displayName","organizationId","state","teamId","teamType"],"type":"object"},"PublicApiTeamCreationPayload":{"properties":{"description":{"maxLength":360,"minLength":0,"type":"string"},"displayName":{"maxLength":250,"minLength":1,"type":"string"},"siteId":{"description":"If the org mandates site-scoped teams, a site ID must be provided or the operation will fail. [Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","maxLength":255,"minLength":1,"nullable":true,"type":"string"},"teamType":{"enum":["OPEN","MEMBER_INVITE","EXTERNAL","ORG_ADMIN_MANAGED"],"type":"string"}},"required":["description","displayName","teamType"],"type":"object"},"PublicApiTeamExternalReference":{"properties":{"id":{"type":"string"},"source":{"enum":["ATLASSIAN_GROUP","HRIS"],"type":"string"}},"required":["id","source"],"type":"object"},"PublicApiTeamPaginationResult":{"description":"Cursor pagination result for PublicApiTeam","properties":{"cursor":{"description":"The cursor token for the next page of results. Continue querying with the returned cursor until it is null.","nullable":true,"type":"string"},"entities":{"description":"The list of teams","items":{"$ref":"#/components/schemas/PublicApiTeam"},"type":"array"}},"required":["entities"],"type":"object"},"PublicApiTeamResponse":{"properties":{"creatorId":{"nullable":true,"type":"string"},"description":{"type":"string"},"displayName":{"type":"string"},"externalReference":{"$ref":"#/components/schemas/PublicApiTeamExternalReference"},"organizationId":{"type":"string"},"state":{"enum":["ACTIVE","ARCHIVED"],"type":"string"},"teamId":{"type":"string"},"teamType":{"enum":["OPEN","MEMBER_INVITE","EXTERNAL","ORG_ADMIN_MANAGED"],"type":"string"},"userPermissions":{"$ref":"#/components/schemas/PublicApiUserPermissions"}},"required":["description","displayName","organizationId","state","teamId","teamType","userPermissions"],"type":"object"},"PublicApiTeamResponseWithMembers":{"properties":{"creatorId":{"nullable":true,"type":"string"},"description":{"type":"string"},"displayName":{"type":"string"},"externalReference":{"$ref":"#/components/schemas/PublicApiTeamExternalReference"},"members":{"items":{"$ref":"#/components/schemas/PublicApiMembership"},"type":"array","uniqueItems":true},"organizationId":{"type":"string"},"state":{"enum":["ACTIVE","ARCHIVED"],"type":"string"},"teamId":{"type":"string"},"teamType":{"enum":["OPEN","MEMBER_INVITE","EXTERNAL","ORG_ADMIN_MANAGED"],"type":"string"},"userPermissions":{"$ref":"#/components/schemas/PublicApiUserPermissions"}},"required":["description","displayName","members","organizationId","state","teamId","teamType","userPermissions"],"type":"object"},"PublicApiTeamUpdatePayload":{"properties":{"description":{"maxLength":360,"minLength":0,"nullable":true,"type":"string"},"displayName":{"maxLength":250,"minLength":1,"nullable":true,"pattern":".*\\S+.*","type":"string"}},"type":"object"},"PublicApiUserPermissions":{"properties":{"ADD_MEMBERS":{"type":"boolean"},"DELETE_TEAM":{"type":"boolean"},"REMOVE_MEMBERS":{"type":"boolean"},"UPDATE_TEAM":{"type":"boolean"}},"required":["ADD_MEMBERS","DELETE_TEAM","REMOVE_MEMBERS","UPDATE_TEAM"],"type":"object"}},"securitySchemes":{"asap":{"bearerFormat":"JWT","description":"Include an ASAP token in the `Authorization` header as a Bearer token","scheme":"bearer","type":"http"}}},"info":{"description":"Teams API\n\nNote: This REST API is not feature complete. New Teams capabilities are being built in GraphQL. For the full set of features, see the [Teams GraphQL API](https://developer.atlassian.com/platform/teams/teams-graphql-api/introduction/).","title":"Teams API","version":"4.0"},"openapi":"3.0.1","paths":{"/public/teams/v1/org/{orgId}/teams":{"get":{"description":"This returns a list of all teams contained under an organization. This may be used as an option to export teams data within your organization. Callers must continue querying with the returned cursor until the cursor is null.","operationId":"queryTeams","parameters":[{"description":"The ID of the organisation the teams are to be retrieved from.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"[Optional] The ID of the site to retrieve teams which are site scoped. Please note that if the org is site-scoped, teams will not be included in response if siteId is not provided. [Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","in":"query","name":"siteId","required":false,"schema":{"maxLength":255,"minLength":1,"type":"string"}},{"description":"The page size for the number of teams to return (max 300)","in":"query","name":"size","required":false,"schema":{"default":50,"format":"int32","maximum":300,"minimum":1,"type":"integer"}},{"description":"An optional cursor token to fetch the next page of results. Leave empty for the first request. Callers must continue querying with the returned cursor until the cursor is null.","in":"query","name":"cursor","required":false,"schema":{"maxLength":255,"minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamPaginationResult"}}},"description":"Teams retrieved successfully. The details of the team are in the response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Get a list of teams.","tags":["Teams Public API"]},"post":{"description":"Creates a team, and adds the requesting user as the initial member.","operationId":"createTeam","parameters":[{"description":"The ID of the organisation the team is to be created under.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamCreationPayload"}}},"description":"Details of the team to be created.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamResponseWithMembers"}}},"description":"Team created successfully. The details of the team are in the response, including the team ID, which can be used to reference the team for other operations."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Create a team.","tags":["Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/archive":{"post":{"operationId":"archiveTeams","parameters":[{"description":"The ID of the organisation that owns the teams to archive.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationRequest"}}},"description":"The list of team IDs to archive. All IDs must belong to the organisation specified in the path.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationResponse"}}},"description":"Bulk archive processed. Completed team IDs appear in 'successfulTeamIds'; any failures are listed in 'errors'."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Archive teams in bulk.","tags":["Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/external":{"post":{"description":"Creates an external linked team, and membership will be synced with the external reference.","operationId":"createExternalLinkedTeam","parameters":[{"description":"The ID of the organisation the team is to be created under.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiExternalTeamCreationPayload"}}},"description":"Details of the team to be created.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamResponse"}}},"description":"Team created successfully. The details of the team are in the response, including the team ID, which can be used to reference the team for other operations."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Create an external linked team.","tags":["Externally Linked Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/external/bulk/unlink":{"post":{"description":"Unlinks managed teams from their external references in bulk. Each team's membership setting will be transitioned from EXTERNAL to ORG_ADMIN_MANAGED.","operationId":"unlinkTeamsFromExternalSource","parameters":[{"description":"The ID of the organisation that owns the managed teams to unlink.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationRequest"}}},"description":"The list of team IDs to unlink from their external references. All IDs must belong to the organisation specified in the path.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationResponse"}}},"description":"Bulk unlink processed. Completed team IDs appear in 'successfulTeamIds'; any failures are listed in 'errors'."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Unlink managed teams from their external references in bulk.","tags":["Externally Linked Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/unarchive":{"post":{"operationId":"unarchiveTeams","parameters":[{"description":"The ID of the organisation that owns the teams to unarchive.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationRequest"}}},"description":"The list of team IDs to archive. All IDs must belong to the organisation specified in the path.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiBulkOperationResponse"}}},"description":"Bulk unarchive processed. Completed team IDs appear in 'successfulTeamIds'; any failures are listed in 'errors'."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."}},"summary":"Unarchive teams in bulk.","tags":["Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}":{"delete":{"operationId":"deleteTeam","parameters":[{"description":"The ID of the organisation the team is to be deleted from.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team to be deleted.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Team deleted successfully."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Delete a team.","tags":["Teams Public API"]},"get":{"operationId":"getTeam","parameters":[{"description":"The ID of the organisation the team is to be retrieved from.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team to be retrieved.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"description":"[Optional] The ID of the site to retrieve teams which are site scoped. Please note that if the org is site-scoped, teams will not be included in response if siteId is not provided. [Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","in":"query","name":"siteId","required":false,"schema":{"maxLength":255,"minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamResponse"}}},"description":"Team retrieved successfully. The details of the team are in the response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Get a single team.","tags":["Teams Public API"]},"patch":{"description":"This will only update the fields that get passed in and leave the rest as unmodified.","operationId":"updateTeam","parameters":[{"description":"The ID of the organisation the team to be updated belongs to.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team to be updated.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamUpdatePayload"}}},"description":"Details the team is to be updated with.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiTeamResponse"}}},"description":"Team updated successfully. The updated details of the team are in the response."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Modify a team.","tags":["Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}/external/link":{"post":{"description":"Links an existing team to an external reference, and membership and team name will be synced with the external reference.","operationId":"linkTeamToExternalSource","parameters":[{"description":"The ID of the organisation the team and external reference to be linked belongs to.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team to be linked.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiLinkTeamToExternalSourcePayload"}}},"required":true},"responses":{"204":{"description":"Team linked to external reference successfully."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."}},"summary":"Link an existing team to an external reference.","tags":["Externally Linked Teams Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}/members":{"post":{"description":"Returns a set of account IDs who are members of the team, alongside a pagination cursor to retrieve the next page (if available).","operationId":"fetchMembers","parameters":[{"description":"The ID of the organisation of the team you are fetching members for.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team you are fetching members for.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}},{"description":"[Optional] The ID of the site you are fetching members for. [Deprecated] Omitting siteId is deprecated. With the introduction of Units, orgId alone is no longer sufficient to resolve the scope of teams. Always provide a valid siteId to ensure this operation continues to work in the future.","in":"query","name":"siteId","required":false,"schema":{"maxLength":255,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMembershipFetchPayload"}}},"description":"Optional Relay-style pagination controls. Can be omitted if empty."},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublicApiFetchResponsePublicApiMembershipString"}}},"description":"Team members were fetched successfully."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Fetch a set of membership(s).","tags":["Teams Members Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}/members/add":{"post":{"description":"The account IDs specified will be added to the team.","operationId":"addMembers","parameters":[{"description":"The ID of the organisation of the team you are adding members to.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team you are adding members to.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMembershipAddPayload"}}},"description":"A set of account IDs to add as members.","required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublicApiMembershipAddResponse"}}},"description":"Team members were added successfully, at least partially. See the 'members' field of the response for any successful additions, and the 'errors' field of the response for any failed additions."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Add a set of membership(s).","tags":["Teams Members Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}/members/remove":{"post":{"description":"The account IDs specified will be removed from the team.","operationId":"removeMembers","parameters":[{"description":"The ID of the organisation of the team you are removing members from.","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team you are removing members from.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiMembershipRemovePayload"}}},"description":"A set of account IDs to remove as members.","required":true},"responses":{"200":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/PublicApiMembershipRemoveResponse"}}},"description":"Team members were removed successfully, at least partially. See the 'errors' field of the response for any failed removals."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."}},"summary":"Remove a set of membership(s).","tags":["Teams Members Public API"]}},"/public/teams/v1/org/{orgId}/teams/{teamId}/restore":{"post":{"operationId":"restoreTeam","parameters":[{"description":"The ID of the organisation the team belongs to","in":"path","name":"orgId","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The ID of the team to restore","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Team restored successfully."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."}},"summary":"Restore a single soft-deleted team","tags":["Teams Public API"]}},"/public/teams/v1/{teamId}/cover-photo":{"put":{"description":"This updates the cover photo of the team. The cover photo must be a valid image file.","operationId":"uploadAndSetTeamCoverPhoto","parameters":[{"description":"The ID of the team to be updated.","in":"path","name":"teamId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"format":"binary","type":"string"}},"required":["file"],"type":"object"}}},"description":"The cover photo to be uploaded.","required":true},"responses":{"204":{"description":"Team cover photo uploaded successfully."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"One or more values that were provided were invalid."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Forbidden."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team cannot be found."},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"The team has been deleted."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Cover photo is too large."},"415":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Cover photo is not a valid image file."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicApiOverallCodedError"}}},"description":"Team cover photo cannot be uploaded in FedRAMP boundary."}},"summary":"Upload a team cover photo","tags":["Teams Public API"]}}},"servers":[{"url":"https://api.atlassian.com"}],"tags":[{"description":"Manage team entities","name":"Teams Public API"},{"description":"Manage the members of a team","name":"Teams Members Public API"},{"description":"Manage externally linked team","name":"Externally Linked Teams Public API"}]}