assign-customer-group-user
dci assign-customer-group-user
Assigns a user to a customer group owned by the authenticated tenant. Requires the UsersManager permission.
A successful assignment returns no body. Once assigned, the user sees only the group's member customers. Requires the users-manager permission.
Examples
# Scope a user to a customer group.
dci assign-customer-group-user <customer-group-id> <user-id>
# In a script; the assignment returns no body, so branch on the exit code (non-zero when the group or user does not exist).
dci assign-customer-group-user <customer-group-id> <user-id> && echo assigned
Output
On success, this command produces no response data.
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
HTTP status to exit code mapping
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 404 | 20 | RESOURCE_NOT_FOUND | The requested resource does not exist. Check the identifier argument. |
| 429 | 50 | RATE_LIMITED | Too many requests. Retryable — the CLI reports the server-provided delay. |
| 500, 503 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Related
- unassign-customer-group-user — Unassign a user from a customer group
- list-customer-groups — List customer groups
- get-customer-group — Get a customer group
- list-users — List users
- API reference: PUT /rbac/v1/customer-groups/{customerGroupId}/users/{userId}
Aliases: assigncustomergroupuser