Skip to content
Back

Create a project via REST API or SDK, missing scopes (["projects.write"])

  • 0
  • Self Hosted
  • Tools
qaxie
14 Jan, 2026, 03:47

I am currently self-hosting Appwrite in my local machine, deployed using docker script in the website. I also installed appwrite-cli through npm.

I am trying to create a project programmatically. I am aware that I can create a project in the appwrite-cli using appwrite init project and following the setup. I am successful in creating a project that way.

However, I want to create the project through the command appwrite projects create but I am getting the error:

TypeScript
AppwriteException [Error]: (my email address) (role: users) missing scopes (["projects.write"])

The email address that I am using is the owner, and should be the "admin" as this is the only account I created in the Console and in Appwrite. I also have the "Owner" role in the Personal projects landing page (organization)

I tried to follow the Network in Console to use the same cookie to call a POST query in Postman, but that also gives me the missing scope issue.

What am I doing wrong with my appwrite projects create call? Am I missing out something to make my account into an admin/owner? Do I have to add the projects.write scope somewhere? Is there a gap with the self-hosted and the Cloud version?

Thanks

TL;DR
Developers trying to create a project programmatically via `appwrite projects create` are encountering a missing scopes error (`["projects.write"]`). The user is self-hosting Appwrite locally, and successfully created a project using `appwrite init project`. The issue seems to stem from the user's account not having the necessary permissions. They are seeking guidance on how to add the `projects.write` scope to their account to resolve the problem.
qaxie
14 Jan, 2026, 03:50

this is the command I called

TypeScript
appwrite projects create --project-id 'ID.unique()' --name 'Name 2' --team-id 'ID.unique()' --verbose

And the error

TypeScript
AppwriteException [Error]: (my email address) (role: users) missing scopes (["projects.write"])
    at Client.call (/Users/user/.nvm/versions/node/v24.3.0/lib/node_modules/appwrite-cli/lib/client.js:209:13)
    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
    at async projectsCreate (/Users/user/.nvm/versions/node/v24.3.0/lib/node_modules/appwrite-cli/lib/commands/projects.js:156:16) {
  code: 401,
  response: 'general_unauthorized_scope'
}
Reply

Reply to this thread by joining our Discord

Reply on Discord

Need support?

Join our Discord

Get community support by joining our Discord server.

Join Discord

Get premium support

Join Appwrite Pro and get email support from our team.

Learn more