Cancel a demo - Demosmith Developers

Cancel a demo

curl --request POST \
  --url https://platform.demosmith.ai/v1/demos/{demo_id}/cancel \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.demosmith.ai/v1/demos/{demo_id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "5b9e3c7a-2f41-4c8e-9a51-7d0b6e2f1c34",
  "object": "demo",
  "status": "canceled",
  "stage": null,
  "progress": {
    "percent": 0,
    "eta_seconds": 900
  },
  "queue": null,
  "title": null,
  "url": "https://cal.com",
  "task": "Show how to book a 30-minute meeting from a public booking page",
  "language": "en-US",
  "input_request": null,
  "video": null,
  "failure": null,
  "app_url": "https://app.demosmith.ai/demos/5b9e3c7a-2f41-4c8e-9a51-7d0b6e2f1c34",
  "source": "api",
  "metadata": {
    "crm_account": "acct_123"
  },
  "check_again_in_seconds": 0,
  "created_at": "2026-11-07T11:58:40Z",
  "updated_at": "2026-11-07T11:58:40Z",
  "finished_at": "2026-11-07T11:59:10Z"
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

POST

/

demos

/

{demo_id}

/

cancel

Cancel a demo

curl --request POST \
  --url https://platform.demosmith.ai/v1/demos/{demo_id}/cancel \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform.demosmith.ai/v1/demos/{demo_id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "5b9e3c7a-2f41-4c8e-9a51-7d0b6e2f1c34",
  "object": "demo",
  "status": "canceled",
  "stage": null,
  "progress": {
    "percent": 0,
    "eta_seconds": 900
  },
  "queue": null,
  "title": null,
  "url": "https://cal.com",
  "task": "Show how to book a 30-minute meeting from a public booking page",
  "language": "en-US",
  "input_request": null,
  "video": null,
  "failure": null,
  "app_url": "https://app.demosmith.ai/demos/5b9e3c7a-2f41-4c8e-9a51-7d0b6e2f1c34",
  "source": "api",
  "metadata": {
    "crm_account": "acct_123"
  },
  "check_again_in_seconds": 0,
  "created_at": "2026-11-07T11:58:40Z",
  "updated_at": "2026-11-07T11:58:40Z",
  "finished_at": "2026-11-07T11:59:10Z"
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "needs_answers",
    "message": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

An API key from the Developers page.

Path Parameters

demo_id

string<uuid>

required

Response

OK

id

string<uuid>

required

object

string

required

Allowed value: "demo"

status

enum<string>

required

Available options:

canceled,

completed,

failed,

in_progress,

input_required,

queued

stage

enum<string> | null

Available options:

analyzing,

editing,

narrating,

recording,

rendering,

null

progress

object

Show child attributes

queue

object | null

Show child attributes

title

string | null

url

string<uri>

task

string

language

string | null

input_request

object | null

A question the recorder is waiting on.

Show child attributes

video

object | null

Show child attributes

failure

object | null

Show child attributes

app_url

string<uri>

source

enum<string>

Available options:

api,

mcp,

web

metadata

object

Show child attributes

check_again_in_seconds

integer

Wait at least this long before polling again. 0 when finished.

created_at

string<date-time>

updated_at

string<date-time>

finished_at

string<date-time> | null