projects

Update a project

Updates a project. Every field is optional, so you may send only the fields you would like to change; a field that is omitted keeps its current value. Pass brand_id to designate the project's own brand, or null to leave the project without one.

patch/api/v1/projects/{project}

Request

  • Base URL: https://pineprompt.com
  • URL: https://pineprompt.com/api/v1/projects/{project}
  • Auth: HTTP bearer

Path parameters

projectinteger required
Example:42

The numeric ID of the project.

Request body

namestring

The new display name for the project. May be up to <strong>120</strong> characters.

brand_idinteger nullable

The id of the brand to designate as the project's own brand, the one visibility is anchored against. The brand must belong to the project; it leaves any segments and sheds any ignored mark as it takes the role. Pass null to leave the project without an own brand.

Example request

{
  "name": "Acme Marketing",
  "brand_id": 555
}

Response

OK

idinteger

The unique ID of the project.

organization_idinteger

The ID of the organization that owns the project.

namestring

The display name of the project.

brand_idinteger nullable

The ID of the project's own brand, or null while none has been designated.

created_atstring date-time

When the project was created.

updated_atstring date-time

When the project was last updated.

Example response

{
  "id": 42,
  "organization_id": 7,
  "name": "Acme Marketing",
  "brand_id": 555,
  "organization": {
    "id": 7,
    "name": "Acme Inc.",
    "created_at": "2026-05-15T09:11:42+00:00",
    "updated_at": "2026-05-15T09:11:42+00:00"
  },
  "created_at": "2026-05-15T09:11:42+00:00",
  "updated_at": "2026-05-15T09:11:42+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.