Move Collection to Board

Move a not planned collection to Board and create Cards accordingly

NOTE

Creating cards is an asynchronous process,
new cards are almost but not instantly created

Request

Path Params

collection_id

string

required

board_id

string

required

Query Params

show

string

optional

limit the response to show only specific properties, see show & hide for more info

Example:

id,updated_at

hide

string

optional

hide properties from the response, see show & hide for more info

Example:

created_at,updated_at

Header Params

x-api-key

string

required

Default:

x-api-env

string

required

Default:

Body Params application/json

start

string <date>

optional

Date for the first created card

force_stages

array[string <uuid>]

optional

Example:

["1ce1e25a-b64d-46d1-b38a-e05fd5717ac0","86bd3ad5-4d76-4aa3-a15a-b0bf0c62d87d","c8d4b144-a29f-480e-a28d-251f5cd8a477"]

before

string <uuid> | null

optional

Collection is planned before this card_id

Example:

null

after

string <uuid> | null

optional

Collection is planned after this card_id

Example:

null

resources

array[string <uuid>]

optional

Resources added to the first created card

Example:

["a225c108-a6ca-4343-8e10-fe10c841a688","d55ca612-5eab-4153-990a-7f7e059b184e","90a8e6da-6bc6-4ff8-95d7-ee73b0908928"]

reverse

boolean

optional

stage_id

string <uuid>

optional

Stage for the first created card

Example:

1ce1e25a-b64d-46d1-b38a-e05fd5717ac0

status_id

string <uuid>

optional

Status of the first card to be created

Example:

3c9fceef-c7ae-4bff-8450-f1a7b4dd47d8

Example

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

string <uuid>

read-onlyoptional

Unique identifier

name

string

optional

Example:

Order 10199

description

string | null

optional

Example:

3x Chair Lissabon

start

string <date> | null

read-onlyoptional

Earliest date from its Cards

Example:

2020-01-02

end

string <date> | null

read-onlyoptional

Latest date from its Cards

Example:

2020-08-13

due_date

string <date> | null

optional

Example:

2020-01-02

meta

object | null

read-onlyoptional

Hashmap with additional information for the collection, received via Order

Example:

{"bar":"foo","baz":"quux"}

Additional properties

string

optional

position

integer | null

read-onlyoptional

Position in the backlog, if collection is planned the postion will be null

Example:

source_type

enum<string>

read-onlyoptional

States if the collection is created directly (custom), by cloning a collection or via an Order

Allowed values:

customorderclone

Default:

custom

status

enum<string>

optional

Status of the collection

planned

collection is planned, and has cards visible on a board

not_planned

collection is on backlog

ignored

collection is in the archive

WARNING

On update the status can only be changed from ignored to not_planned or from not_planned to ignored.

For other actions please look at:

Move Collection to Backlog

Move Collection to Board

Allowed values:

plannednot_plannedignored

Example:

not_planned

progress

enum<string>

read-onlyoptional

progress of the cards within the collection

open - all cards are on the first status

partial - not all cards are on the first or last status

done - all cards are on the last status

Allowed values:

openpartialdone

Example:

open

warnings

array[string]

read-onlyoptional

Example:

[]

custom_fields

array[object (CustomField) {13}] | null

required

string <uuid>

read-onlyoptional

Unique identifier

name

string

optional

Name of the field

Example:

Weight

type

enum<string>

optional

Allowed values:

textnumberdatecheckboxemaillinkphonelistselectaddressdrawingtextareausers

Default:

text

Example:

number

scope

enum<string>

optional

Allowed values:

collectioncard

priority

integer

optional

Priority of the custom field in which the fields are ordered in the frontend

Example:

value

optional

drawing_id

string <uuid>

optional

components

object (CustomFieldOptionsAddress)

optional

list

array [object {3}]

optional

selected

object

optional

options

optional

Extra settings for number, select or list types

created_at

string <date-time>

read-onlyoptional

Date and time of creation

Example:

2024-04-11T10:22:15Z

updated_at

string <date-time>

read-onlyoptional

Date and time of last update

Example:

2024-04-11T10:22:15Z

board_id

string <uuid>

required

Unique identifier of the Board

cover_image_url

string <uri> | null

optional

cover_image_signature

string | null

read-onlyoptional

cover_image_bytes

integer

read-onlyoptional

>= 0

cover_color_hex

string | null

optional

Examples:

#FFF#8d46e0

Match pattern:

^#([A-Fa-f0-9]{3}){1,2}$

external_ref

string | null

read-onlyoptional

Third-party reference of the object, for informational purposes only

Example:

fb1033a2ed70

created_at

string <date-time>

read-onlyoptional

Date and time of creation

Example:

2024-04-11T10:22:15Z

updated_at

string <date-time>

read-onlyoptional

Date and time of last update

Example:

2024-04-11T10:22:15Z

Example

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "Order 10199",
  "description": "3x Chair Lissabon",
  "start": "2020-01-02",
  "end": "2020-08-13",
  "due_date": "2020-01-02",
  "meta": {
    "bar": "foo",
    "baz": "quux"
  },
  "position": 13,
  "source_type": "custom",
  "status": "planned",
  "progress": "open",
  "warnings": [],
  "custom_fields": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "Weight",
      "type": "text",
      "scope": "collection",
      "priority": 0,
      "value": "string",
      "drawing_id": "19ba6f6f-3365-4d74-bdc5-b3df4072c0ab",
      "components": {
        "latitude": 52.3156048,
        "longitude": 6.496432,
        "country": "Netherlands",
        "city": "Rijssen",
        "postal_code": "7462TB",
        "street1": "Hogepad 83",
        "street2": "Second floor"
      },
      "list": [
        {
          "name": "string",
          "value": "string",
          "color": "transparent"
        }
      ],
      "selected": {
        "name": "string",
        "value": "string",
        "color": ""
      },
      "options": {
        "unit": "kg",
        "align": "left",
        "decimals": 2
      },
      "created_at": "2024-04-11T10:22:15Z",
      "updated_at": "2024-04-11T10:22:15Z"
    }
  ],
  "board_id": "75e8c400-2dbc-43a3-9af4-ff9e6c099385",
  "cover_image_url": "http://example.com",
  "cover_image_signature": "string",
  "cover_image_bytes": 0,
  "cover_color_hex": "#FFF",
  "external_ref": "fb1033a2ed70",
  "created_at": "2024-04-11T10:22:15Z",
  "updated_at": "2024-04-11T10:22:15Z"
}

🟠412Precondition Failed

🟠422Unprocessable Content

🟠404Not Found

🟠401Not Logged In