---
updatedAt: 2025-11-12T02:53:39.000Z
agentTools:
  projectIndex: https://docs.sevenbridges.com/llms.txt
---

# Projects and members

## Overview

Use the following commands to manage your projects and project members on the Seven Bridges Platform.

<div align="right"><a href="#top">top</a></div>

## projects create

Create a new project with a desired name and a chosen billing group.

```text projects create
Usage:
  sb projects create --name <name_value> --billing_group <billing_group_value> [--description <description_value>] [--locked <locked_value>] [flags]

Flags:
      --name string            The name given to a new project.
      --billing_group string   The ID of the billing group for the project.
      --description string     A human-readable description of the project.
      --locked string          Prevents any Seven Bridges team member from viewing the project. (default "no")
  -h, --help                   help for create
```

<div align="right"><a href="#top">top</a></div>

## projects list

List the projects accessible to the current user.

```text projects list
Usage:
  sb projects list [--user <user_value>] [flags]

Flags:
      --user string   List only projects owned by the specified user.
  -h, --help          help for list
```

<div align="right"><a href="#top">top</a></div>

## projects get

Get details of the specified project. Note that the project\_id takes the form of `{project_owner}/{project}`, where `{project_owner}` is the username of the user who created the project and \{project} is not the project's full given name, but its \[short name]\(doc:the-api#project-short-name.

```text projects get
Usage:
  sb projects get <project_id> [flags]

Arguments:
      project_id   ID of the project.

Flags:
  -h, --help   help for get
```

<div align="right"><a href="#top">top</a></div>

## projects update

Change the name, description, or billing group of a project. Note that the project\_id takes the form of `{project_owner}/{project}`, where `{project_owner}` is the username of the user who created the project and that \{project} is not the project's full given name but its short name.

```text projects update
Usage:
  sb projects update <project_id> [--name <name_value>] [--billing_group <billing_group_value>] [--description <description_value>] [--locked <locked_value>] [flags]

Arguments:
      project_id   ID of the project.

Flags:
      --name string            The new name given to the project.
      --billing_group string   The ID of the new billing group for the project.
      --description string     A human-readable new description of the project.
      --locked string          Prevents any Seven Bridges team member from viewing the project. (default "no")
  -h, --help                   help for update
```

<div align="right"><a href="#top">top</a></div>

## projects delete

Delete a project from the Platform. Note that this completely erases the project and any related data.

```text projects delete
Usage:
  sb projects delete <project_id> [flags]

Arguments:
      project_id   ID of the project.

Flags:
  -h, --help   help for delete
```

<div align="right"><a href="#top">top</a></div>

## members create

Add an existing member to the specified project with appropriate permissions. This request can only be successfully made by a user who has admin permissions in the project.

Users may have the following permissions on the Platform:

* Read
* Write
* Copy
* Execute
* Admin

```text members create
Usage:
  sb members create --project <project_value> --user <user_value> [--read] [--write] [--copy] [--execute] [--admin] [flags]

Flags:
      --project string   The ID of the project you are adding a new member to.
      --user string      The username of the person you are adding to the project.
      --read             The member can view file names, metadata, and workflows. This is automatically assigned when a member is created. (default true)
      --write            The member can add, modify, and remove files and workflows.
      --copy             The member can view file content, copy, and download files.
      --execute          The member can execute workflows and abort tasks.
      --admin            The member can modify another user's permissions, add or remove people, and manage funding sources.
```

<div align="right"><a href="#top">top</a></div>

## members list

Get a list of the members of the specified project.

```text members list
Usage:
  sb members list --project <project_value> [flags]

Flags:
      --project string   The project for which to return the list of members.
  -h, --help             help for list
```

<div align="right"><a href="#top">top</a></div>

## members get

Get member permissions for a given project.

Users may have the following permissions on the Seven Bridges Platform:

* Read
* Write
* Copy
* Execute
* Admin

Permissions are granted at the project-level. You may, for instance, have admin permission in one project, execute permission in another, and read-only permission in a third.

```text members get
Usage:
  sb members get --project <project_value> --user <user_value> [flags]

Flags:
      --project string   The ID of the project containing the member(s) whose permissions you are querying.
      --user string      The username of the member whose permissions you are querying.
  -h, --help             help for get
```

<div align="right"><a href="#top">top</a></div>

## members update

Update a project member's permission for the specified project. It can only be successfully made if you have admin status for the project.

```text members update
Usage:
  sb members update --project <project_value> --user <user_value> [--read] [--write] [--copy] [--execute] [--admin] [flags]

Flags:
      --project string   The ID of the project containing the member whose permissions you’d like to update.
      --user string      The username of the project member whose permissions you are updating.
      --read             This permission allows a project member to view file names, metadata, and workflows. Read permissions are assigned by default. (default true)
      --write            This permission allows a project member to add, modify, and remove files and workflows.
      --copy             This permission allows a project member to view file content, copy, and download files.
      --execute          This permission allows a project member to execute workflows and abort tasks.
      --admin            This permission allows a project member to modify another user's permissions, add or remove people, and manage funding sources.
  -h, --help             help for update
```

<div align="right"><a href="#top">top</a></div>

## members delete

Remove a member from the specified project. This command can only be successfully run by a user who has admin privileges in the specified project.

```text members delete
Usage:
  sb members delete --project <project_value> --user <user_value> [flags]

Flags:
      --project string   The ID of the project from which you are removing a member.
      --user string      The username of the member you are removing.
  -h, --help             help for delete
```

<div align="right"><a href="#top">top</a></div>