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

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 [object {1}]

optional

Resources added to the first created card

Example:

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

string <uuid>

required

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

{
    "start": "2019-08-24",
    "force_stages": [
        "1ce1e25a-b64d-46d1-b38a-e05fd5717ac0",
        "86bd3ad5-4d76-4aa3-a15a-b0bf0c62d87d",
        "c8d4b144-a29f-480e-a28d-251f5cd8a477"
    ],
    "before": null,
    "after": null,
    "resources": [
        "a225c108-a6ca-4343-8e10-fe10c841a688",
        "d55ca612-5eab-4153-990a-7f7e059b184e",
        "90a8e6da-6bc6-4ff8-95d7-ee73b0908928"
    ],
    "reverse": true,
    "stage_id": "1ce1e25a-b64d-46d1-b38a-e05fd5717ac0",
    "status_id": "3c9fceef-c7ae-4bff-8450-f1a7b4dd47d8"
}

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

required

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