Answer: Create an environment with POST /v1/environments, sending owner, name, repos, and environmentJson; update it with PATCH /v1/environments/{id}, which can rename it, replace its configuration, replace its repositories, or change build settings (build settings must be sent on their own). Status: Confirmed Entry: tool/cursor/agents-and-automation/manage-environments Revision: 3 Digest: sha256:7a149807e94a5372 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:09:52Z Last changed: 2026-11-19T12:30:53Z (Build settings rule: — → Send `buildSettings` on its own) Last verified: 2026-11-20T12:36:10Z Next check: 2026-11-21T12:36:10Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Create endpoint | /v1/environments | [1] | 2026-11-20 Create response status | 201 | [1] | 2026-11-20 Update endpoint | /v1/environments/{id} | [1] | 2026-11-20 Update response status | 204 | [1] | 2026-11-20 Required create fields | owner | [1] | 2026-11-20 Name max length | 255 characters | [1] | 2026-11-20 Max repositories | 500 repositories | [1] | 2026-11-20 Build settings rule | Send `buildSettings` on its own | [1] | 2026-11-20 Sources: [1] Anysphere. "cursor.com/docs/cloud-agent/api/endpoints.md". https://cursor.com/docs/cloud-agent/api/endpoints.md Role: primary. Accessed: 2026-11-20T12:36:10Z Quote: "`/v1/environments` Create a saved environment." (Supports: Create endpoint) Quote: "The response is `201` with the new environment." (Supports: Create response status) Quote: "PATCH `/v1/environments/{id}`" (Supports: Update endpoint) Quote: "The response is `204` with no body." (Supports: Update response status) Quote: "`owner` string (required)" (Supports: Required create fields) Quote: "Display name, up to 255 characters." (Supports: Name max length) Quote: "Maximum 500 repositories." (Supports: Max repositories) Quote: "Send `buildSettings` on its own, because a request that also sends `name`, `environmentJson`, or `repos` returns `400 validation_error`." (Supports: Build settings rule) Snapshot SHA-256: b95b6ed8e9b6a35f0562fb5dde8d31677b8fe30ec877ea45562cebc3ce565004 (captured 2026-11-20T12:36:07Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:36:10Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:36:10Z Last attempt: 2026-11-20T12:36:10Z Notes and limitations: Extracted automatically from a single official source (section "Environments"). Related: https://latestn.com/tool/cursor/agents-and-automation/manual-schedule-dispatch How do I dispatch a schedule manually in Cursor dev mode? https://latestn.com/tool/cursor/agents-and-automation/markdown-cron-schedules How do I create a scheduled task for a Cursor agent using a Markdown file with cron frontmatter? https://latestn.com/tool/cursor/agents-and-automation/mcp-connect-wait-behavior Which Cursor Agent SDK turns wait for an MCP Connect prompt and which don't? https://latestn.com/tool/cursor/agents-and-automation/lock-kept-wins How do I lock every kept win in Cursor hillclimbing? https://latestn.com/tool/cursor/agents-and-automation/machine-selection How does Cursor decide which My Machines worker runs a request, and when can a worker= request fail? https://latestn.com/tool/cursor/agents-and-automation/manage-cloud-agent-builds How do I trigger or manage a Cloud Agent Build in Cursor? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T12:30:53Z | changed | Build settings rule: — → Send `buildSettings` on its own | [1] 2026-11-19T12:30:53Z | changed | Update response status: — → 204 | [1] 2026-11-19T12:30:53Z | changed | Create response status: — → 201 | [1] 2026-11-19T12:30:53Z | changed | Build settings request rule: 400 validation_error → — | [1] 2026-11-19T12:30:53Z | changed | Max repositories: 500 → 500 repositories | [1] 2026-11-19T12:30:53Z | changed | Name max length: 255 → 255 characters | [1] 2026-11-19T12:30:53Z | changed | Update response: 204 → — | [1] 2026-11-19T12:30:53Z | changed | Create method: POST → — | [1] 2026-11-15T12:37:55Z | changed | Build settings request rule: — → 400 validation_error | [1] 2026-11-15T12:37:55Z | changed | Max repositories: — → 500 | [1] 2026-11-15T12:37:55Z | changed | Name max length: — → 255 | [1] 2026-11-15T12:37:55Z | changed | Required create fields: — → owner | [1] 2026-11-15T12:37:55Z | changed | Update response: — → 204 | [1] 2026-11-15T12:37:55Z | changed | Update endpoint: — → /v1/environments/{id} | [1] 2026-11-15T12:37:55Z | changed | Create method: — → POST | [1] 2026-11-15T12:37:55Z | changed | Create endpoint: — → /v1/environments | [1] 2026-11-15T12:37:55Z | changed | name max length: 255 → — | [1] 2026-11-15T12:37:55Z | changed | max repositories: 500 → — | [1] 2026-11-15T12:37:55Z | changed | required create field: environmentJson → — | [1] 2026-11-15T12:37:55Z | changed | update response: 204 → — | [1] 2026-11-15T12:37:55Z | changed | update method: PATCH → — | [1] 2026-11-15T12:37:55Z | changed | update endpoint: /v1/environments/{id} → — | [1] 2026-11-15T12:37:55Z | changed | create method: POST → — | [1] 2026-11-15T12:37:55Z | changed | create endpoint: /v1/environments → — | [1] 2026-11-13T03:09:52Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/cursor/agents-and-automation/manage-environments/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/cursor/agents-and-automation/manage-environments POST: https://latestn.com/dispute/tool/cursor/agents-and-automation/manage-environments with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/cursor/agents-and-automation/manage-environments?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I create and update an environment for Cursor cloud agents? Revision 3, last verified 2026-11-20T12:36:10Z. https://latestn.com/tool/cursor/agents-and-automation/manage-environments (accessed 2026-11-21T10:03:27Z). @misc{LatestN_tool_cursor_agents_and_automation_manage_environments_r3, title = {How do I create and update an environment for Cursor cloud agents?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/cursor/agents-and-automation/manage-environments}}, note = {Revision 3; digest sha256:7a149807e94a5372; last verified 2026-11-20T12:36:10Z; accessed 2026-11-21T10:03:27Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/cursor/agents-and-automation/manage-environments