POST
Projects.Save
Dashboard-compatible save: creates a project when project_id is empty/0, otherwise updates. Same fields as Projects.Add / Projects.Update.
Permissions
- User must be logged in with a valid bearer token.
- Returned or changed records are limited by the user permissions, team access, folder access, and account settings.
Action
- Updates the requested Projects record after validating permissions and input fields.
Push Service
No push is sent because this function only reads data or returns helper information.
Automation
No automation is run for this function.
Special Instructions
- Prefer Projects.Add / Projects.Update for explicit SDK calls; use Projects.Save to mirror the dashboard form submit.
Required Parameters
| Name | Type | Sample | Explanation |
|---|---|---|---|
project_namepost | string | Website redesign | Project name. Alias: name. |
Optional Parameters
| Name | Type | Sample | What it gives |
|---|---|---|---|
project_idpost | int | 0 | Empty/0 = add. Non-zero = update. Aliases: id, data_id. |
client_idpost | int | 12614595 | Customer id. |
organizations_userpost | mixed | [47] | Team member ids. |
credentialspost | string | | Credentials. |
notepost | string | | Note. |
private_projectpost | int | 0 | Private flag. |
Authentication
Send the bearer token returned by Login in the request header.
Authorization: Bearer YOUR TOKEN
Sample Request
{
"url": "\/app\/Projects.Save",
"method": "POST",
"headers": {
"Authorization": "Bearer YOUR TOKEN"
},
"body": {
"project_name": "Website redesign",
"client_id": "12614595"
},
"url_user": "https:\/\/{user}.bull36.com\/app\/Projects.Save",
"url_domain": "https:\/\/{domain}\/app\/Projects.Save"
}Endpoint
POST /app/Projects.Save
POST https://{user}.bull36.com/app/Projects.Save
POST https://{domain}/app/Projects.SaveSample Output
{
"success": 1,
"id": 900,
"project_id": 900
}JavaScript Example
const token = 'YOUR TOKEN';
const body = new URLSearchParams({ project_name: 'Website redesign', client_id: '12614595' });
const res = await fetch('/app/Projects.Save', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());Error Example
{
"success": 0,
"message": "Missing required parameter: project_name"
}