Skip to main content
POST
/
api
/
v1
/
cards
/
{card_id}
/
move
Move Card
curl --request POST \
  --url https://api.example.com/api/v1/cards/{card_id}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "not_started",
  "completeness": 123,
  "completeness_justification": "<string>",
  "conclusion": "<string>",
  "drift": 123,
  "drift_justification": "<string>",
  "position": 123
}
'
{
  "assignee_id": "<string>",
  "board_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "description": "<string>",
  "details": "<string>",
  "due_date": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "labels": [
    "<string>"
  ],
  "position": 123,
  "priority": "critical",
  "status": "not_started",
  "title": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "action_plan": "<string>",
  "architecture_designs": [],
  "archived": false,
  "attachments": [],
  "card_type": "normal",
  "comments": [],
  "conclusions": [
    {
      "author_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "text": "<string>",
      "completeness": 100,
      "completeness_justification": "",
      "drift": 0,
      "drift_justification": ""
    }
  ],
  "expected_behavior": "<string>",
  "knowledge_bases": [
    {}
  ],
  "linked_test_task_ids": [
    "<string>"
  ],
  "observed_behavior": "<string>",
  "origin_task_id": "<string>",
  "pre_archive_status": "<string>",
  "qa_items": [],
  "screen_mockups": [
    {
      "id": "<string>",
      "title": "<string>",
      "annotations": [
        {
          "id": "<string>",
          "text": "<string>",
          "author_id": "<string>"
        }
      ],
      "description": "<string>",
      "html_content": "",
      "order": 0,
      "screen_type": "page"
    }
  ],
  "severity": "<string>",
  "spec_id": "<string>",
  "sprint_id": "<string>",
  "steps_to_reproduce": "<string>",
  "test_scenario_ids": [
    "<string>"
  ],
  "validations": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

card_id
string
required

Body

application/json

Schema for moving a card between columns.

status
enum<string>
required

Card status enum matching Kanban columns.

Available options:
not_started,
started,
in_progress,
validation,
on_hold,
done,
cancelled
completeness
integer | null
completeness_justification
string | null
conclusion
string | null
drift
integer | null
drift_justification
string | null
position
integer | null

Response

Successful Response

Schema for card response.

assignee_id
string | null
required
board_id
string
required
created_at
string<date-time>
required
created_by
string
required
description
string | null
required
details
string | null
required
due_date
string<date-time> | null
required
id
string
required
labels
string[] | null
required
position
integer
required
priority
enum<string>
required

Card priority levels.

Available options:
critical,
very_high,
high,
medium,
low,
none
status
enum<string>
required

Card status enum matching Kanban columns.

Available options:
not_started,
started,
in_progress,
validation,
on_hold,
done,
cancelled
title
string
required
updated_at
string<date-time>
required
action_plan
string | null
architecture_designs
ArchitectureDesignSummary · object[]
archived
boolean
default:false
attachments
AttachmentResponse · object[]
card_type
string
default:normal
comments
CommentResponse · object[]
conclusions
ConclusionEntry · object[] | null
expected_behavior
string | null
knowledge_bases
Knowledge Bases · object[] | null
linked_test_task_ids
string[] | null
observed_behavior
string | null
origin_task_id
string | null
pre_archive_status
string | null
qa_items
QAResponse · object[]
screen_mockups
ScreenMockup · object[] | null
severity
string | null
spec_id
string | null
sprint_id
string | null
steps_to_reproduce
string | null
test_scenario_ids
string[] | null
validations
Validations · object[] | null
Last modified on May 8, 2026