Projects

Rename a project

Changed on

Renames a single project when the authenticated caller can edit it. name is the only field this operation writes; workspace write access is required and missing or inaccessible projects return 404. Projects managed by a Generation Table or backing a Production cannot be renamed here — rename them from the owning surface. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

patch/projects/{projectId}

Request

  • Base URL
    https://app.flora.ai/api/v1
  • URL
    https://app.flora.ai/api/v1/projects/{projectId}
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Project identifier

Example:prj_abc123

Request body

namestring required

Project name

Example request

{
  "name": "Spring Campaign"
}

Response

Project renamed.

project_idstring required

Project identifier

namestring required

Project name

thumbnail_urlstring uri nullable

HTTPS project thumbnail URL, or null when unavailable. Uses the manual cover, then the automatic thumbnail, then the legacy project picture. Non-HTTPS URLs are returned as null.

is_privateboolean

True when only the creator sees the project, rather than the whole workspace. Absent when the API cannot tell.

workspace_idstring required

Workspace identifier

originstring nullable required

Project origin

last_modifiednumber nullable required
created_atnumber required

Example response

{
  "project_id": "prj_abc123",
  "name": "Spring Campaign",
  "workspace_id": "ws_abc123",
  "origin": "api"
}

Changes

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • info

      endpoint added