Read organization settings

Request#

GET /api/v1/organizations/current

Requires organizations:read. See token permissions.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json. No request body is supported.

Query parameters#

This endpoint does not use query parameters.

Example#

curl "https://my.assetcenter.app/api/v1/organizations/current" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK. Example values:

{
  "data": {
    "id": 42,
    "name": "Example Organization",
    "image_url": null,
    "has_photo": false,
    "social_provider": "password",
    "require_2fa": false,
    "can_create": false,
    "can_delete": true
  }
}

id is the organization ID to use in other organization endpoints. image_url is a temporary logo URL valid for 24 hours, or null. Fetch settings again when you need a fresh URL.

can_create is always false for customer API tokens because organization creation is unavailable. can_delete reflects whether the subscription or trial state permits deletion. It does not grant token permissions; deletion still requires exact-name confirmation. Refresh settings before relying on the current deletion eligibility.

Behavior and constraints#

The organization comes from the token, regardless of which organization its creator has selected in the app. This endpoint does not list other organizations. Organization scope explains how to connect another organization.

Errors#

401 means authentication is invalid or the token has expired or been revoked. 403 means organizations:read or the creator's active administrator access is missing. Unsupported inputs return 422; a rate limit returns 429. See error handling and rate limits.