Skip to main content

Members

The people on your team who use the dashboard (the dashboard users). create sends the invitation and resend sends it again; update creates or updates a member by e-mail or id. workspaces get / workspaces update read and set the workspaces the member can access.

CommandHTTPDescription
dashboard-users listGET /v1/dashboard_usersList dashboard users
dashboard-users createPOST /v1/dashboard_usersInvite dashboard user
dashboard-users updatePUT /v1/dashboard_usersCreate or update a dashboard user
dashboard-users getGET /v1/dashboard_users/{id}Get dashboard user
dashboard-users deleteDELETE /v1/dashboard_users/{id}Remove dashboard user
dashboard-users resendPOST /v1/dashboard_users/{id}/resendResend member invitation
dashboard-users workspaces getGET /v1/dashboard_users/{id}/workspacesGet member workspace access
dashboard-users workspaces updatePUT /v1/dashboard_users/{id}/workspacesSet member workspace access

Examples​

--params carries query, path and header parameters (id, page, filters, X-Workspace-Id); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List dashboard users
kobana dashboards dashboard-users list --fields "id,email,name,status,roles"

# Invite dashboard user
kobana dashboards dashboard-users create \
--json '{"email": "joao@example.com", "name": "João", "role_ids": ["ROLE_ID"]}'

# Get member workspace access
kobana dashboards dashboard-users workspaces get \
--params '{"id": "DASHBOARD_USER_ID"}'

# Set member workspace access
kobana dashboards dashboard-users workspaces update \
--params '{"id": "DASHBOARD_USER_ID"}' \
--json '{"workspace_ids": ["WORKSPACE_ID"]}'

Next steps​