Delete a world-tier personality

DELETE

/api/v1/world/personalities/{slug}

const url = 'http://localhost:11044/api/v1/world/personalities/example';
const options = {method: 'DELETE', headers: {'X-Embabel-Api-Key': '<X-Embabel-Api-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url http://localhost:11044/api/v1/world/personalities/example \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

The active personality is refused — switch first. Realm personalities are removed by uninstalling their realm.

Authorizations

apiKeyAuth
basicAuth

Parameters

Path Parameters

slug

required

string

Slug of a world-tier personality the user made; the active personality (switch first), shipped and realm personalities, and unknown slugs answer 400

Responses

200

Deleted

*/*

object

400

Refused — active, realm-owned, or unknown

*/*

A refusal from the world administration surface: what went wrong, and the word error so a client reading the body need not consult the status code

object

message

required

What was refused and why, written to be shown. Names the offending value where there is one — the unknown mode, the out-of-range threshold, the invalid cron expression

string

status

required

Always error. Present because the map this replaces carried it and a consumer may branch on it

string

Example

error