List Projects

Retrieve a list of projects for the authenticated user’s company

GET /projects

List Projects

cURL

curl --request GET \
  --url https://www.corgea.app/api/v1/projects \
  --header 'CORGEA-TOKEN: <api-key>'

200

Example

{ "status": "ok", "page": 123, "total_pages": 123, "total_projects": 123, "projects": [ { "id": 123, "name": "<string>", "description": "<string>", "repo_url": "<string>", "tags": [ "<string>" ], "created_at": "2023-11-07T05:31:56Z" } ] }

Authorizations

CorgeaTokenBearerAuth

CORGEA-TOKEN · string · header · required

API key for authentication API tokens belonging to inactive users are rejected.

Query Parameters

name · string

Filter projects by name (case-insensitive partial match)

tags · string

Filter by tags (comma-separated)

repo_url · string

Filter projects by repository URL (case-insensitive partial match)

page · integer · default: 1

The page number for pagination

page_size · integer · default: 20

The number of results per page

Required range: x <= 50

sort_by · enum<string>

Sort results by field (prefix with '-' for descending order)

Available options: created_at, -created_at, name, -name

Response

200

application/json

Projects retrieved successfully

status · string

Example:

"ok"

page · integer

total_pages · integer

total_projects · integer

projects · object[]

Show child attributes