vPlan
  1. Endpoints
  2. Card Data
vPlan
  • General
    • Structure
    • Synchronize Data
    • Pagination
    • Sorting
    • Filtering
    • Show & Hide
    • Eager Loading
    • Deep Insertion
    • Deprecated
    • External Reference
    • Rate Limits
    • Authentication
      • Authentication
        • Get authorization
        • Token Exchange
      • Me
        • Retrieve information about current authentication
    • Errors
      • Empty values in created object
      • Memory Exhausted
      • Report an issue
      • Service Unavailable
      • Retrieve Api Messages
  • Endpoints
    • Base Data
      • Board
        • Label
        • Status
        • Capacity
          • Capacity Stage
          • Capacity Resource Type Stage
          • Capacity Resource
          • Capacity Group
        • Retrieve Board List
        • Create New Board
        • Retrieve Single Board
        • Update Single Board
        • Remove Single Board
      • Stage
        • Retrieve Stage List
        • Create New Stage
        • Retrieve Single Stage
        • Update Single Stage
        • Remove Single Stage
      • Activity
        • Retrieve Activity List
        • Create New Activity
        • Retrieve Single Activity
        • Update Single Activity
        • Remove Single Activity
      • Resource
        • Retrieve Resource List
        • Create New Resource
        • Retrieve Single Resource
        • Update Single Resource
        • Remove Single Resource
      • Schedule
        • Retrieve Schedule List
        • Retrieve Schedule Year
        • Retrieve Schedule Month
        • Schedule Retrieve Day
      • Group
        • Retrieve Group List
        • Create New Group
        • Retrieve Single Group
        • Update Single Group
        • Remove Single Group
      • User
        • Retrieve User List
        • Retrieve Single User
        • Update Single User
    • Card Data
      • Collection
        • Custom Fields
          • Update Custom Field By Name
          • Delete Custom Field By Name
        • Retrieve Collection List
        • Create New Collection
        • Retrieve Single Collection
        • Update Single Collection
        • Remove Single Collection
        • Move Collection to Backlog
        • Move Collection to Board
      • Card
        • Custom Field
          • Update Custom Field By Name
          • Delete Custom Field By Name
        • Retrieve Card List
        • All Cards List
        • Create New Card
        • Retrieve Single Card
        • Update Single Card
        • Remove Single Card
        • Split Card
      • Attachment
        • Retrieve Attachment List
        • Upload New Attachment
        • Add New Attachment Link
        • Retrieve Single Attachment
        • Remove Single Attachment
      • Comment
        • Retrieve Comment List
        • Create New Comment
        • Retrieve Single Comment
        • Update Single Comment
        • Remove Single Comment
      • Checklist
        • Collection
          • Retrieve Collection Checklist List
          • Create New Collection Checklist
          • Retrieve Single Collection Checklist
          • Update Single Collection Checklist
          • Remove Single Collection Checklist
        • Card
          • Retrieve Card Checklist List
          • Create New Card Checklist
          • Retrieve Single Card Checklist
          • Update Single Card Checklist
          • Remove Single Card Checklist
      • Time Tracking
        • Retrieve TimeTracking List
        • Create New TimeTracking
        • Retrieve Single TimeTracking
        • Update Single TimeTracking
        • Remove Single TimeTracking
        • Export TimeTracking
      • Relations between cards
        • Retrieve CardRelation List
        • Create New CardRelation
        • Retrieve Single CardRelation
        • Remove Single CardRelation
    • Order Data
      • Address
      • Order
        • Retrieve Order List
        • Create New Order
        • Retrieve Single Order
        • Update Single Order
        • Remove Single Order
      • Row
        • Retrieve OrderRow List
        • Create New OrderRow
        • Retrieve Single OrderRow
        • Update Single OrderRow
        • Remove Single OrderRow
      • Item
        • Retrieve Item List
        • Create New Item
        • Retrieve Single Item
        • Update Single Item
        • Remove Single Item
      • Project
        • Retrieve Project List
        • Create New Project
        • Retrieve Single Project
        • Update Single Project
        • Remove Single Project
      • Relation
        • Retrieve Relation List
        • Create New Relation
        • Retrieve Single Relation
        • Update Single Relation
        • Remove Single Relation
      • Warehouse
        • Retrieve Warehouse List
        • Create New Warehouse
        • Retrieve Single Warehouse
        • Update Single Warehouse
        • Remove Single Warehouse
    • Webhook
      • Retrieve Webhook List
      • Create New Webhook
      • Retrieve Single Webhook
      • Update Single Webhook
      • Remove Single Webhook
    • Payload send to webhook url
      • Normal Object
      • Nested Object
      • Nested Object with Pivot
  1. Endpoints
  2. Card Data

Collection

Collections are the starting point of creating work in vPlan. A collection represents a task, order or project to be performed before it is planned. When only creating a collection, it will have no cards and will be places in the backlog of the vPlan board.
It can be created by it self, or by creating an Order.
When planning a collection to a board, vPlan will create one or more cards, depending on the collection details and board settings. Planning a collection, and thus creating cards, can be done by a vPlan user in vPlan, or by a separate API request.
Collection
id
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:
13
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}] 
required
id
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:
0
value
string  | integer  | boolean  | array  | number  | object  | null 
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_checksum
string  | null 
write-onlyoptional
Match pattern:
^[a-fA-F0-9]{64}$
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
Modified at 2024-11-21 17:12:57
Previous
Update Single User
Next
Update Custom Field By Name
Built with