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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".
Body
application/json
Card object that needs to be created
Example:
"My Card"
Example:
"114"
Maximum string length:
102400Example:
"Some card content"
Format of the content field. When set to 'markdown', the server converts the content from GitHub Flavored Markdown to HTML before storage. Defaults to 'html'.
Available options:
html, markdown Existing file IDs to duplicate and associate with the created card. Use for files already uploaded to this workspace, such as files attached to an agent run.
Example:
1
unix timestamp in seconds
Example:
1608742037016
unix timestamp in seconds
Example:
1608742037016
Example:
"5"
Example:
"1"
Example:
"8"
Show child attributes
Show child attributes
Required range:
0 <= x <= 4Example:
1
effort estimation enum for the card. 1 is least, 5 is greatest. will map to different values depending on project settings.
Required range:
1 <= x <= 5Example:
3
Optional card ID to set as parent
Optional epic ID to add card to
Optional Board Email reference when creating a card from an email
Example:
"b291eKoaaLn5"
describes a user or robot that created or updated a resource
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Optionally specify checklist(s) to create and add to the card
Show child attributes
Show child attributes
ID of the form that created this card, if any
ID of the user that created this card from form submission
Response
Card created
Show child attributes
Show child attributes
⌘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
}
}