PlanyDocs
Services

AccountService

plany.account.v1.AccountService — your account, and the people in it.

Endpoint api.plany.cloud:443 · Guide · Reference

An account is what holds your credit, your plan, your builds and your projects, and the people who can work on them. This service reads and updates the account and manages who belongs to it.

The account

CallWhat it does
ListAccountsThe accounts you are a member of.
GetAccountOne account: its name, state and plan.
UpdateAccountChange its display name and other settings, with an update_mask.
GetCurrentUserWho the caller is.
grpcurl
grpcurl -H "authorization: Bearer $PLANY_API_KEY" \
-d '{}' \
api.plany.cloud:443 plany.account.v1.AccountService/ListAccounts

Members

accounts/{account}/memberships/{membership}

Adding somebody to your account is an invitation. CreateMembership takes their email address and the account-level roles to grant, and emails them; when they accept, the membership becomes active and the roles take effect.

Team & access → Invite → enter an email address and choose roles → Invite

ListMemberships shows everybody, including invitations not yet accepted. UpdateMembership changes somebody's roles, and DeleteMembership removes them from the account.

To give somebody access to one project rather than the whole account, grant them a role on the project instead. See IamService.