Appwrite

appwrite-rest-v1restprimary

86% coverage

Offload Valuejudged · weight 15 · Oct 5, 2026

This is a managed database CRUD API: create databases, collections, attributes, indexes, and documents. The agent must still decide schema, write queries, and interpret results — no domain logic, no proprietary data, no inference-replacing computation. The only genuine offloads beyond storage are durable persistence, indexed querying, transactions, and atomic increment/decrement operations, which do provide real server-side side effects and avoid read-modify-write reasoning, but remain generic infrastructure convenience rather than token-saving cognition.

• https://appwrite.io/docs/references/cloud/server-rest/databases

  Increment document attribute patch /databases/{databaseId}/collections/{collectionId}/documents/{documentId}/{attribute}/increment

• https://appwrite.io/docs/references/cloud/server-rest/databases

  Create document post /databases/{databaseId}/collections/{collectionId}/documents

• https://appwrite.io/docs/references/cloud/server-rest/databases

  Create document post /databases/{databaseId}/collections/{collectionId}/documents

Interaction Costmeasured · weight 15 · Oct 5, 2026

Median over 2 successful run(s): 41322 tokens, 7.5 calls. Ratio to the best in "backend-database" (4 surfaces measured, v0.2 scale). Cold, without documentation: 1/1 succeeded.

Error Recoverabilityprobed · weight 15 · Oct 5, 2026

unknown_endpoint → HTTP 404, clarity 55/100 (field named: yes, allowed values: no, RFC 9457: no) · wrong_type → HTTP 400, clarity 50/100 (field named: no, allowed values: yes, RFC 9457: no) · hallucinated_enum → HTTP 400, clarity 50/100 (field named: no, allowed values: yes, RFC 9457: no) · unknown_field → HTTP 200, clarity 0/100 (field named: no, allowed values: no, RFC 9457: no)

• https://fra.cloud.appwrite.io/v1/databases

  HTTP 401: {"message":"User (role: guests) missing scopes ([\"databases.read\"])","code":401,"type":"general_unauthorized_scope","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases/nonexistent_resource_xyz

  HTTP 404: {"message":"Database with the requested ID 'nonexistent_resource_xyz' could not be found.","code":404,"type":"database_not_found","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=not_a_query

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=orderAsc(%22nonexistent_field%22)

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

Doc Legibilitymeasured · weight 12 · Oct 5, 2026

text/markup ratio 1.7% (weight 30) · rendering without JavaScript undetermined (excluded from the calculation) (weight 25) · machine-readable spec: none found (weight 25) · llms.txt: https://appwrite.io/llms.txt (weight 10) · 0 runnable example(s) (weight 10). Weighted average over 75 points of available sub-criteria.

• https://appwrite.io/docs/references/cloud/server-rest/databases
• https://appwrite.io/llms.txt

Auth Frictionmeasured · weight 10 · Oct 5, 2026

Dedicated X-Appwrite-Key header, verified by a successful call. 1 mandatory header(s) besides the key: an agent holding only the secret fails, and nothing in the response tells it why.

• https://fra.cloud.appwrite.io/v1/databases

  HTTP 401: {"message":"User (role: guests) missing scopes ([\"databases.read\"])","code":401,"type":"general_unauthorized_scope","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases/nonexistent_resource_xyz

  HTTP 404: {"message":"Database with the requested ID 'nonexistent_resource_xyz' could not be found.","code":404,"type":"database_not_found","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=not_a_query

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=orderAsc(%22nonexistent_field%22)

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

Safety & Reversibilityprobed · weight 10

If I retry after a timeout, do I charge the customer twice?

Payload Efficiencyprobed · weight 8 · Oct 5, 2026

No discoverable field selection (tested fields, select, _fields, expand, properties): the agent swallows the whole resource. (weight 35) · No cursor pagination marker in the response. (weight 20) · Nested envelope or non-list shape. (weight 10) · No ETag. (Compression is not measurable: the runtime decompresses it and strips the header.) (weight 10). Weighted average over 75 points of measured sub-criteria.

• https://fra.cloud.appwrite.io/v1/databases

  HTTP 401: {"message":"User (role: guests) missing scopes ([\"databases.read\"])","code":401,"type":"general_unauthorized_scope","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases/nonexistent_resource_xyz

  HTTP 404: {"message":"Database with the requested ID 'nonexistent_resource_xyz' could not be found.","code":404,"type":"database_not_found","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=not_a_query

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

• https://fra.cloud.appwrite.io/v1/databases?queries%5B%5D=orderAsc(%22nonexistent_field%22)

  HTTP 400: {"message":"Invalid `queries` param: Invalid query: Invalid query: Syntax error","code":400,"type":"general_argument_invalid","version":"2.3.0"}

Task Atomicitymeasured · weight 6 · Oct 5, 2026

Median over 2 successful run(s): 41322 tokens, 7.5 calls. Ratio to the best in "backend-database" (4 surfaces measured, v0.2 scale). Cold, without documentation: 1/1 succeeded.

Prior Knowledge Coveragemeasured · weight 5 · Oct 5, 2026

Median over 2 successful run(s): 41322 tokens, 7.5 calls. Ratio to the best in "backend-database" (4 surfaces measured, v0.2 scale). Cold, without documentation: 1/1 succeeded.

Async Compatibilityprobed · weight 2

If the operation is asynchronous, can I get the result without hosting a web server?

Tool-Native (MCP)binary · weight 2

Does the vendor publish an official, maintained MCP server?