Skip to navigation

Rename a space or change its lifetime

View as Markdown

Send name, ttl, or both.

  • name renames the space. The id does not change, so its files and runs stay attached.
  • ttl 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 can be changed here; any other space answers 404.

{ "name": "Acme onboarding", "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.
namestringOptional1-120 characters
The new name for the space.
ttlintegerOptional300-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