The Projects API manages projects and their source content. A project groups application code, agent definitions, integrations, and execution history under an ownership and access boundary.
Source and branches
Project files contain application code and definitions. Branches keep alternate source versions so changes can be reviewed before merging.
Approvals, status checks, and branch policies determine merge eligibility. File revisions and update preconditions help clients detect changes made since a previous read.
Releases and environments
File reads can address a branch, release, or deployed environment. Each selector identifies a different view of the source. Their identifiers are not interchangeable.
The Deployment API creates releases and connects them to environments. Project file operations inspect the content associated with those versions.
Source and execution targets
The source selector determines which version a read or edit addresses. The execution target determines where work runs. An agent definition can be read from one source target while its run is assigned an explicit runtime target.
Check both when investigating unexpected behavior. A branch ID, environment ID, and release version refer to different resources even when they resolve to similar content.
Uploads and generated assets
Uploads store files independently of project source. They have their own paths, visibility, permissions, and download URLs. Generated images use the same upload lifecycle.
Dependency operations resolve project packages. Style artifacts record generated CSS.
A review branch can hold agent code while uploaded attachments remain separate assets. Updating a source file does not replace an upload or an earlier run's history.
Access and collaboration
Project ownership and membership determine which resources a caller can manage. The Identity and Access API manages memberships and invitations. Labels and favorites organize projects. Favorites do not grant access.
Get started
Configure a project to establish its environment, or manage project files with update preconditions.