Projects API

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.

ResourceIdentifies
ProjectThe owning project and its resources.
BranchA working version of source.
ReleaseA recorded version of project content.
EnvironmentDeployment configuration and the selected release.

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.

API references