Import a board

Creates a new board from an uploaded Trello, Jira, Asana, CSV or craaft export. It never writes into an existing board. Takes the same fields as POST /imports/preview and runs the same parse. All or nothing: a failed import leaves no board behind. The board is private; each matched assignee listed in the preview's access is added to it as a contributor. A craaft export's board description comes across. No notifications are sent (no emails, mention, assignment or follower notifications, no Slack or Discord messages). The new board counts against the workspace's board cap.

If the board is created but reloading it fails, the 201 still carries at least id and name.

post/imports

Request

  • Base URL: https://craaft.io/api/v1
  • URL: https://craaft.io/api/v1/imports
  • Auth: HTTP bearer

Response

Created. Shaped like the POST /projects response.

idstring uuid required
workspaceIdstring uuid required
namestring required
descriptionstring
isFavoriteboolean
publicTokenstring

Non-empty when public sharing is on

backgroundImagestring
backgroundColorstring

Board background hex color (#rrggbb), empty when unset; mutually exclusive with backgroundImage

colorSchemestring
textColor'dark' | 'light'
showMilestonesboolean

Whether the board's top bar shows the milestones button. Default true.

showArchivedboolean

Whether the board's top bar shows the archived cards button. Default true.

showFilesboolean

Whether the board's top bar shows the files button. Default true.

showStandupboolean

Whether the board's top bar shows the standup button. Default true.

showActivityboolean

Whether the board's top bar shows the activity button. Default false. The /projects/{id}/activity feed answers either way.

myRole'owner' | 'admin' | 'member'

Caller's role in the project's workspace (distinct from myBoardRole).

visibility'private' | 'workspace'

private (default): only users with an explicit grant (plus workspace owners/admins) see the board. workspace: every workspace member is an implicit contributor.

myBoardRole'admin' | 'contributor'

Caller's effective role on the board. Workspace owners and admins are always admin; explicit grants resolve to admin or contributor; on a workspace-visibility board, plain workspace members default to contributor.

canUploadAttachmentsboolean

Whether cards on this board accept file attachments. Reflects the board's workspace plan (Pro), NOT the caller's own plan - so a Free user collaborating on a Pro workspace's board sees true. Matches the server's upload gate; the SPA uses it to show/hide the attachment dropzone.

totalCardsinteger
columnCountsobject
workspaceNamestring

Workspace display name; populated on list responses.

createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.