SDK Troubleshooting
Editions: Open Source · Free Cloud · Pro · Workers
Unknown field / type on project API
Schema is still a draft, or codegen is stale. Publish in Console, then regenerate JS/Go/Flutter documents.
Unauthorized / wrong surface
| You used | But needed |
|---|---|
ak_ on /system/graphql |
System credentials |
| Console cookie in a mobile app | Project token / login JWT |
| Admin SDK → system URL | Project GraphQL endpoint |
Read System vs secured.
Empty SaaS lists
Missing tenant_id filter or X-Apito-Tenant-ID. See Filters & relations.
CLI sync “succeeded” but API unchanged
Expected — sync stages a draft. Publish in Console. Content still needs seed.mjs or Content sync.
Flutter package not on pub.dev
Expected (publish_to: none). Use Git/path — Flutter SDK.
Python SDK missing
There is none. Use raw GraphQL/REST.
Relation connect ignored
Snake_case key mismatch or stale generated ops — regenerate after schema rename.