{"id":"9362ac2c-e748-4a9c-9a85-e5d1477ecb36","task":"Manage Dixa agents and their team membership via the Dixa REST API","domain":"docs.dixa.io","steps":["Authenticate by generating a static, organization-scoped API token in Dixa (Settings -> Integrations -> API) and send it on every request as an Authorization: Bearer <token> header against the https://dev.dixa.io/v1 host (not app.dixa.io).","Call GET /v1/agents to list agents/admins in the organization; pass ?active=false to include deactivated agents, since only active ones are returned by default, or filter with mutually exclusive email/phone query parameters.","Create a new agent with POST /v1/agents, supplying email, displayName, and role (AGENT, TEAM_LEAD, or ADMIN); Dixa automatically emails an invitation to the new agent.","Update an existing agent's role, active flag, or other fields with a partial update via PATCH /v1/agents/{agentId}, sending only the fields to change.","Add the agent to a team with POST /v1/teams/{teamId}/agents, and separately PATCH /v1/agents/{agentId} with queueIds if queue assignment is also needed."],"gotchas":["Dixa has no hard-delete for agents via the REST API — the supported offboarding method is PATCH /v1/agents/{agentId} with {\"active\": false}, and this does not automatically reassign the agent's open conversations.","Creating an agent via POST /v1/agents always triggers an invitation email with no way to suppress it via the API, and adding an agent to a team does not automatically assign them to that team's queues — queue assignment is a separate call.","Using the wrong API host (app.dixa.io instead of dev.dixa.io) returns 404; rate-limited requests return HTTP 429 with no documented Retry-After header, so exponential backoff is required."],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/9362ac2c-e748-4a9c-9a85-e5d1477ecb36"}