> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Projects"
description: "List the projects your credential can access and fetch a single project's metadata, workflow count, and production deployment."
last_verified: 2026-07-27
---


**Endpoints**: `GET /api/v1/projects`, `GET /api/v1/projects/:id`
**Auth**: `X-API-KEY` or `Authorization: Bearer <token>` (required)
**Error envelope**: 4xx/5xx return `{"error": string, "message": string, "code": int, "hint"?: string}`


A **project** is the top-level container for a workflow's code, environments, and deployments in AGNT5. Every other resource — deployments, workers, secrets, datasets — is scoped to a project. See [Authentication](/docs/api-reference/authentication.md) for how to supply a credential.

## Next steps

* [Environments](/docs/api-reference/environments.md): every project has local, preview, staging, and production environments
* [Deployments](/docs/api-reference/deployments.md): the running instances of a project's workflows
* [Secrets](/docs/api-reference/secrets.md): credentials scoped to a project and environment
* [Workers](/docs/api-reference/workers.md): the processes executing a project's workflows