API reference · Terminal

Rename a card or folder

POST /api/v1/terminal/rename

Gives a card or a folder a new name. Needs an API key. Terminal and routines open with the new RoTerminal: on an account it isn’t open on yet, the answer is permission_denied .

This endpoint needs an API key. See Authentication.

Parameters

id string
A card’s ID (12 characters, from List your Terminal). Send this or folder .
folder string
A folder’s name or ID. Send this or id .
title string Required
The new name.

Example

curl -X POST https://roterminal.co/api/v1/terminal/rename \ -H "Authorization: Bearer $ROTERMINAL_API_KEY" \ -H "Content-Type: application/json" \ -d '{"folder":"My folder","title":"Rivals"}' import RoTerminal from 'roterminal' const rt = new RoTerminal ({ apiKey: process.env.ROTERMINAL_API_KEY }) const { data } = await rt.terminal. rename ({ folder: 'My folder' , title: 'Rivals' }) from roterminal import RoTerminal rt = RoTerminal () # reads ROTERMINAL_API_KEY data = rt.terminal. rename (folder= "My folder" , title= "Rivals" )[ "data" ]

Response

Every response is { data, link, as_of } . The fields of data are below.

Fields

The fields in data . A field with nothing to say is left out.

renamed string
The card or folder’s ID.
was string
Its old name.
now string
Its new name.