Skip to content
campaiDeveloper
campai.com

Connect · Teams

POST/connect/organizations/{organizationId}/teams/{teamId}/memberships/manual/{contactId}/remove

Remove manual team membership

Removes a contact’s manual assignment to a team in an organization. Membership remains if automatic rules or a subteam still require it. The endpoint returns no content.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller needs organization access and team.edit.
  • The caller must also have mandate.read. The contact must pass the permitted mandate restrictions.
  • The contact must have at least one type the caller can read: contact:member.read, contact:address.read, contact:customer.read, contact:sponsor.read, contact:contributor.read, contact:employee.read, or contact:supplier.read, according to its type.

Request

Path parameters

  • organizationIdidrequired
  • teamIdidrequired
  • contactIdidrequired
Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/connect/organizations/YOUR_ORGANIZATION_ID/teams/YOUR_TEAM_ID/memberships/manual/YOUR_CONTACT_ID/remove' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

200 Successful response

No response body is specified.

What else happens

  • The contact’s manual membership flag is cleared.
  • For a subteam, the contact’s team link is removed if the contact does not match the team’s membership rules.
  • Parent team membership may be added or removed to reflect manual assignments, subteams, and membership rules.
  • Team membership counts are updated when membership changes require it.
  • The team’s membership revision is incremented.
  • When a user loses access to an affected team and has no other qualifying membership, their team chat activity states are deleted.
  • The contact’s Connect user-organization cache is cleared.

Errors

Other errors

StatusErrorWhen
404The team was not foundIf the team is not found in the organization, the endpoint returns HTTP 404 NOT_FOUND with key routes.connect.teams.notFound.
404The membership was not found or you do not have access to the contactIf the manual membership is not found or the caller cannot access the contact, the endpoint returns HTTP 404 NOT_FOUND with key routes.connect.teams.membershipNotFound.
404The membership was not found or you do not have access to the contactIf the membership update matches no contact, the endpoint returns HTTP 404 NOT_FOUND with key routes.connect.teams.membershipNotFound.

Errors nearly every request can meet are listed under Errors.