Add cards to a folder

Adding a card already in the folder succeeds without change. A card can be in up to 50 folders.

POST/v1/folders/{folderId}/cards

Authorization

AuthorizationBearer token (OAuth access token or teakapi_ API key) · headerrequired

Bearer token. Accepts either an OAuth 2.0 access token (obtained via browser sign-in; expires after 1 hour and is refreshable) or a teakapi_ API key.

Path parameters

folderIdstringrequired

Request body

requiredapplication/json

cardIdsstring[]required

min items 1 · max items 100

Responses

200

Per-card results

updatedIdsstring[]required

failedIdsstring[]required

Cards left unchanged: missing, another account's, or (when adding) already in the most folders a card can be in.

folderLimitIdsstring[]required

Failed cards that are already in 50 folders.

404

Folder not found

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (OAuth access token or teakapi_ API key)Remember on this deviceInclude my values in samples

Parameters

folderIdpath*

Bodyapplication/json

Request body

Request

curl -X POST 'https://teakvault.com/api/v1/folders/string/cards' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "cardIds": [
    "string"
  ]
}'

const response = await fetch("https://teakvault.com/api/v1/folders/string/cards", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"cardIds\": [\n    \"string\"\n  ]\n}"
});

const response: Response = await fetch("https://teakvault.com/api/v1/folders/string/cards", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"cardIds\": [\n    \"string\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://teakvault.com/api/v1/folders/string/cards",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"cardIds\": [\n    \"string\"\n  ]\n}",
)

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader("{\n  \"cardIds\": [\n    \"string\"\n  ]\n}")
	req, err := http.NewRequest("POST", "https://teakvault.com/api/v1/folders/string/cards", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_TOKEN")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

require "net/http"

uri = URI("https://teakvault.com/api/v1/folders/string/cards")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = "{\n  \"cardIds\": [\n    \"string\"\n  ]\n}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://teakvault.com/api/v1/folders/string/cards',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => '{
  "cardIds": [
    "string"
  ]
}',
]);

$response = curl_exec($curl);

Response

{
  "updatedIds": [
    "string"
  ],
  "failedIds": [
    "string"
  ],
  "folderLimitIds": [
    "string"
  ]
}