Change a project
Changes a project’s name, description, instructions, status or the account’s pin. Send only what changes. Pinning is allowed to any member; the rest needs the editor role.
Requires the projects:write permission.
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer jb_live_…
Path Parameters
The project id.
Body
Send only the fields to change. Everything except is_pinned needs the editor role.
Response
The project.
The project id.
The name.
The project's status. New projects are active.
The owner's account id.
What the project is for.
The project picture.
Seed for the generated picture.
Whether this account pinned it. Pins are personal.
Instructions the agent follows in every chat of the project.
When it was made.
When it last changed.
Tasks in the project.
Tasks completed.
This account's chats in the project.
Files held.
Secrets held. Their names and values are not available here.
Apps in the project.
Automations in the project.
This account's role.
owner, editor, viewer, null People in the project.
A few members, oldest first.