---
title: "Changes to Find a project by id or name"
method: GET
path: "/v9/projects/{idOrName}"
---

# Changes to Find a project by id or name

`GET /v9/projects/{idOrName}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 60 of 137 revisions.

- **2026-10-23** `2060b55dc517`: 1 breaking
- **2026-10-22** `6c0e780b096e`: 3 info
- **2026-10-20** `6a3a421e252e`: 1 warning, 1 info
- **2026-10-19** `ced8fa5fed21`: 1 info
- **2026-10-19** `b4c010d0e737`: 1 info
- **2026-10-16** `bdab3c0b548a`: 1 warning
- **2026-10-12** `fcd86973fab2`: 1 info
- **2026-10-08** `f5c63f03ee0c`: 1 info
- **2026-10-08** `b426de1e3932`: 1 info
- **2026-10-07** `24be175f4966`: 1 warning, 1 info
- **2026-10-06** `d8abdc297e36`: 1 info
- **2026-10-03** `2c463a1d98b1`: 1 warning
- **2026-10-02** `41e24ae097d4`: 1 breaking, 2 info
- **2026-09-30** `6f68095b42b1`: 1 info
- **2026-09-30** `099fbe1f521c`: 1 info
- **2026-09-29** `8ef4901ffe83`: 1 breaking, 3 info
- **2026-09-26** `9688d14fb03a`: 3 info
- **2026-09-23** `c8d11c5d2271`: 3 info
- **2026-09-22** `4f8704cf40ba`: 4 info
- **2026-09-18** `c32b8afee578`: 2 warning, 2 info
- **2026-09-17** `10dff3be52ff`: 2 info
- **2026-09-16** `d1cd8167595b`: 3 info
- **2026-09-11** `9e5d117397aa`: 1 info
- **2026-09-11** `83dbc1a3d2a1`: 1 breaking, 1 warning, 1 info
- **2026-09-10** `a5ba4ada31fd`: 1 warning, 1 info
- **2026-09-09** `a03023a2d43f`: 1 info
- **2026-09-08** `4b774da66d3d`: 1 breaking
- **2026-09-03** `7c947faac0ef`: 2 warning
- **2026-09-02** `284e10c18f4d`: 1 info
- **2026-08-31** `e31ea8d3c1e7`: 2 info
- **2026-08-28** `cea4418b1cd8`: 30 warning
- **2026-08-26** `279c61d463bf`: 1 breaking, 1 info
- **2026-08-25** `b3ee1929bdbf`: 2 warning
- **2026-08-20** `b4b4b597ab64`: 2 info
- **2026-08-19** `339d55de6905`: 3 info
- **2026-08-19** `6b6e0450635c`: 2 warning, 1 info
- **2026-08-14** `fb586c83eba8`: 3 breaking
- **2026-08-13** `6ed5b7605027`: 1 info
- **2026-08-08** `61d1ba3f6dac`: 2 info
- **2026-08-07** `b4d86a3e3479`: 1 info
- **2026-08-06** `b8027f4efeda`: 1 info
- **2026-08-04** `ed45a5c919e5`: 1 breaking
- **2026-08-04** `0b0420c2223a`: 1 warning, 1 info
- **2026-07-31** `e20468c66692`: 4 warning, 4 info
- **2026-07-26** `01c71864fa50`: 2 info
- **2026-07-21** `2ae10ee9d21c`: 1 breaking, 4 info
- **2026-07-12** `c78b02d1ab19`: 2 warning, 2 info
- **2026-07-09** `5cd7769cab33`: 3 info
- **2026-07-08** `3ff660568354`: 1 breaking, 24 warning, 44 info
- **2026-06-22** `7bd30e62d868`: 5 warning, 3 info
- **2026-06-11** `14b4658f819e`: 3 breaking, 16 warning, 67 info
- **2026-02-10** `486a07653d6e`: 1 warning, 2 info
- **2026-02-02** `5264f094c3d3`: 3 warning, 1 info
- **2026-01-22** `c12186034433`: 5 breaking, 164 warning, 36 info
- **2025-11-28** `45991e5c8b6d`: 1 breaking, 6 warning, 14 info
- **2025-10-09** `50caddad4ae7`: 3 breaking, 14 warning, 39 info
- **2025-05-17** `67f6a93c3cd8`: 6 breaking, 2 warning, 17 info
- **2025-04-22** `661a2f6357c1`: 5 info
- **2025-03-19** `37b482c58c92`: 10 breaking, 25 warning, 281 info
- **2022-12-06** `8eb562567170`: 1 info

## Changes

- **2026-10-23** `2060b55dc517`: 1 breaking
  - added `subschema #2` to the `creator` response property `oneOf` list for the response status `200`
- **2026-10-22** `6c0e780b096e`: 3 info
  - added the optional property `permissions/messageboardMessage` to the response with the `200` status
  - added the optional property `permissions/messageboardModeration` to the response with the `200` status
  - added the optional property `permissions/messageboardReaction` to the response with the `200` status
- **2026-10-20** `6a3a421e252e`: 1 warning, 1 info
  - removed the optional property `permissions/messageboardSpace` from the response with the `200` status
  - added the optional property `permissions/messageboardChannel` to the response with the `200` status
- **2026-10-19** `ced8fa5fed21`: 1 info
  - added the optional property `permissions/githubUsage` to the response with the `200` status
- **2026-10-19** `b4c010d0e737`: 1 info
  - added the optional property `permissions/connexClientAccess` to the response with the `200` status
- **2026-10-16** `bdab3c0b548a`: 1 warning
  - added the new `26.x` enum value to the `nodeVersion` response property for the response status `200`
- **2026-10-12** `fcd86973fab2`: 1 info
  - added the required property `passwordProtection/deploymentType` to the response with the `200` status
- **2026-10-08** `f5c63f03ee0c`: 1 info
  - added the optional property `resourceConfig/elasticBuildMachine` to the response with the `200` status
- **2026-10-08** `b426de1e3932`: 1 info
  - added the optional property `defaultResourceConfig/elasticBuildMachine` to the response with the `200` status
- **2026-10-07** `24be175f4966`: 1 warning, 1 info
  - removed the optional property `rollingRelease/gate/checks/items/minSampleSize` from the response with the `200` status
  - added the optional property `rollingRelease/gate/checks/items/significanceLevel` to the response with the `200` status
- **2026-10-06** `d8abdc297e36`: 1 info
  - added the optional property `avatarDarkMode` to the response with the `200` status
- **2026-10-03** `2c463a1d98b1`: 1 warning
  - removed the optional property `abuse` from the response with the `200` status
- **2026-10-02** `41e24ae097d4`: 1 breaking, 2 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
  - added the optional property `abuse/block/abuseAgentRunId` to the response with the `200` status
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
- **2026-09-30** `6f68095b42b1`: 1 info
  - added the optional property `jobs/flag-definitions-present` to the response with the `200` status
- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-09-29** `8ef4901ffe83`: 1 breaking, 3 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
  - added the optional property `abuse/block/threadId` to the response with the `200` status
  - added the optional property `abuse/interstitialHistory/items/threadId` to the response with the `200` status
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
- **2026-09-26** `9688d14fb03a`: 3 info
  - added the optional property `permissions/messageboard` to the response with the `200` status
  - added the optional property `permissions/messageboardSpace` to the response with the `200` status
  - added the optional property `permissions/messageboardTask` to the response with the `200` status
- **2026-09-23** `c8d11c5d2271`: 3 info
  - added the optional property `alias/items/deployment/oidcTokenClaims/deployment_id` to the response with the `200` status
  - added the optional property `latestDeployments/items/oidcTokenClaims/deployment_id` to the response with the `200` status
  - added the optional property `targets/additionalProperties/oidcTokenClaims/deployment_id` to the response with the `200` status
- **2026-09-22** `4f8704cf40ba`: 4 info
  - added the optional property `abuse/block/registeredShaBlock` to the response with the `200` status
  - added the optional property `abuse/blockHistory/items/oneOf[subschema #1]/registeredShaBlock` to the response with the `200` status
  - added the optional property `defaultResourceConfig/buildMachineElasticTransition` to the response with the `200` status
  - added the optional property `resourceConfig/buildMachineElasticTransition` to the response with the `200` status
- **2026-09-18** `c32b8afee578`: 2 warning, 2 info
  - removed the optional property `security/securityPlus` from the response with the `200` status
  - removed the optional property `security/securityPlusMetadata` from the response with the `200` status
  - removed the `advanced` enum value from the `tier` response property for the response status `200`
  - removed the `critical` enum value from the `tier` response property for the response status `200`
- **2026-09-17** `10dff3be52ff`: 2 info
  - added the optional property `permissions/deploymentProtectionException` to the response with the `200` status
  - added the optional property `permissions/schedule` to the response with the `200` status
- **2026-09-16** `d1cd8167595b`: 3 info
  - added the optional property `permissions/gitCredentialGrant` to the response with the `200` status
  - added the optional property `permissions/projectSetting` to the response with the `200` status
  - added the optional property `permissions/setting` to the response with the `200` status
- **2026-09-11** `9e5d117397aa`: 1 info
  - added the optional property `trustedSources/enableVercelCiSameRepository` to the response with the `200` status
- **2026-09-11** `83dbc1a3d2a1`: 1 breaking, 1 warning, 1 info
  - added `subschema #6, subschema #7` to the `link` response property `oneOf` list for the response status `200`
  - added the new `advanced` enum value to the `tier` response property for the response status `200`
  - removed `subschema #6, subschema #7` from the `link` response property `oneOf` list for the response status `200`
- **2026-09-10** `a5ba4ada31fd`: 1 warning, 1 info
  - added the new `priority` enum value to the `tier` response property for the response status `200`
  - removed the `advanced` enum value from the `tier` response property for the response status `200`
- **2026-09-09** `a03023a2d43f`: 1 info
  - added the optional property `permissions/automation` to the response with the `200` status
- **2026-09-08** `4b774da66d3d`: 1 breaking
  - added `subschema #7` to the `link` response property `oneOf` list for the response status `200`
- **2026-09-03** `7c947faac0ef`: 2 warning
  - added the new `factory-eve` enum value to the `framework` response property for the response status `200`
  - added the new `factory-eve` enum value to the `services/items/framework` response property for the response status `200`
- **2026-09-02** `284e10c18f4d`: 1 info
  - added the optional property `permissions/projectTransferRequest` to the response with the `200` status
- **2026-08-31** `e31ea8d3c1e7`: 2 info
  - added the optional property `permissions/aiGatewayTranscripts` to the response with the `200` status
  - added the optional property `permissions/aiGatewayTranscriptsSettings` to the response with the `200` status
- **2026-08-28** `cea4418b1cd8`: 30 warning
  - added the new `arn1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `arn1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `bom1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `bom1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `cpt1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `cpt1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `dub1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `dub1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `fra1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `fra1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `gru1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `gru1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `hkg1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `hkg1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `hnd1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `hnd1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `icn1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `icn1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `kix1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `kix1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `lhr1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `lhr1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `pdx1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `pdx1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `sin1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `sin1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `syd1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `syd1` enum value to the `sandbox/region` response property for the response status `200`
  - added the new `yul1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `yul1` enum value to the `sandbox/region` response property for the response status `200`
- **2026-08-26** `279c61d463bf`: 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `creator` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `creator` response property `oneOf` list for the response status `200`
- **2026-08-25** `b3ee1929bdbf`: 2 warning
  - added the new `advanced` enum value to the `tier` response property for the response status `200`
  - added the new `critical` enum value to the `tier` response property for the response status `200`
- **2026-08-20** `b4b4b597ab64`: 2 info
  - added the optional property `permissions/aiGatewayApiKeyBypassAll` to the response with the `200` status
  - added the optional property `speedInsights/dataReceivedAt` to the response with the `200` status
- **2026-08-19** `339d55de6905`: 3 info
  - added the optional property `permissions/productionShareableLink` to the response with the `200` status
  - added the optional property `permissions/shareableLink` to the response with the `200` status
  - added the optional property `permissions/vercelAuth` to the response with the `200` status
- **2026-08-19** `6b6e0450635c`: 2 warning, 1 info
  - added the new `cdg1` enum value to the `sandbox/failoverRegions/items/` response property for the response status `200`
  - added the new `cdg1` enum value to the `sandbox/region` response property for the response status `200`
  - added the optional property `permissions/connexContact` to the response with the `200` status
- **2026-08-14** `fb586c83eba8`: 3 breaking
  - the response property `alias/items/deployment/userId` became optional for the status `200`
  - the response property `latestDeployments/items/userId` became optional for the status `200`
  - the response property `targets/additionalProperties/userId` became optional for the status `200`
- **2026-08-13** `6ed5b7605027`: 1 info
  - added the optional property `permissions/workflowRunData` to the response with the `200` status
- **2026-08-08** `61d1ba3f6dac`: 2 info
  - added the optional property `permissions/aiGatewayVirtualModelConfigs` to the response with the `200` status
  - added the optional property `permissions/cursorOriginInstallation` to the response with the `200` status
- **2026-08-07** `b4d86a3e3479`: 1 info
  - added the optional property `rollingRelease/gate` to the response with the `200` status
- **2026-08-06** `b8027f4efeda`: 1 info
  - added the optional property `permissions/aiGatewayApiKeySpendAttribution` to the response with the `200` status
- **2026-08-04** `ed45a5c919e5`: 1 breaking
  - added `subschema #7` to the `link` response property `oneOf` list for the response status `200`
- **2026-08-04** `0b0420c2223a`: 1 warning, 1 info
  - removed the optional property `flatRateTier` from the response with the `200` status
  - added the optional property `permissions/aiGatewayApiKeyZdrExemption` to the response with the `200` status
- **2026-07-31** `e20468c66692`: 4 warning, 4 info
  - added the new `basic` enum value to the `defaultResourceConfig/buildMachineType` response property for the response status `200`
  - added the new `basic` enum value to the `resourceConfig/buildMachineType` response property for the response status `200`
  - added the new `basic-floor` enum value to the `defaultResourceConfig/buildMachineElasticReason` response property for the response status `200`
  - added the new `basic-floor` enum value to the `resourceConfig/buildMachineElasticReason` response property for the response status `200`
  - added the optional property `permissions/connectLogs` to the response with the `200` status
  - added the optional property `permissions/marketplaceFlexCommit` to the response with the `200` status
  - added the optional property `permissions/projectDomainVerify` to the response with the `200` status
  - added the optional property `sandbox` to the response with the `200` status
- **2026-07-26** `01c71864fa50`: 2 info
  - added the optional property `env/items/visibility` to the response with the `200` status
  - added the optional property `permissions/connexInstallation` to the response with the `200` status
- **2026-07-21** `2ae10ee9d21c`: 1 breaking, 4 info
  - added `subschema #3, subschema #4` to the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
  - added the non-success response with the status `410`
  - added the optional property `internalRoutes/items/oneOf[subschema #1]/expiry` to the response with the `200` status
  - added the optional property `security/rulesets` to the response with the `200` status
  - removed `subschema #3, subschema #4` from the `abuse/blockHistory/items/` response property `oneOf` list for the response status `200`
- **2026-07-12** `c78b02d1ab19`: 2 warning, 2 info
  - added the new `tanstack-start-lovable` enum value to the `framework` response property for the response status `200`
  - added the new `tanstack-start-lovable` enum value to the `services/items/framework` response property for the response status `200`
  - added the optional property `creator` to the response with the `200` status
  - added the optional property `permissions/aiGatewayBudget` to the response with the `200` status
- **2026-07-09** `5cd7769cab33`: 3 info
  - added the optional property `alias/items/deployment/oidcTokenClaims/mfe_group_ids` to the response with the `200` status
  - added the optional property `latestDeployments/items/oidcTokenClaims/mfe_group_ids` to the response with the `200` status
  - added the optional property `targets/additionalProperties/oidcTokenClaims/mfe_group_ids` to the response with the `200` status
- **2026-07-08** `3ff660568354`: 1 breaking, 24 warning, 44 info
  - `path` request parameter `idOrName` list-of-types was narrowed by removing types `boolean`
  - added the new `BLOCKED` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `BLOCKED` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `BUILDING` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `BUILDING` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `CANCELED` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `CANCELED` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `ERROR` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `ERROR` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `INITIALIZING` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `INITIALIZING` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `LAMBDAS` enum value to the `latestDeployments/items/type` response property for the response status `200`
  - added the new `LAMBDAS` enum value to the `targets/additionalProperties/type` response property for the response status `200`
  - added the new `QUEUED` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `QUEUED` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `READY` enum value to the `latestDeployments/items/readyState` response property for the response status `200`
  - added the new `READY` enum value to the `targets/additionalProperties/readyState` response property for the response status `200`
  - added the new `container` enum value to the `framework` response property for the response status `200`
  - added the new `container` enum value to the `services/items/framework` response property for the response status `200`
  - added the new `enterprise` enum value to the `latestDeployments/items/plan` response property for the response status `200`
  - added the new `enterprise` enum value to the `targets/additionalProperties/plan` response property for the response status `200`
  - added the new `hobby` enum value to the `latestDeployments/items/plan` response property for the response status `200`
  - added the new `hobby` enum value to the `targets/additionalProperties/plan` response property for the response status `200`
  - added the new `pro` enum value to the `latestDeployments/items/plan` response property for the response status `200`
  - added the new `pro` enum value to the `targets/additionalProperties/plan` response property for the response status `200`
  - for the `path` request parameter `idOrName`, the type was generalized from no type to `string`
  - added the optional property `blobs` to the response with the `200` status
  - added the optional property `defaultResourceConfig/buildMachineElasticReason` to the response with the `200` status
  - added the optional property `latestDeployments/items/aliasError` to the response with the `200` status
  - added the optional property `latestDeployments/items/aliasFinal` to the response with the `200` status
  - added the optional property `latestDeployments/items/automaticAliases` to the response with the `200` status
  - added the optional property `latestDeployments/items/branchMatcher` to the response with the `200` status
  - added the optional property `latestDeployments/items/buildingAt` to the response with the `200` status
  - added the optional property `latestDeployments/items/checksConclusion` to the response with the `200` status
  - added the optional property `latestDeployments/items/checksState` to the response with the `200` status
  - added the optional property `latestDeployments/items/connectBuildsEnabled` to the response with the `200` status
  - added the optional property `latestDeployments/items/connectConfigurationId` to the response with the `200` status
  - added the optional property `latestDeployments/items/deletedAt` to the response with the `200` status
  - added the optional property `latestDeployments/items/monorepoManager` to the response with the `200` status
  - added the optional property `latestDeployments/items/oidcTokenClaims` to the response with the `200` status
  - …29 more
- **2026-06-22** `7bd30e62d868`: 5 warning, 3 info
  - removed the optional property `publicSource` from the response with the `200` status
  - added the new `bun` enum value to the `framework` response property for the response status `200`
  - added the new `bun` enum value to the `services/items/framework` response property for the response status `200`
  - added the new `performance_xl` enum value to the `defaultResourceConfig/functionDefaultMemoryType` response property for the response status `200`
  - added the new `performance_xl` enum value to the `resourceConfig/functionDefaultMemoryType` response property for the response status `200`
  - added the optional property `permissions/aiGatewayRules` to the response with the `200` status
  - added the optional property `tracing/samplingRules/items/destination` to the response with the `200` status
  - added the required property `security/managedRules/traffic_sources` to the response with the `200` status
- …earlier changes are on the page: https://skmtc.dev/vercel/apis/api/changes/v9/projects/:idOrName/get

---

[Operation](https://skmtc.dev/vercel/apis/api/docs/v9/projects/:idOrName/get.md) - [API](https://skmtc.dev/vercel/apis/api.md) - [Page](https://skmtc.dev/vercel/apis/api/changes/v9/projects/:idOrName/get)
