Skip to main content

User management

Sign in​

For sign in, you need a login token. After successful login, you receive a session token for subsequent requests.

Example: sign in​

mutation {
  signIn(email: "admin@example.com", password: "123456", expiration: 3600) {
    ok
    result {
      token
    }
    error {
      code
    }
  }
}
note

Expiration is automatically extended after each request.

Sign out​

By calling signOut mutation, you can invalidate a token associated with current request

Example: sign out current session​

mutation {
  signOut {
    ok
  }
}

By setting a parameter all to true, you invalidate all tokens associated with a current identity.

Example: sign out all sessions​

mutation {
  signOut(all: true) {
    ok
  }
}
note

Only persons are allowed to sign out. It cannot be called with a permanent API key.

Invite​

Superadmin or a project admin can invite other person to a project. You can also setup Tenant ACL permissions for other user roles.

mutation {
  invite(
    email: "john@doe.com",
    projectSlug: "my-blog",
    memberships: [
      {
        role: "editor",
        variables: [{name: "language", values: ["cs"]}]
      }
    ]
  ) {
    ok
    error {
      code
    }
  }
}

When a user with given email already exists in a system, he is just added to a project, otherwise a new user is created and login instructions are sent to given e-mail.