A project is the starting point for any research initiative in Boses. When you begin a new campaign, product launch, or brand study, you create a project to hold all the assets and work that belong to it.
What’s inside a project
Projects contain four types of resources:
| Resource | Description |
|---|
| Persona groups | Demographic segments you want to test against (e.g. “Metro Manila millennials, mid-income”) |
| Personas | Individual AI consumers generated within each group |
| Briefings | Your stimulus material — product briefs, campaign concepts, or any supporting file |
| Simulations | Research studies run against a persona group, optionally using a briefing |
Scoping and access
Projects are scoped to your company account. Every team member in your organization can view and work with all projects. There is no per-project permission model — access is granted at the company level.
All API requests use your session token, which is tied to your company. You cannot access projects that belong to a different company.
Cascading delete
Deleting a project is permanent and cascades to everything inside it. When you delete a project, Boses also deletes:
- All persona groups and the personas within them
- All briefings and their uploaded files
- All simulations and their results
There is no soft-delete or recovery option. Before deleting a project, confirm you no longer need any of the simulation results or personas it contains.
API examples
Create a project
curl -X POST https://api.temujintechnologies.com/api/v1/projects \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"name": "GlowUp Serum Launch PH",
"description": "Q3 concept testing for the new brightening serum targeting Metro Manila women 25-35."
}'
{
"id": "9b1c3e2a-4f7d-4a1b-8c6e-2d0f5a3b7e91",
"name": "GlowUp Serum Launch PH",
"description": "Q3 concept testing for the new brightening serum targeting Metro Manila women 25-35.",
"company_id": "a3f2d1c0-...",
"created_at": "2026-04-07T08:00:00Z",
"updated_at": "2026-04-07T08:00:00Z"
}
List projects
curl https://api.temujintechnologies.com/api/v1/projects \
-H "Authorization: Bearer <TOKEN>"
[
{
"id": "9b1c3e2a-4f7d-4a1b-8c6e-2d0f5a3b7e91",
"name": "GlowUp Serum Launch PH",
"description": "Q3 concept testing for the new brightening serum targeting Metro Manila women 25-35.",
"created_at": "2026-04-07T08:00:00Z",
"updated_at": "2026-04-07T08:00:00Z"
}
]
Get a project
curl https://api.temujintechnologies.com/api/v1/projects/9b1c3e2a-4f7d-4a1b-8c6e-2d0f5a3b7e91 \
-H "Authorization: Bearer <TOKEN>"
Update a project
curl -X PATCH https://api.temujintechnologies.com/api/v1/projects/9b1c3e2a-4f7d-4a1b-8c6e-2d0f5a3b7e91 \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"name": "GlowUp Serum Launch PH — Wave 2",
"description": "Updated to include Wave 2 with a revised price point."
}'
Delete a project
curl -X DELETE https://api.temujintechnologies.com/api/v1/projects/9b1c3e2a-4f7d-4a1b-8c6e-2d0f5a3b7e91 \
-H "Authorization: Bearer <TOKEN>"
204 No Content. All persona groups, personas, briefings, and simulations inside the project are permanently removed.
Working with a project
Create a project
Name the project after your research initiative. The description is optional but helps orient team members who join later.
Create a persona group
Define the demographic segment you want to test against. You can describe it in natural language and Boses will parse it into structured fields.
Generate personas
Trigger persona generation. Boses builds 5 (or more) individual AI consumers grounded in real market signals for your target country.
Upload a briefing
Add your stimulus — a product brief, campaign deck, or plain-text concept. Boses extracts the text automatically.
Run simulations
Choose a research method and start your simulation. Results are available once the run completes.
