POST /v1/capsules/{id}/ping — Reset inactivity timer

Use this endpoint to reset the inactivity timer on a running capsule. When a capsule is created with a non-zero timeout_sec, Wrenn automatically pauses it after that many seconds with no exec calls. Calling ping updates the last_active_at timestamp, restarting the countdown. Use it as a keepalive when your application is holding a capsule open but not actively executing commands.

If timeout_sec is 0 (auto-pause disabled), this endpoint still accepts the request and returns 204 — it simply has no effect on the TTL.

Endpoint

POST https://app.wrenn.dev/api/v1/capsules/{id}/ping

Authentication

Pass your API key in the X-API-Key header.

X-API-Key: wrn_your_key

Path parameters

string

required

The ID of the capsule to ping (e.g., cl-abc123). The capsule must be in running status.

Response

Returns 204 No Content on success. The response body is empty. The capsule’s last_active_at timestamp is updated server-side.

curl

curl --request POST \
  --url https://app.wrenn.dev/api/v1/capsules/cl-abc123/ping \
  --header 'X-API-Key: wrn_your_key'

Python SDK

from wrenn import Capsule

capsule = Capsule.connect("cl-abc123")
capsule.ping()

You can set up a periodic keepalive in a background thread or async task:

import threading
import time
from wrenn import Capsule

def keepalive(capsule, interval=60):
    while True:
        time.sleep(interval)
        try:
            capsule.ping()
        except Exception:
            break

capsule = Capsule(template="minimal", wait=True)
t = threading.Thread(target=keepalive, args=(capsule,), daemon=True)
t.start()

# Your main logic here — the capsule won't auto-pause while keepalive runs

Error responses

Status	Description
`401 Unauthorized`	Missing or invalid `X-API-Key`.
`404 Not Found`	No capsule with the given ID exists in your team.
`409 Conflict`	The capsule is not in `running` status. You can only ping a running capsule.

Capsules

Execution

Files

Snapshots

POST /v1/capsules/{id}/ping — Reset inactivity timer

Endpoint

Authentication

Path parameters

Response

curl

Python SDK

Error responses

​Endpoint

​Authentication

​Path parameters

​Response

​curl

​Python SDK

​Error responses

Endpoint

Authentication

Path parameters

Response

curl

Python SDK

Error responses