Apps using the REST API
If your app runs on your own infrastructure and interacts with Attio only through the REST API, you can update your code at any time. There is no versioning or review process on Attio’s side. You may freely deploy updates using your own release process.Apps using the App SDK
App SDK code runs on Attio’s infrastructure and is versioned. Each time you want to ship an update, create a new version by running this command in your project directory:Private apps
If your app is shared via private invites, workspaces that have installed your app are automatically migrated to the latest version when you create a new version or save a change in the Developer console. No further action is required, unless the update adds scopes. See Changing scopes.Published apps
If your app is published to the App Store, new versions of your code must be submitted for review before they are released to users. Once you’ve created a new version, head to the developer console and find it under the Versions tab. It will be marked as private, with the option to publish. Click ‘Publish’ to submit your update for review.Reviewing updates
Updates to app listing content, logos and App Store images are also subject to review. Once requested, the Attio team will review your update. We aim to complete all reviews within 1 week.Changing scopes
You set your app’s scopes in the Developer console. When a change to scopes takes effect depends on how a workspace installed your app:- From the App Store: the workspace uses the scopes of the latest approved version. A change to scopes takes effect when you publish a new version and the Attio team approves it.
- From a private invite: a change to scopes takes effect as soon as you save it in the Developer console, even after you publish your app. You do not need to create a new version.
- In development mode: in the workspace where you run
attio dev, a change to scopes takes effect as soon as you save it. No approval is necessary.