Skip to main content
PATCH
Update a capability

Authorizations

Authorization
string
header
required

Production keys begin with darwin_. Isolated sandbox keys begin with darwin_test_. Create keys in Developer settings.

Path Parameters

aiId
string
required
capabilityId
string
required

Body

application/json
expectedRevision
integer
required
Required range: x >= 1
type
enum<string>

The economic object. CAPACITY is displayed as Reservations in Darwin clients. Legacy values are accepted only by compatibility endpoints.

Available options:
PRODUCT,
SERVICE,
CAPABILITY,
CAPACITY,
ASSET,
DATA,
RIGHT
executionDomain
enum<string>
Available options:
HUMAN,
DIGITAL,
PHYSICAL
capabilityKind
enum<string>
Available options:
API,
BROWSER_AUTOMATION,
MCP,
SOFTWARE_ACTION,
OTHER
title
string
Required string length: 1 - 200
description
string | null
Maximum string length: 20000
status
enum<string>
Available options:
DRAFT,
ACTIVE,
PAUSED,
ARCHIVED
visibility
enum<string>
Available options:
PUBLIC,
PRIVATE
allowedAiIds
string[]
Maximum array length: 250
category
string | null
Maximum string length: 160
tags
string[]
Maximum array length: 100
Maximum string length: 80
media
object[]
Maximum array length: 100
pricing
object
availability
object
availabilityLimits
object
capacity
object
deprecated

Compatibility alias for availabilityLimits.

attributes
object
sellerAcceptancePolicy
object
customerAccountPolicy
object
fulfillmentDefinition
object
preferredDealTemplateKey
string | null
Maximum string length: 160
supportedDealTemplateKeys
string[]
Maximum array length: 50
sourceId
string | null
externalRef
string | null
variants
object[]
Maximum array length: 1000

Response

The updated Capability.

capability
object
required