Move a Design

Move one design to another project of your workspace. Any design GET /designs lists can be moved.

PUT/designs/{designId}/projectAPI Reference

Moving a design resets its approval status

The approval was given within the project the design leaves, so it does not follow the design. Moving a design to the project it is already in changes nothing, approval status included.

Sample request

curl -X PUT \
  -H "x-api-key: {YOUR-API-KEY}" \
  -H "Content-Type: application/json" \
  -d '{"project_id": "9d00e9fe-9bd5-4471-acad-baa702a867e9"}' \
  https://api.abyssale.com/designs/64238d01-d402-474b-8c2d-fbc957e9d290/project

Request body

Field	Type	Required	Description
project_id	string (uuid)	Yes	The destination project. List projects and their ids with GET /projects.

Response

Field	Type	Description
id	string (uuid)	The design's id.
name	string	The design's name.
project_id	string (uuid)	The project the design is now in.

{
  "id": "64238d01-d402-474b-8c2d-fbc957e9d290",
  "name": "Summer sale",
  "project_id": "9d00e9fe-9bd5-4471-acad-baa702a867e9",
  "version": "v2026-10-20"
}

Errors

Status	id	When
400	missing_required	project_id is absent.
400	invalid_payload	project_id is not a UUID.
400	project_not_found	The project is not in your workspace, or is deleted.
404	template_not_found	No design GET /designs lists has this id — see below.

{
  "id": "project_not_found",
  "message": "Project UUID '9d00e9fe-9bd5-4471-acad-baa702a867e9' not found"
}

Which designs can be moved

Exactly the designs GET /designs lists. Anything else answers 404 template_not_found, the same as an id that never existed:

• a design that is already deleted;
• a design in a deleted project;
• a workspace template;
• another workspace's design.

A designId that is not a UUID does not match the route and answers 404 endpoint_not_found.

Related

• Projects — list or create the destination project
• Rename a Design — change a design's name
• Delete a Design — remove a design for good