Projects

Create a project

Changed on

Creates a new Flora project in the requested workspace. To file the project into a project folder, use POST /workspaces/{workspace_id}/folders/{folder_id}/projects. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/projects

Request

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

Request body

workspace_idstring required

Workspace identifier

namestring required

Project name

Example request

{
  "workspace_id": "ws_abc123",
  "name": "Spring Campaign"
}

Response

Project created.

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • info

      added the non-success response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status