Projects
Projects and Project IDs (cbp_): creating, renaming and deleting them.
- Can I move a bucket to another project?There's no move endpoint. Create a bucket in the other project, copy the files over, then delete the old bucket.FAQ
- Can I transfer a project to another Clatter Labs account?There's no transfer feature. The other account can create its own project and upload copies of the files.FAQ
- How do agencies organize client work in Code Buckets?Use one project per client, a bucket per deliverable, a public bucket for shareable assets, and clear names and descriptions.How-to
- How do I create a project with the API?Create a project in the Console with a name, or with POST /v1/projects. You get a Project ID (cbp_) back.How-to
- How do I delete a project with the API?A project can be deleted once it has no buckets. Delete its buckets first, then the project, in the Console or with the API.How-to
- How do I find a project's ID if I only know its name?List projects with GET /v1/projects and match on name, or open the project in the Console and copy its ID.How-to
- How do I rename a project or change its description?Use PATCH /v1/projects/{project_id} with a new name or description. The Project ID stays the same.How-to
- How do I see everything that happened in a project?GET /v1/projects/{project_id}/events returns project changes plus every event in its buckets, newest first. The Console shows the same feed.How-to
- How many buckets can a project hold?Up to 100 buckets per project. Creating more answers 409 limit_reached.FAQ
- How should I organize my projects and buckets?A project per app, client or product; a bucket per part, environment or kind of content. Here are patterns that work.How-to
- I get 409 limit_reached when creating a project. What now?An account can have up to 100 projects. Delete projects you no longer need, or group more buckets into existing projects.Troubleshooting
- I get 409 project_not_empty when deleting a project. Why?Projects can only be deleted when they have no buckets. Delete the project's buckets first, then try again.Troubleshooting
- What are the rules for project names and descriptions?Project names are up to 80 characters and descriptions up to 500. The Project ID, not the name, identifies the project.Reference
- What is a project in Code Buckets?A project groups related buckets, like an app, a client or a monorepo. Each has a permanent Project ID starting with cbp_.Explainer
- Where do I find my Project ID?The Console shows the Project ID with a copy button on the project page. The API returns it as id when you create or list projects.How-to
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.