Add Repository Member

POST https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/members

Add a user's permissions in a repository. Use this to grant a single repository permission level for a specific repo. If you omit the level, it defaults to canView.

Allowed Roles: Workspace Admin or System Admin • Authentication Required

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

Body

userIdstringRequired

User ID to grant access to.

repositoryPermissionLevel"canView" | "canDeploy" | "canManage"Optional

Repository permission level to grant. If omitted, defaults to canView.

Request

Command Line

curl -sS -X POST "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/members" \
  -H "Authorization: Bearer <admin-token>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "92bbfdcf-78e9-43ac-be77-0076c718b295",
    "repositoryPermissionLevel": "canDeploy"
  }'

Response

{
  "repositoryId": "1910c2ac-62c9-4ffb-888a-84daec3aa3e1",
  "workspaceId": "0a8e6f52-3c44-4c9b-b0c5-9f2d7a1e6b3a",
  "userId": "92bbfdcf-78e9-43ac-be77-0076c718b295",
  "repositoryPermissionLevel": "canDeploy"
}

Add Repository Member to Multiple Repositories

POST https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/members/batch

Add a single user to multiple repositories in the same workspace.

Notes:

• The user must already be a member of the workspace
• Workspace admins cannot be added as repository members
• This endpoint is limited to 100 repositories per request
• Repository names are immutable and cannot be updated, so using names as references is stable
• repositories[].repositoryReference must not contain duplicates, and must not resolve to duplicates

Allowed Roles: Workspace Admin or System Admin • Authentication Required

Path Parameters

workspace-refstringRequired

Workspace ID or name.

Body

userIdstringRequired

User ID (UUID) to add.

repositoriesArray<{ repositoryReference: string, repositoryPermissionLevel: "canView" | "canDeploy" | "canManage" }>Required

Repositories to add the user to. Each item includes repositoryReference (ID or name) and repositoryPermissionLevel. Must be a non empty array, max length depends on server configuration.

Request

Command Line

curl -sS -X POST "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/members/batch" \
  -H "Authorization: Bearer <accessToken>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "92bbfdcf-78e9-43ac-be77-0076c718b295",
    "repositories": [
      {
        "repositoryReference": "npm-local",
        "repositoryPermissionLevel": "canDeploy"
      },
      {
        "repositoryReference": "1910c2ac-62c9-4ffb-888a-84daec3aa3e1",
        "repositoryPermissionLevel": "canView"
      }
    ]
  }'

Response

{
  "workspaceId": "0a8e6f52-3c44-4c9b-b0c5-9f2d7a1e6b3a",
  "userId": "92bbfdcf-78e9-43ac-be77-0076c718b295",
  "repositories": [
      {
          "repositoryId": "1910c2ac-62c9-4ffb-888a-84daec3aa3e1",
          "repositoryPermissionLevel": "canDeploy"
      },
      {
          "repositoryId": "15f3c26d-fc44-4c6a-a2f7-1d27b04e799d",
          "repositoryPermissionLevel": "canView"
      }
  ]
}