feat: added project api spec for list and patch

[wim07101993]

Summary

• Added POST /projects/query and PATCH /projects/{id} endpoints
• Updated request/response models for project endpoints

Validation

• go generate ./...
• go test ./...
• go test -tags postgres_integration ./...
• openapi lint ./openapi/openapi-spec.yaml

Release notes / changeset

• Changeset: .changeset/add-get-patch-project-endpoints.md - Added GET /projects and PATCH /projects/{id} endpoints

Notes

• Issue: Project API A: API contract (OpenAPI) #406

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nextgen	Ready	Preview, Comment	Jul 9, 2026 3:31pm
nextgen-docs	Ready	Preview, Comment	Jul 9, 2026 3:31pm
nextgen-mock-zitadel	Ready	Preview, Comment	Jul 9, 2026 3:31pm

[vercel]

@wim07101993 must be a member of the zitadel team on Vercel to deploy.
- Click here to add @wim07101993 to the team.
- If you initiated this build, request access.
- If you're already a member of the zitadel team, make sure that your Vercel account is connected to your GitHub account.

Learn more about collaboration on Vercel and other options here.

[github-actions]

🦋 Changeset detected

Latest commit: 73744a6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 19 packages

Name	Type
@zitadel/server	Minor
@zitadel/cli	Minor
@zitadel/server-linux-x64	Minor
@zitadel/server-linux-arm64	Minor
@zitadel/server-darwin-x64	Minor
@zitadel/server-darwin-arm64	Minor
@zitadel/server-win32-x64	Minor
@zitadel/api	Minor
@zitadel/config	Minor
@zitadel/components	Minor
@zitadel/sdk-core	Minor
@zitadel/sdk-next	Minor
@zitadel/sdk-nuxt	Minor
@zitadel/sdk-react	Minor
@zitadel/sdk-vue	Minor
@zitadel/sdk-angular	Minor
@zitadel/sdk-solid	Minor
@zitadel/sdk-svelte	Minor
@zitadel/sdk-qwik	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull request overview

This PR extends the Project API OpenAPI contract to include project listing and partial updates, and regenerates the Go OpenAPI types/handlers to match.

Changes:

• Added GET /projects (cursor-pagination scaffolding via limit + page_token) and PATCH /projects/{project_id} to the OpenAPI spec.
• Updated project request/response schemas to include name, and introduced a list-projects-response schema.
• Regenerated api/generated/* to include the new operations, parameters, schemas, and encoders/decoders; added a changeset for @zitadel/server.

Reviewed changes

Copilot reviewed 9 out of 25 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
api/openapi/security/oauth2.yaml	Adds project-related OAuth2 scopes (needs consistent naming with endpoint security).
api/openapi/endpoints/projects/methods.yaml	Adds GET /projects operation with pagination parameters and responses.
api/openapi/endpoints/projects/list-projects-response.yaml	Defines paginated list response shape for projects.
api/openapi/endpoints/projects/get-project-response.yaml	Extends project read model with name and previewOrigins.
api/openapi/endpoints/projects/create-project-response.yaml	Extends create response to include name.
api/openapi/endpoints/projects/create-project-request.yaml	Extends create request to require name.
api/openapi/endpoints/projects/by_id/patch-project-request.yaml	Introduces PATCH request schema for project updates.
api/openapi/endpoints/projects/by_id/methods.yaml	Adds PATCH /projects/{project_id} operation definition.
api/generated/oas_validators_gen.go	Adds validators for newly generated request/response types.
api/generated/oas_unimplemented_gen.go	Adds unimplemented handler stubs for the new operations.
api/generated/oas_server_gen.go	Extends handler interface with ListProjects/PatchProject.
api/generated/oas_security_gen.go	Adds scope mappings for the new operations.
api/generated/oas_schemas_gen.go	Adds/updates generated schema types for projects and list/patch operations.
api/generated/oas_router_gen.go	Routes GET /projects and PATCH /projects/{project_id}.
api/generated/oas_response_encoders_gen.go	Adds encoders for list/patch operation responses.
api/generated/oas_response_decoders_gen.go	Adds decoders for list/patch operation responses.
api/generated/oas_request_encoders_gen.go	Adds request encoder for PatchProject.
api/generated/oas_request_decoders_gen.go	Adds request decoder for PatchProject.
api/generated/oas_parameters_gen.go	Adds query/path parameter decoding for ListProjects/PatchProject.
api/generated/oas_operations_gen.go	Registers the new operation names.
api/generated/oas_json_gen.go	Adds JSON encode/decode for new/updated project types.
api/generated/oas_interfaces_gen.go	Adds response interfaces for the new operations.
api/generated/oas_handlers_gen.go	Adds server handler wiring for ListProjects/PatchProject.
api/generated/oas_client_gen.go	Adds client methods for ListProjects/PatchProject.
.changeset/add-get-patch-project-endpoints.md	Declares a minor bump for @zitadel/server due to API surface changes.

[Copilot]

Pull request overview

Copilot reviewed 17 out of 34 changed files in this pull request and generated 10 comments.

[Copilot]

Pull request overview

Copilot reviewed 22 out of 39 changed files in this pull request and generated 7 comments.

[vercel]

@IAM-marco must be a member of the zitadel team on Vercel to deploy.
- Click here to add @IAM-marco to the team.
- If you initiated this build, request access.

Learn more about collaboration on Vercel and other options here.

[IAM-marco]

Looks extremely good 👍