Overview
GET/project/projectsproject

List the projects in the caller's reach (non-deleted, oldest first)

List projects.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • workspacequery · optionalstring

    Scope to this WORKSPACE’s owning principal (the caller’s own customer slug, or an organization the caller belongs to): the list pins to rows the principal OWNS, and a create stamps it as the owner. Omitted: the caller’s reach (owned / org / participating). Unknown/foreign slug: 404.

Responses
200

Projects

  • idstring
  • namestring
  • descriptionstring
  • statusstring

    lifecycle status (DB default 'active')

  • colorstring

    hex board accent (DB default #007AFF)

  • createdAtstring
  • updatedAtstring
  • isDeletedboolean
  • syncVersioninteger
  • customerIdstring

    the customer (user) who created the project

  • deletedAtoptionalstring?
  • ecosystemIdstring

    the owning ecosystem (tenant scope)

  • archivedAtoptionalstring?

    ISO timestamp when archived; null = not archived

  • ownerKind"customer" | "organization"

    the kind of principal that OWNS the project

  • ownerIdstring

    the owning principal (customer or organization id); server-stamped from the verified ?workspace= scope, else the creator

Example
[
  {
    "id": "string",
    "name": "string",
    "description": "string",
    "status": "string",
    "color": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "isDeleted": true,
    "syncVersion": 0,
    "customerId": "string",
    "deletedAt": "string",
    "ecosystemId": "string",
    "archivedAt": "string",
    "ownerKind": "customer",
    "ownerId": "string"
  }
]
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/project/projects" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/project/projects", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();