gitbeaker/docs/projects.md
2017-07-04 12:35:16 -04:00

3.0 KiB

Projects API

List all projects

Get a list of visible projects for authenticated user. When accessed without authentication, only public projects are returned.

let projects = GitlabAPI.projects.all();

Parameters: List all projects

Get a single project

Get a specific project. This endpoint can be accessed without authentication if the project is publicly accessible.

// From a project ID
let projectA = GitlabAPI.projects.show(21);

// From a projects url
let projectB = GitlabAPI.projects.show('diaspora/diaspora');

Parameters: Get a single project

Create a project

Creates a new project owned by the authenticated user.

// From a project ID
let projectA = GitlabAPI.projects.create({
  // params
});

Parameters: Create a project

Create a project for user

Creates a new project owned by the specified user. Available only for admins.

// From a project ID
let projectA = GitlabAPI.projects.create({
	userId: 5,
  // params
});

Parameters: Create a project for user

Edit a project

Creates a new project owned by the specified user. Available only for admins.

// From a project ID
let projectA = GitlabAPI.projects.edit(projectId, {
  // params
});

Parameters: Edit a project

Fork a project

Forks a project into the user namespace of the authenticated user or the one provided.

// From a project ID
let projectA = GitlabAPI.projects.fork(projectId, {
  // params
});

Parameters: Fork a project

Star a project

Stars a given project. Returns status code 304 if the project is already starred.

// From a project ID
let projectA = GitlabAPI.projects.star(projectId);

Parameters: Star a project

Unstar a project

Unstars a given project. Returns status code 304 if the project is not starred.

// From a project ID
let projectA = GitlabAPI.projects.unstar(projectId);

Parameters: Unstar a project