Skip to content

feat: API specs update for version latest - #103

Merged
ChiragAgg5k merged 1 commit into
mainfrom
feat-latest-specs
Sep 6, 2026
Merged

feat: API specs update for version latest#103
ChiragAgg5k merged 1 commit into
mainfrom
feat-latest-specs

Conversation

@appwrite-specifications

Copy link
Copy Markdown
Contributor

This PR contains API specification updates for version latest.

@greptile-apps

greptile-apps Bot commented Sep 6, 2026

Copy link
Copy Markdown

Greptile Summary

This PR refreshes the three latest OpenAPI projections by removing obsolete operation metadata, adding effective method-level platform availability, adjusting platform exposure, and extending the console specification with domain-pricing and usage-related contracts.

  • Adds the console-only domain price listing endpoint and response models.
  • Adds platform metadata to renamed or alternate SDK methods.
  • Updates presence, OAuth, usage-dimension, deprecation, and aggregation metadata.
  • Contains three non-blocking schema-quality issues in the new domain-pricing contract.

Confidence Score: 4/5

The PR appears safe to merge, with non-blocking corrections recommended for the new domain-pricing schema.

The API projections remain structurally coherent and their new references resolve, but the console pricing contract does not machine-encode two documented input limits and includes an example whose value conflicts with its declared array type.

Files Needing Attention: specs/latest/open-api3-latest-console.json

Important Files Changed

Filename Overview
specs/latest/open-api3-latest-client.json Removes obsolete extension metadata and adds effective platform annotations, including split presence-method availability.
specs/latest/open-api3-latest-console.json Refreshes console API metadata and adds domain-pricing and usage contracts; the new pricing endpoint omits two declared constraints and has a type-invalid response example.
specs/latest/open-api3-latest-server.json Removes obsolete extension metadata and adds server-specific method platform annotations while preserving server presence methods.

Fix all with Greploop Fix All in Claude Code Fix All in Codex

Prompt To Fix All With AI
### Issue 1
specs/latest/open-api3-latest-console.json:29832-29837
**Domain Limit Not Enforced**

The description limits requests to 50 domains, but the array schema has no `maxItems: 50`. Schema-driven clients and validators therefore accept requests that the endpoint contract says are invalid. Add the limit so the machine-readable schema matches the documented API.

### Issue 2
specs/latest/open-api3-latest-console.json:29844-29847
**Minimum Period Not Enforced**

The description requires `periodYears` to be at least 1, but the schema has no `minimum`. This leaves zero and negative values valid according to the machine-readable contract. Add `minimum: 1` so generated validation and documentation reflect the actual requirement.

### Issue 3
specs/latest/open-api3-latest-console.json:140429-140432
**Prices Example Has Wrong Type**

The new example assigns an empty string to `prices`, although `prices` is a required array of `domainPrice` objects. This creates a type-invalid example for generated documentation and other tooling that consumes schema examples.

```suggestion
                "example": {
                    "total": 5,
                    "prices": []
                }
```

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Reviews (1): Last reviewed commit: "chore: update latest API specs for effec..." | Re-trigger Greptile

Comment on lines +29832 to +29837
"schema": {
"type": "array",
"items": {
"type": "string"
}
},

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Domain Limit Not Enforced

The description limits requests to 50 domains, but the array schema has no maxItems: 50. Schema-driven clients and validators therefore accept requests that the endpoint contract says are invalid. Add the limit so the machine-readable schema matches the documented API.

Prompt To Fix With AI
This is a comment left during a code review.
Path: specs/latest/open-api3-latest-console.json
Line: 29832-29837

Comment:
**Domain Limit Not Enforced**

The description limits requests to 50 domains, but the array schema has no `maxItems: 50`. Schema-driven clients and validators therefore accept requests that the endpoint contract says are invalid. Add the limit so the machine-readable schema matches the documented API.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Fix in Claude Code Fix in Codex

Comment on lines +29844 to +29847
"schema": {
"type": "integer",
"format": "uint32",
"default": 1

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Minimum Period Not Enforced

The description requires periodYears to be at least 1, but the schema has no minimum. This leaves zero and negative values valid according to the machine-readable contract. Add minimum: 1 so generated validation and documentation reflect the actual requirement.

Prompt To Fix With AI
This is a comment left during a code review.
Path: specs/latest/open-api3-latest-console.json
Line: 29844-29847

Comment:
**Minimum Period Not Enforced**

The description requires `periodYears` to be at least 1, but the schema has no `minimum`. This leaves zero and negative values valid according to the machine-readable contract. Add `minimum: 1` so generated validation and documentation reflect the actual requirement.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Fix in Claude Code Fix in Codex

Comment on lines +140429 to +140432
"example": {
"total": 5,
"prices": ""
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Prices Example Has Wrong Type

The new example assigns an empty string to prices, although prices is a required array of domainPrice objects. This creates a type-invalid example for generated documentation and other tooling that consumes schema examples.

Suggested change
"example": {
"total": 5,
"prices": ""
}
"example": {
"total": 5,
"prices": []
}
Prompt To Fix With AI
This is a comment left during a code review.
Path: specs/latest/open-api3-latest-console.json
Line: 140429-140432

Comment:
**Prices Example Has Wrong Type**

The new example assigns an empty string to `prices`, although `prices` is a required array of `domainPrice` objects. This creates a type-invalid example for generated documentation and other tooling that consumes schema examples.

```suggestion
                "example": {
                    "total": 5,
                    "prices": []
                }
```

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Claude Code Fix in Codex

@ChiragAgg5k
ChiragAgg5k merged commit e6c8038 into main Sep 6, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant