v3

latestOpenAPI 3.1.02026-07-311725107.3 KB

Components

Create component

Create a Component for a Project. Requires admin access to the Project, and the Project must have Components enabled.

post/gh/{ownerKeyOrId}/projects/{projectKeyOrId}/components

Path parameters

ownerKeyOrIdstring required

Repository owner name (login) or workspace ID

Example:acme-corp

Repository owner name (login) or workspace ID

projectKeyOrIdstring required

Repository name or project ID

Example:my-repo

Repository name or project ID

Request body

namestring required

descriptionstring nullable

pathGlobsstring[] required

Glob patterns matching the Component's file paths, one glob per array element. * matches any characters, including /.

Example request

{
  "name": "Backend API",
  "description": "Core backend API services",
  "pathGlobs": [
    "src/api/*"
  ]
}

Response

The created component

idstring required

namestring required

descriptionstring nullable required

pathGlobsstring[] required

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Backend API",
  "description": "Core backend API services",
  "pathGlobs": [
    "src/api/*"
  ]
}