Publish an artifact's latest version

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/artifacts/{slug}/publish-head/"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/artifacts/{slug}/publish-head/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "title": "<string>",
  "semantic_type": "brief",
  "technical_type": "markdown",
  "in_scope": true,
  "display_order": 123,
  "group": "<string>",
  "definition_short": "<string>",
  "head_version_number": 123,
  "head_updated_at": "2023-11-07T05:31:56Z",
  "version_count": 123,
  "can_delete": true,
  "definition_long": "<string>",
  "format_description": "<string>",
  "capture_discipline": "<string>",
  "selected_version_number": 123,
  "payload": "<unknown>"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

POST

projects

{project_id}

artifacts

{slug}

publish-head

Publish an artifact's latest version

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/artifacts/{slug}/publish-head/"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/artifacts/{slug}/publish-head/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "title": "<string>",
  "semantic_type": "brief",
  "technical_type": "markdown",
  "in_scope": true,
  "display_order": 123,
  "group": "<string>",
  "definition_short": "<string>",
  "head_version_number": 123,
  "head_updated_at": "2023-11-07T05:31:56Z",
  "version_count": 123,
  "can_delete": true,
  "definition_long": "<string>",
  "format_description": "<string>",
  "capture_discipline": "<string>",
  "selected_version_number": 123,
  "payload": "<unknown>"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer

Path Parameters

project_id

string<uuid>

required

UUID of the project

slug

string

required

Response

Updated artifact

string<uuid>

slug

string

title

string

semantic_type

enum<string>

What the artifact means in the knowledge store. Predefined types are seeded by the platform; custom artifacts are user-created.

Available options:

brief,

project_plan,

mental_map,

general_knowledge,

playbooks,

library_description,

design_templates,

custom

technical_type

enum<string>

Storage/editing format of the artifact's payload — string for markdown and bpmn_xml, object for mental_map, array for playbook_list and design_template_list.

Available options:

markdown,

mental_map,

playbook_list,

design_template_list,

bpmn_xml

in_scope

boolean

display_order

integer

group

string

Catalog group label; empty for predefined artifacts (their section derives from semantic_type) and for ungrouped custom ones. "Foundation" and "Other" are reserved for UI-derived sections and cannot be set; the four standard section names ("Project Management", …) are NOT reserved — a custom artifact may use one to file itself alongside the predefined artifacts.

definition_short

string

head_version_number

integer | null

head_updated_at

string<date-time> | null

version_count

integer

can_delete

boolean

definition_long

string

format_description

string

Custom artifacts only; empty string for predefined types.

capture_discipline

string

Custom artifacts only; empty string for predefined types.

selected_version_number

integer | null

payload

any

Content of the selected version; shape depends on technical_type. Null when the artifact has no versions.