POST /boards/

Create a new board.

Servers

Query parameters

Name Type Required Description
prefs_cardAging String No

Determines the type of card aging that should take place on the board if card aging is enabled. One of: pirate, regular.

Possible values:

  • "regular"
  • "pirate"

Default value: "regular"

defaultLists Boolean No

Determines whether to add the default set of lists to a board (To Do, Doing, Done). It is ignored if idBoardSource is provided.

Default value: true

powerUps String No

The Power-Ups that should be enabled on the new board. One of: all, calendar, cardAging, recap, voting.

Possible values:

  • "calendar"
  • "cardAging"
  • "voting"
  • "all"
  • "recap"
desc String No

A new description for the board, 0 to 16384 characters long

keepFromSource String No

To keep cards from the original board pass in the value cards

Possible values:

  • "cards"
  • "none"

Default value: "none"

prefs_comments String No

Who can comment on cards on this board. One of: disabled, members, observers, org, public.

Possible values:

  • "org"
  • "disabled"
  • "public"
  • "members"
  • "observers"

Default value: "members"

prefs_cardCovers Boolean No

Determines whether card covers are enabled.

Default value: true

prefs_invitations String No

Determines what types of members can invite users to join. One of: admins, members.

Possible values:

  • "admins"
  • "members"

Default value: "members"

prefs_background String No

The id of a custom background or one of: blue, orange, green, red, purple, pink, lime, sky, grey.

Possible values:

  • "lime"
  • "grey"
  • "sky"
  • "red"
  • "purple"
  • "blue"
  • "pink"
  • "orange"
  • "green"

Default value: "blue"

defaultLabels Boolean No

Determines whether to use the default set of labels.

Default value: true

name String Yes

The new name for the board. 1 to 16384 characters long.

idBoardSource String No

The id of a board to copy into the new board.

idOrganization String No

The id or name of the Workspace the board should belong to.

prefs_permissionLevel String No

The permissions level of the board. One of: org, private, public.

Possible values:

  • "org"
  • "public"
  • "private"

Default value: "private"

prefs_voting String No

Who can vote on this board. One of disabled, members, observers, org, public.

Possible values:

  • "org"
  • "disabled"
  • "public"
  • "members"
  • "observers"

Default value: "disabled"

prefs_selfJoin Boolean No

Determines whether users can join the boards themselves or whether they have to be invited.

Default value: true

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.