Skip to navigation

Change a space's lifetime

View as Markdown

Sets a new deadline: expiresAt becomes now plus ttl seconds, whether that extends the space or shortens it.

Only a space created with POST /v1/spaces has a deadline to change; any other space answers 404.

{ "ttl": 2592000 }

Learn more: Spaces

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired>=1 character

Request

This endpoint expects an object.
ttlintegerRequired300-7776000
Seconds until the space expires, from now.

Response

The space.
object"space"
idstring
namestring
createdAtstring
expiresAtstring or null

Errors

400
Bad Request Error
404
Not Found Error
429
Too Many Requests Error