deleteModel

The deleteModel function deletes an Entity model and every content entry of that type. It is the JavaScript/TypeScript counterpart of the DELETE /model/entity/:id REST endpoint.

Example:

import { isApiClientError } from '@content-island/api-client';

try {
  await client.deleteModel(modelId);
  // resolves to `true` on success
} catch (error) {
  if (isApiClientError(error) && error.code === 'CONFLICT') {
    // the model is referenced by a field on another model — repoint it first
  }
}

Caution

deleteModel requires a Write Token as the client’s accessToken. Calling it with a read token returns 403 Forbidden.

Danger

This operation is irreversible and cascades: it deletes all content of this type. There is no dry-run at this layer — the call applies the deletion immediately. (The delete-content-island-model MCP tool adds a dry-run / confirm gate on top.)

Interface

export interface ApiClient {
  deleteModel: (modelId: string) => Promise<boolean>;
  // ... other methods
}

Parameters

Name	Description
modelId	The id of the entity to delete.

Output

Resolves to true when the model is deleted (HTTP 204). On failure it throws a typed ApiClientError:

• CONFLICT (409) — the model is referenced by a relation field on another model. There is no force override; remove or repoint the referencing field first.
• NOT_FOUND (404) — no entity with that id exists.