Organization

Move an agent to another team

An ORGANISATION write, not a floor one: changing team changes the inherited manager, so it can be refused (ORG_CYCLE, ORG_NO_HUMAN_MANAGER) where PATCH /floor/agents/{id}/position merely picks a desk. teamId: null sends the agent back to the virtual « unassigned » group.

put/organization/agents/{id}/team

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/organization/agents/{id}/team
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Agent id

Request body

teamIdstring uuid nullable required

Response

The recomputed chart — identical shape to GET /organization/chart.

rootHumanIdstring uuid nullable required

DERIVED, never stored: the oldest admin member. Null when the company has no admin at all — the only case where the chart has nothing to hang on.

canEditboolean required

True when the caller is a company admin, i.e. when the write operations below are open to them. Told here so the client never has to deduce a permission from a 403 it provoked.

Changes

No recorded changes to this operation across all 2 revisions of this API.