Skip to main content
POST
Reject a version

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

version_id
string<uuid>
required

The version's ID.

Body

application/json

A reason, required to reject and to withdraw.

reason
string
default:""
Maximum string length: 2000

Response

Successful Response

An artifact with all its versions.

id
string<uuid>
required
kind
enum<string>
required

What an artifact is.

Available options:
agent,
skill,
mcp_server,
tool,
context_pack,
ontology,
prompt,
workflow,
brand,
code_repo
scope
enum<string>
required

Who an artifact is for. tenant is shown as "Global".

Available options:
personal,
tenant
name
string
required
display_name
string
required
description
string
required
owner_id
string
required
is_system
boolean
required
updated_at
string<date-time>
required
versions
ArtifactVersionResponse · object[]
required
parent_artifact_id
string<uuid> | null
promoted_from_artifact_id
string<uuid> | null
latest_version
string | null

Newest version of any status.

latest_status
enum<string> | null

Lifecycle of one version.

Available options:
draft,
submitted,
approved,
rejected,
deprecated,
withdrawn
latest_approved_version
string | null
has_draft
boolean
default:false
used_in_templates
integer
default:0
used_in_agents
integer | null

Context packs only: visible agents whose newest version loads it.

write
boolean | null

Tools only: effective write flag.

needs_sign_off
boolean | null

Tools only: a write tool not yet signed off.

sensitivity
string | null

Context packs only: the newest approved version's effective sensitivity.

health
enum<string> | null

Context packs only: whether its items resolve.

Available options:
ok,
stale,
broken
can_use
boolean
default:true

False: you are limited and it is given to you to view only.