AssetCenter
Organization API
Manage organization settings, upload logos, export data, and delete an organization with customer API tokens.
Last updated
Use a customer API token
Organization actions use the same https://my.assetcenter.app/api/v1 customer API and bearer tokens created in Settings → API Access. User login is not required for integration requests. Choose the necessary organization permissions when creating a token; existing tokens retain their original permissions.
Organization scope
A token is permanently bound to the organization where it was created. Read the current organization to obtain its ID. Every {organization} path parameter must match that ID. Another organization's ID returns 404, even if the token creator administers both organizations.
Customer tokens cannot create or switch organizations. Sending tenant_id, account_id, or organization_id does not select an organization; unsupported input is rejected. Switching organizations in the app does not change the token's organization.
Create organizations in the app. To connect another organization through the API, select it in the app and create a separate token under Settings → API Access. Full Access and older tokens do not permit organization creation.
Organization permissions
| Permission | Allows |
|---|---|
organizations:read |
Read the token's organization settings and ID. |
organizations:update |
Edit the organization name and upload or remove its logo. |
organizations:security |
Change social_provider or require_2fa; also requires organizations:update. |
organizations:export |
Download an Excel export; also requires the exported resource's :read permission. |
organizations:delete |
Permanently delete the token's organization after exact-name confirmation. |
Read Only includes organizations:read, users:read, and the four inventory Read permissions. Full Access includes all five organization permissions alongside all inventory and workflow permissions. Custom lets you choose them individually. Adding permissions to a preset does not expand an existing token; create a replacement with the required permissions.
Available actions
| Action | Endpoint |
|---|---|
| Read settings | GET /api/v1/organizations/current |
| Update settings | PATCH / PUT /api/v1/organizations/{organization} |
| Upload a logo | POST /api/v1/organizations/{organization}/image |
| Remove a logo | DELETE /api/v1/organizations/{organization}/image |
| Download an export | GET /api/v1/organizations/{organization}/exports/{exportResource} |
| Delete the organization | DELETE /api/v1/organizations/{organization} |
JSON responses wrap their result in data. Exports stream an authenticated Excel download directly. Every organization mutation requires an Idempotency-Key; see retry behavior. Successful deletion revokes the token, so it cannot be replayed using that token.