Skip to main content
POST
/
api
/
v1
/
boards
Create Board
curl --request POST \
  --url https://api.example.com/api/v1/boards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "settings": {
    "bug_test_gate_min_severity": "minor",
    "cognitive_llm_config": {},
    "max_drift": 50,
    "max_scenarios_per_card": 3,
    "max_spec_ambiguity": 30,
    "min_completeness": 80,
    "min_confidence": 70,
    "min_spec_assertiveness": 80,
    "min_spec_completeness": 80,
    "require_spec_validation": false,
    "require_task_validation": false,
    "require_test_task_for_bug": true,
    "skip_contract_coverage_global": false,
    "skip_decisions_coverage_global": false,
    "skip_rules_coverage_global": false,
    "skip_test_coverage_global": false,
    "skip_test_evidence_global": false,
    "skip_trs_coverage_global": false
  }
}
'
{
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "id": "<string>",
  "name": "<string>",
  "owner_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "agents": [],
  "cards": [],
  "realm_id": "<string>",
  "settings": {
    "bug_test_gate_min_severity": "minor",
    "cognitive_llm_config": {},
    "max_drift": 50,
    "max_scenarios_per_card": 3,
    "max_spec_ambiguity": 30,
    "min_completeness": 80,
    "min_confidence": 70,
    "min_spec_assertiveness": 80,
    "min_spec_completeness": 80,
    "require_spec_validation": false,
    "require_task_validation": false,
    "require_test_task_for_bug": true,
    "skip_contract_coverage_global": false,
    "skip_decisions_coverage_global": false,
    "skip_rules_coverage_global": false,
    "skip_test_coverage_global": false,
    "skip_test_evidence_global": false,
    "skip_trs_coverage_global": false
  }
}

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.

Body

application/json

Schema for creating a board.

name
string
required
Required string length: 1 - 255
description
string | null
settings
BoardSettings · object

Board-level settings for governance rules.

Response

Successful Response

Schema for board response.

created_at
string<date-time>
required
description
string | null
required
id
string
required
name
string
required
owner_id
string
required
updated_at
string<date-time>
required
agents
AgentSummary · object[]
cards
CardResponse · object[]
realm_id
string | null
settings
BoardSettings · object

Board-level settings for governance rules.

Last modified on May 8, 2026