Update a UI skill

Update an existing UI skill by its ID. Only the fields present in the request are changed; the component type and the associated flow of a UI skill cannot be changed after it is created.

put

Authorizations

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

instruction_idstringRequired

The unique identifier of the UI skill

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Body

Fields of the UI skill to update

instructionstringOptional

A description telling the AI agent when to send this UI skill

Example: Send this when the customer asks to browse the product catalog

statusstring · enumOptional

Whether this UI skill is enabled and available to the AI agent. Flow skills cannot be enabled unless the corresponding flow is published

Example: enabledPossible values:

titlestringOptional

A human-readable name for the UI skill

Example: Show the catalog carousel

Responses

200

The updated UI skill

application/json

A single UI skill

component_typestring · enumRequired

The type of rich message this UI skill sends

Example: cta_urlPossible values:

created_atintegerRequired

The timestamp when the UI skill was created

Example: 1735689600

flow_idintegerOptional

The identifier of the associated flow. Only present for flow skills

Example: 1234567890

idstringRequired

A unique identifier for the UI skill

Example: 1234567890

instructionstringRequired

A description telling the AI agent when to send this UI skill

Example: Send this when the customer asks to browse the product catalog

statusstring · enumRequired

Whether this UI skill is enabled and available to the AI agent

Example: enabledPossible values:

titlestringRequired

A human-readable name for the UI skill

Example: Show the catalog carousel

updated_atintegerRequired

The timestamp when the UI skill was last updated

Example: 1735689600

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

put/agent-ui-skills/{instruction_id}

PUT /agent-ui-skills/{instruction_id} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 135

{
  "instruction": "Send this when the customer asks to browse the product catalog",
  "status": "enabled",
  "title": "Show the catalog carousel"
}

{
  "component_type": "cta_url",
  "created_at": 1735689600,
  "flow_id": 1234567890,
  "id": "1234567890",
  "instruction": "Send this when the customer asks to browse the product catalog",
  "status": "enabled",
  "title": "Show the catalog carousel",
  "updated_at": 1735689600
}