Skip to main content
DELETE
https://tickward.com/api/v1
/
projects
/
{project_id}
/
spaces
/
{space_id}
Delete a space
curl --request DELETE \
  --url https://tickward.com/api/v1/projects/{project_id}/spaces/{space_id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "id": "<string>",
  "deleted": true,
  "project_id": "<string>",
  "project_name": "<string>",
  "name": "<string>",
  "label": "<string>",
  "timer_id": "<string>",
  "timer_label": "<string>"
}

Authorizations

​
Authorization
string
header
default:tw_your_api_key
required

Use a tickward API key from Settings. API keys start with tw_. Store keys as secrets and send them as Authorization: Bearer <key>.

Headers

​
Idempotency-Key
string

Optional for POST, PATCH, and DELETE requests. Generate a random UUID with an operation prefix, for example timer-create-${crypto.randomUUID()}. Reuse the same key with the same method, path, query, and JSON body to safely retry one logical write for up to 24 hours. Reusing it with a different request returns 409. The server stores only a hash of the key.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

​
project_id
string
required
​
space_id
string
required

Query Parameters

​
dry_run
enum<boolean>

When true, return a preview of what would change without mutating data or recording idempotency.

Available options:
true

Response

Deleted space or dry-run preview.

​
object
string
required
Allowed value: "space"
​
id
string
required
​
deleted
boolean
required
​
project_id
string

Project id when the deleted resource belongs to a project.

​
project_name
string

Human-readable project name for agent confirmations.

​
name
string

Human-readable project or space name when available.

​
label
string

Human-readable timer label when available.

​
timer_id
string

Timer id when a deleted share belonged to a timer.

​
timer_label
string

Timer label when a deleted share belonged to an existing timer.