Skip to content
Console
On this page

Delete a space

Deletes a space.

This method is not served on the public API. api.sylphx.com does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

Deletes a space. A space that still holds records is refused with INVALID_STATE unless force is set, which deletes its episodes and facts too.

Not available yet. Sylphx Knowledge is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.

  • Path DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space
  • Scope knowledge:write
  • Effect destructive — a successful call removes data; the CLI asks before it runs.
  • Collection spaces
  • Query etag, allow_missing, validate_only, force

Request

FieldTypeWhat it is
namestringThe name of the space to delete. Required.
etagstringDelete only if the current etag matches.
allow_missingboolSucceed when the space does not exist.
validate_onlyboolValidate without deleting anything.
forceboolAlso delete the space's episodes and facts; without it, a space that holds records is refused with INVALID_STATE.

Response

The call answers with an empty object.

Errors

Every error arrives in the body Errors describes.

Examples

curl -X DELETE "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"