Cards
Create a card
This endpoint allows you to create a new card in a specified team workspace by providing a set of required and optional parameters. Key required fields include:
title: The name of the cardlist_id: The ID of the list where the card will be placedboard_idorsprint_id: One of these fields must be provided to specify where the card belongs to
The card’s content has a character limit of 102400, and timestamps like due_date and start_date are
specified as Unix timestamps in seconds. Enum fields include status (committed, started, completed, cancelled)
and icon types (image, emoji, icon).
POST
/
{team_id}
/
cards
Create a new card
curl --request POST \
--url https://api.superthread.com/v1/{team_id}/cards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "My Card",
"list_id": "114",
"content": "Some card content",
"content_format": "html",
"file_ids": [
"<string>"
],
"schema": 1,
"start_date": 1608742037016,
"due_date": 1608742037016,
"board_id": "5",
"project_id": "1",
"sprint_id": "8",
"owner_id": "<string>",
"members": [
{
"user_id": "u-dsu0j19"
}
],
"priority": 1,
"estimate": 3,
"parent_card_id": "<string>",
"epic_id": "<string>",
"board_email_ref": "b291eKoaaLn5",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"checklists": [
{
"title": "My Checklist",
"items": [
{
"title": "Some title",
"content": "Some description",
"checked": false
}
]
}
],
"form_id": "<string>",
"form_requester_user_id": "<string>"
}
'import requests
url = "https://api.superthread.com/v1/{team_id}/cards"
payload = {
"title": "My Card",
"list_id": "114",
"content": "Some card content",
"content_format": "html",
"file_ids": ["<string>"],
"schema": 1,
"start_date": 1608742037016,
"due_date": 1608742037016,
"board_id": "5",
"project_id": "1",
"sprint_id": "8",
"owner_id": "<string>",
"members": [{ "user_id": "u-dsu0j19" }],
"priority": 1,
"estimate": 3,
"parent_card_id": "<string>",
"epic_id": "<string>",
"board_email_ref": "b291eKoaaLn5",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": False,
"on_behalf_of": "<string>"
}
},
"checklists": [
{
"title": "My Checklist",
"items": [
{
"title": "Some title",
"content": "Some description",
"checked": False
}
]
}
],
"form_id": "<string>",
"form_requester_user_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'My Card',
list_id: '114',
content: 'Some card content',
content_format: 'html',
file_ids: ['<string>'],
schema: 1,
start_date: 1608742037016,
due_date: 1608742037016,
board_id: '5',
project_id: '1',
sprint_id: '8',
owner_id: '<string>',
members: [{user_id: 'u-dsu0j19'}],
priority: 1,
estimate: 3,
parent_card_id: '<string>',
epic_id: '<string>',
board_email_ref: 'b291eKoaaLn5',
user: {
user_id: 'uDsu0j19',
type: 'user',
source: {
type: 'oauth',
client_id: 'oczapier',
import_id: 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
agent_id: 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
email_addr: 'somebody@example.com',
email_verified: false,
on_behalf_of: '<string>'
}
},
checklists: [
{
title: 'My Checklist',
items: [{title: 'Some title', content: 'Some description', checked: false}]
}
],
form_id: '<string>',
form_requester_user_id: '<string>'
})
};
fetch('https://api.superthread.com/v1/{team_id}/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.superthread.com/v1/{team_id}/cards",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'My Card',
'list_id' => '114',
'content' => 'Some card content',
'content_format' => 'html',
'file_ids' => [
'<string>'
],
'schema' => 1,
'start_date' => 1608742037016,
'due_date' => 1608742037016,
'board_id' => '5',
'project_id' => '1',
'sprint_id' => '8',
'owner_id' => '<string>',
'members' => [
[
'user_id' => 'u-dsu0j19'
]
],
'priority' => 1,
'estimate' => 3,
'parent_card_id' => '<string>',
'epic_id' => '<string>',
'board_email_ref' => 'b291eKoaaLn5',
'user' => [
'user_id' => 'uDsu0j19',
'type' => 'user',
'source' => [
'type' => 'oauth',
'client_id' => 'oczapier',
'import_id' => 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
'agent_id' => 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
'email_addr' => 'somebody@example.com',
'email_verified' => false,
'on_behalf_of' => '<string>'
]
],
'checklists' => [
[
'title' => 'My Checklist',
'items' => [
[
'title' => 'Some title',
'content' => 'Some description',
'checked' => false
]
]
]
],
'form_id' => '<string>',
'form_requester_user_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.superthread.com/v1/{team_id}/cards"
payload := strings.NewReader("{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.superthread.com/v1/{team_id}/cards")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.superthread.com/v1/{team_id}/cards")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"card": {
"id": "2700",
"type": "card",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
},
"team_id": "tDsu0j19",
"title": "My Card",
"content": "Some card content",
"schema": 1,
"collaboration": {
"token": "<string>"
},
"status": "started",
"priority": 1,
"board_id": "12",
"board_title": "<string>",
"list_id": "41",
"list_color": "<string>",
"list_title": "<string>",
"sprint_id": "4s12",
"owner_id": "uR2dws11",
"user_id": "uR2dws11",
"user_id_updated": "u2erXoQq",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"user_updated": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"start_date": 1608742037016,
"due_date": 1608742037016,
"completed_date": 1608742037016,
"time_created": 1608742037016,
"time_updated": 1608742037016,
"members": [
{
"user_id": "u-dsu0j19",
"assigned_date": 1608742037016,
"role": "admin"
}
],
"checklists": [
{
"id": "232",
"title": "My Checklist",
"content": "Some description",
"card_id": "32",
"user_id": "uG2sdaOn",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"items": [
{
"id": "4312",
"title": "Some title",
"content": "Some description",
"checklist_id": "432",
"user_id": "u-du9saoj1",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"checked": true
}
]
}
],
"checklist_order": {},
"checklist_item_order": {},
"parent_card": {
"title": "Implement service requirements",
"card_id": "42",
"list_color": "<string>",
"status": "started"
},
"child_cards": [
{
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "us4Fsfed",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "55",
"list_title": "Done",
"list_color": "<string>",
"status": "started",
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
}
}
],
"child_card_order": {},
"linked_cards": [
{
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "42",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "list 1",
"list_title": "list 1",
"status": "started",
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"linked_card_type": "blocks",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
}
}
],
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"archived_list": false,
"archived_board": false,
"tags": [
{
"id": "u-dsu0j19",
"team_id": "u-dsu0j19",
"project_id": "5",
"name": "todo",
"slug": "todo",
"color": "blue",
"total_cards": 17
}
],
"total_comments": 3,
"total_files": 1,
"is_watching": true,
"is_bookmarked": true,
"project_id": "<string>",
"external_links": [
{
"type": "github_pull_request",
"github_pull_request": {
"id": 123,
"number": 123,
"state": "<string>",
"title": "<string>",
"body": "<string>",
"html_url": "<string>",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"time_closed": 1608742037016,
"time_merged": 1608742037016,
"head": {
"label": "<string>",
"ref": "<string>"
},
"base": {
"label": "<string>",
"ref": "<string>"
},
"draft": true,
"merged": true
},
"generic": {
"url": "<string>",
"id": "550e8400-e29b-41d4-a716-446655440000",
"display_text": "<string>",
"time_added": 1608742037016
}
}
],
"hints": [
{
"type": "tag",
"tag": {
"name": "bug"
},
"relation": {
"card": {
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "us4Fsfed",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "55",
"list_title": "Done",
"list_color": "<string>",
"status": "started"
},
"similarity": 0.8
}
}
],
"estimate": 2,
"epic": {
"id": "e-123",
"title": "Epic Title",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
}
},
"cover_image": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup",
"positionY": 123,
"object_fit": "contain"
},
"copied_from_card_id": "<string>",
"form_id": "<string>",
"form_values": {},
"form_participants": [
"<string>"
],
"external_request": {
"source": "published_agent",
"external_conversation": {
"publication_id": "pub_01JB7Q4Z8XKQ3N6V2W1Y9T5R0M",
"conversation_id": "xc_01JB7Q5B2C3D4E5F6G7H8J9K0L",
"actor_id": "xa_01JB7Q5RZ0Y1X2W3V4U5T6S7R8",
"audience": "anonymous",
"agent_id": "<string>",
"app_id": "<string>"
},
"source_label": "Published agent · anonymous",
"display_name": "<string>",
"redacted": true
},
"suggested_branch_name": "<string>",
"customers": [
{
"id": "cu_01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
"name": "Acme",
"logo_url": "<string>",
"tier_id": "<string>",
"status_id": "<string>",
"owner_id": "<string>",
"revenue": 123,
"size": 123,
"important": true
}
],
"customer_count": 123,
"customer_important_count": 123,
"customer_revenue": 123
}
}{
"code": 402,
"error": "plan_limit_reached",
"resource": "board",
"limit": 25,
"current": 25,
"limit_kind": "boards_per_workspace",
"id": "err5f744ab",
"sec": "SEC:000-00014",
"message": "plan limit reached: board (25 of 25)",
"date": 1608742037016
}{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}Authorizations
Path Parameters
Body
application/json
Card object that needs to be created
⌘I
Create a new card
curl --request POST \
--url https://api.superthread.com/v1/{team_id}/cards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "My Card",
"list_id": "114",
"content": "Some card content",
"content_format": "html",
"file_ids": [
"<string>"
],
"schema": 1,
"start_date": 1608742037016,
"due_date": 1608742037016,
"board_id": "5",
"project_id": "1",
"sprint_id": "8",
"owner_id": "<string>",
"members": [
{
"user_id": "u-dsu0j19"
}
],
"priority": 1,
"estimate": 3,
"parent_card_id": "<string>",
"epic_id": "<string>",
"board_email_ref": "b291eKoaaLn5",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"checklists": [
{
"title": "My Checklist",
"items": [
{
"title": "Some title",
"content": "Some description",
"checked": false
}
]
}
],
"form_id": "<string>",
"form_requester_user_id": "<string>"
}
'import requests
url = "https://api.superthread.com/v1/{team_id}/cards"
payload = {
"title": "My Card",
"list_id": "114",
"content": "Some card content",
"content_format": "html",
"file_ids": ["<string>"],
"schema": 1,
"start_date": 1608742037016,
"due_date": 1608742037016,
"board_id": "5",
"project_id": "1",
"sprint_id": "8",
"owner_id": "<string>",
"members": [{ "user_id": "u-dsu0j19" }],
"priority": 1,
"estimate": 3,
"parent_card_id": "<string>",
"epic_id": "<string>",
"board_email_ref": "b291eKoaaLn5",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": False,
"on_behalf_of": "<string>"
}
},
"checklists": [
{
"title": "My Checklist",
"items": [
{
"title": "Some title",
"content": "Some description",
"checked": False
}
]
}
],
"form_id": "<string>",
"form_requester_user_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'My Card',
list_id: '114',
content: 'Some card content',
content_format: 'html',
file_ids: ['<string>'],
schema: 1,
start_date: 1608742037016,
due_date: 1608742037016,
board_id: '5',
project_id: '1',
sprint_id: '8',
owner_id: '<string>',
members: [{user_id: 'u-dsu0j19'}],
priority: 1,
estimate: 3,
parent_card_id: '<string>',
epic_id: '<string>',
board_email_ref: 'b291eKoaaLn5',
user: {
user_id: 'uDsu0j19',
type: 'user',
source: {
type: 'oauth',
client_id: 'oczapier',
import_id: 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
agent_id: 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
email_addr: 'somebody@example.com',
email_verified: false,
on_behalf_of: '<string>'
}
},
checklists: [
{
title: 'My Checklist',
items: [{title: 'Some title', content: 'Some description', checked: false}]
}
],
form_id: '<string>',
form_requester_user_id: '<string>'
})
};
fetch('https://api.superthread.com/v1/{team_id}/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.superthread.com/v1/{team_id}/cards",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'My Card',
'list_id' => '114',
'content' => 'Some card content',
'content_format' => 'html',
'file_ids' => [
'<string>'
],
'schema' => 1,
'start_date' => 1608742037016,
'due_date' => 1608742037016,
'board_id' => '5',
'project_id' => '1',
'sprint_id' => '8',
'owner_id' => '<string>',
'members' => [
[
'user_id' => 'u-dsu0j19'
]
],
'priority' => 1,
'estimate' => 3,
'parent_card_id' => '<string>',
'epic_id' => '<string>',
'board_email_ref' => 'b291eKoaaLn5',
'user' => [
'user_id' => 'uDsu0j19',
'type' => 'user',
'source' => [
'type' => 'oauth',
'client_id' => 'oczapier',
'import_id' => 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
'agent_id' => 'bf1b9f76-3f95-42fc-bd7f-050b2f5f4197',
'email_addr' => 'somebody@example.com',
'email_verified' => false,
'on_behalf_of' => '<string>'
]
],
'checklists' => [
[
'title' => 'My Checklist',
'items' => [
[
'title' => 'Some title',
'content' => 'Some description',
'checked' => false
]
]
]
],
'form_id' => '<string>',
'form_requester_user_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.superthread.com/v1/{team_id}/cards"
payload := strings.NewReader("{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.superthread.com/v1/{team_id}/cards")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.superthread.com/v1/{team_id}/cards")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"My Card\",\n \"list_id\": \"114\",\n \"content\": \"Some card content\",\n \"content_format\": \"html\",\n \"file_ids\": [\n \"<string>\"\n ],\n \"schema\": 1,\n \"start_date\": 1608742037016,\n \"due_date\": 1608742037016,\n \"board_id\": \"5\",\n \"project_id\": \"1\",\n \"sprint_id\": \"8\",\n \"owner_id\": \"<string>\",\n \"members\": [\n {\n \"user_id\": \"u-dsu0j19\"\n }\n ],\n \"priority\": 1,\n \"estimate\": 3,\n \"parent_card_id\": \"<string>\",\n \"epic_id\": \"<string>\",\n \"board_email_ref\": \"b291eKoaaLn5\",\n \"user\": {\n \"user_id\": \"uDsu0j19\",\n \"type\": \"user\",\n \"source\": {\n \"type\": \"oauth\",\n \"client_id\": \"oczapier\",\n \"import_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"agent_id\": \"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197\",\n \"email_addr\": \"somebody@example.com\",\n \"email_verified\": false,\n \"on_behalf_of\": \"<string>\"\n }\n },\n \"checklists\": [\n {\n \"title\": \"My Checklist\",\n \"items\": [\n {\n \"title\": \"Some title\",\n \"content\": \"Some description\",\n \"checked\": false\n }\n ]\n }\n ],\n \"form_id\": \"<string>\",\n \"form_requester_user_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"card": {
"id": "2700",
"type": "card",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
},
"team_id": "tDsu0j19",
"title": "My Card",
"content": "Some card content",
"schema": 1,
"collaboration": {
"token": "<string>"
},
"status": "started",
"priority": 1,
"board_id": "12",
"board_title": "<string>",
"list_id": "41",
"list_color": "<string>",
"list_title": "<string>",
"sprint_id": "4s12",
"owner_id": "uR2dws11",
"user_id": "uR2dws11",
"user_id_updated": "u2erXoQq",
"user": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"user_updated": {
"user_id": "uDsu0j19",
"type": "user",
"source": {
"type": "oauth",
"client_id": "oczapier",
"import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
"email_addr": "somebody@example.com",
"email_verified": false,
"on_behalf_of": "<string>"
}
},
"start_date": 1608742037016,
"due_date": 1608742037016,
"completed_date": 1608742037016,
"time_created": 1608742037016,
"time_updated": 1608742037016,
"members": [
{
"user_id": "u-dsu0j19",
"assigned_date": 1608742037016,
"role": "admin"
}
],
"checklists": [
{
"id": "232",
"title": "My Checklist",
"content": "Some description",
"card_id": "32",
"user_id": "uG2sdaOn",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"items": [
{
"id": "4312",
"title": "Some title",
"content": "Some description",
"checklist_id": "432",
"user_id": "u-du9saoj1",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"checked": true
}
]
}
],
"checklist_order": {},
"checklist_item_order": {},
"parent_card": {
"title": "Implement service requirements",
"card_id": "42",
"list_color": "<string>",
"status": "started"
},
"child_cards": [
{
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "us4Fsfed",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "55",
"list_title": "Done",
"list_color": "<string>",
"status": "started",
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
}
}
],
"child_card_order": {},
"linked_cards": [
{
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "42",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "list 1",
"list_title": "list 1",
"status": "started",
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"linked_card_type": "blocks",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
}
}
],
"archived": {
"user_id": "uDsu0j19",
"time_archived": 1608742037016
},
"archived_list": false,
"archived_board": false,
"tags": [
{
"id": "u-dsu0j19",
"team_id": "u-dsu0j19",
"project_id": "5",
"name": "todo",
"slug": "todo",
"color": "blue",
"total_cards": 17
}
],
"total_comments": 3,
"total_files": 1,
"is_watching": true,
"is_bookmarked": true,
"project_id": "<string>",
"external_links": [
{
"type": "github_pull_request",
"github_pull_request": {
"id": 123,
"number": 123,
"state": "<string>",
"title": "<string>",
"body": "<string>",
"html_url": "<string>",
"time_created": 1608742037016,
"time_updated": 1608742037016,
"time_closed": 1608742037016,
"time_merged": 1608742037016,
"head": {
"label": "<string>",
"ref": "<string>"
},
"base": {
"label": "<string>",
"ref": "<string>"
},
"draft": true,
"merged": true
},
"generic": {
"url": "<string>",
"id": "550e8400-e29b-41d4-a716-446655440000",
"display_text": "<string>",
"time_added": 1608742037016
}
}
],
"hints": [
{
"type": "tag",
"tag": {
"name": "bug"
},
"relation": {
"card": {
"title": "Create illustration for upcoming holidays",
"card_id": "42",
"user_id": "us4Fsfed",
"project_id": "3",
"board_id": "15",
"board_title": "Ideas",
"list_id": "55",
"list_title": "Done",
"list_color": "<string>",
"status": "started"
},
"similarity": 0.8
}
}
],
"estimate": 2,
"epic": {
"id": "e-123",
"title": "Epic Title",
"icon": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup"
}
},
"cover_image": {
"type": "image",
"src": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==",
"id": "<string>",
"blurhash": "LEHV6nWB2yk8pyoJadR*.7kCMdnj",
"color": "black",
"emoji": "thumbsup",
"positionY": 123,
"object_fit": "contain"
},
"copied_from_card_id": "<string>",
"form_id": "<string>",
"form_values": {},
"form_participants": [
"<string>"
],
"external_request": {
"source": "published_agent",
"external_conversation": {
"publication_id": "pub_01JB7Q4Z8XKQ3N6V2W1Y9T5R0M",
"conversation_id": "xc_01JB7Q5B2C3D4E5F6G7H8J9K0L",
"actor_id": "xa_01JB7Q5RZ0Y1X2W3V4U5T6S7R8",
"audience": "anonymous",
"agent_id": "<string>",
"app_id": "<string>"
},
"source_label": "Published agent · anonymous",
"display_name": "<string>",
"redacted": true
},
"suggested_branch_name": "<string>",
"customers": [
{
"id": "cu_01J9Z8Y7X6W5V4T3S2R1Q0P9N8",
"name": "Acme",
"logo_url": "<string>",
"tier_id": "<string>",
"status_id": "<string>",
"owner_id": "<string>",
"revenue": 123,
"size": 123,
"important": true
}
],
"customer_count": 123,
"customer_important_count": 123,
"customer_revenue": 123
}
}{
"code": 402,
"error": "plan_limit_reached",
"resource": "board",
"limit": 25,
"current": 25,
"limit_kind": "boards_per_workspace",
"id": "err5f744ab",
"sec": "SEC:000-00014",
"message": "plan limit reached: board (25 of 25)",
"date": 1608742037016
}{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}