Overview
PATCH/project/projects/{id}project

Update a project (+ a project.updated activity)

Update fields of a record in projects by id.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • idpathstring
Request body

application/json · optional

  • nameoptionalstring
  • descriptionoptionalstring
  • statusoptionalstring
  • coloroptionalstring
  • archivedAtoptionalstring?

    an ISO timestamp archives; null un-archives

Example
{
  "name": "string",
  "description": "string",
  "status": "string",
  "color": "string",
  "archivedAt": "string"
}
Responses
200

Project

  • 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"
}
400

Error

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

Error

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

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X PATCH "https://api.agenticdeveloperhub.com/project/projects/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "string",
  "status": "string",
  "color": "string",
  "archivedAt": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/project/projects/{id}", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"status\": \"string\",\n  \"color\": \"string\",\n  \"archivedAt\": \"string\"\n}",
});
const data = await res.json();