Python SDK
import json
import os
from parable_types_web_api import UpdateAgentSkillInput
from parable_web_api_sdk import ClientConfig, WebApiSDK
sdk = WebApiSDK(
ClientConfig(
base_url=os.environ["PARABLE_API_URL"],
auth_token=os.environ["PARABLE_API_TOKEN"],
default_headers={"X-Tenant": os.environ["PARABLE_WORKSPACE"]},
)
)
input_data = UpdateAgentSkillInput.model_validate(
json.loads("{\"displayTitle\":\"example\",\"name\":\"example\",\"icon\":\"example\",\"description\":\"example\",\"content\":\"example\",\"files\":[],\"expectedRevision\":1}"),
)
result = sdk.agent_skills.update_agent_skill('example', input_data)sdk, err := webapisdk.New(webapisdk.SDKConfig{
BaseURL: os.Getenv("PARABLE_API_URL"),
Auth: &webapisdk.AuthConfig{Token: os.Getenv("PARABLE_API_TOKEN")},
RequestInterceptor: func(ctx context.Context, req *http.Request) error {
req.Header.Set("X-Tenant", os.Getenv("PARABLE_WORKSPACE"))
return nil
},
})
if err != nil {
return err
}
var input webapitypes.UpdateAgentSkillInput
if err := json.Unmarshal([]byte(`{"displayTitle":"example","name":"example","icon":"example","description":"example","content":"example","files":[],"expectedRevision":1}`), &input); err != nil {
return err
}
result, err := sdk.AgentSkillsNamespace.UpdateAgentSkill(ctx, "example", input){
"data": {
"content": "<string>",
"contentDigest": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"displayTitle": "<string>",
"files": [
{
"content": "<string>",
"path": "<string>"
}
],
"icon": "<string>",
"id": "<string>",
"name": "<string>",
"revision": 0,
"updatedAt": "2023-11-07T05:31:56Z"
},
"meta": {
"requestId": "<string>",
"totalCount": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"next": "<string>",
"prev": "<string>"
}
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}Update a Power
Updates a Power’s details and Markdown instructions. Accepted Ponder Messages and Process Runs retain their captured Power instructions.
PATCH
/
api
/
agent-skills
/
{skillId}
Python SDK
import json
import os
from parable_types_web_api import UpdateAgentSkillInput
from parable_web_api_sdk import ClientConfig, WebApiSDK
sdk = WebApiSDK(
ClientConfig(
base_url=os.environ["PARABLE_API_URL"],
auth_token=os.environ["PARABLE_API_TOKEN"],
default_headers={"X-Tenant": os.environ["PARABLE_WORKSPACE"]},
)
)
input_data = UpdateAgentSkillInput.model_validate(
json.loads("{\"displayTitle\":\"example\",\"name\":\"example\",\"icon\":\"example\",\"description\":\"example\",\"content\":\"example\",\"files\":[],\"expectedRevision\":1}"),
)
result = sdk.agent_skills.update_agent_skill('example', input_data)sdk, err := webapisdk.New(webapisdk.SDKConfig{
BaseURL: os.Getenv("PARABLE_API_URL"),
Auth: &webapisdk.AuthConfig{Token: os.Getenv("PARABLE_API_TOKEN")},
RequestInterceptor: func(ctx context.Context, req *http.Request) error {
req.Header.Set("X-Tenant", os.Getenv("PARABLE_WORKSPACE"))
return nil
},
})
if err != nil {
return err
}
var input webapitypes.UpdateAgentSkillInput
if err := json.Unmarshal([]byte(`{"displayTitle":"example","name":"example","icon":"example","description":"example","content":"example","files":[],"expectedRevision":1}`), &input); err != nil {
return err
}
result, err := sdk.AgentSkillsNamespace.UpdateAgentSkill(ctx, "example", input){
"data": {
"content": "<string>",
"contentDigest": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"displayTitle": "<string>",
"files": [
{
"content": "<string>",
"path": "<string>"
}
],
"icon": "<string>",
"id": "<string>",
"name": "<string>",
"revision": 0,
"updatedAt": "2023-11-07T05:31:56Z"
},
"meta": {
"requestId": "<string>",
"totalCount": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"next": "<string>",
"prev": "<string>"
}
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}Access
This operation needs a Parable token. An MCP token cannot call it. See Authentication for the kinds of token. Your roles must granttenant.parables.manage.
Errors
HTTP 400: The Agent Skill identifier or update input is invalid. Use a valid identifier and correct the update input.HTTP 401: The request is not authenticated. Sign in and select the Workspace.HTTP 403: You cannot manage Agent Skills in this Workspace. Use a Workspace where you can manage Parables.HTTP 404: The Agent Skill does not exist in this Workspace. Choose an Agent Skill returned by the current Workspace catalog.HTTP 409: The Skill changed after the expected revision or another Skill uses the requested name. Reload the Skill, preserve concurrent changes, and retry with the current revision and an unused name.
Authorizations
Headers
Path Parameters
Body
application/json
Serialized icon spec: fa:{pack}:{weight}-{fill}:{name} such as fa:classic:regular-outline:circle-check (weight and fill joined by one hyphen), emoji:{glyph}, or image:{url}
Required string length:
1 - 2048Pattern:
^(?:fa:[a-z0-9]+(?:-[a-z0-9]+)*:[a-z0-9]+-[a-z0-9]+(?:-[a-z0-9]+)*:[a-z0-9]+(?:-[a-z0-9]+)*(?:@#[0-9a-f]{6})?|emoji:\S+|image:\S+)$