latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21340457963.9 KB

2f82328f5184

library

private

Update Library Agent

Update the library agent with the given fields.

patch/api/library/agents/{library_agent_id}

Path parameters

library_agent_idstring required

Request body

auto_update_versionboolean nullable

Auto-update the agent version

graph_versioninteger nullable

Specific graph version to update to

is_favoriteboolean nullable

Mark the agent as a favorite

is_archivedboolean nullable

Archive the agent

is_hiddenboolean nullable

Whether to hide the agent from the library listing

folder_idstring nullable

Folder ID to move agent to (None to move to root)

Response

Successful Response

idstring required

graph_idstring required

graph_versioninteger required

image_urlstring nullable required

creator_namestring required

creator_image_urlstring required

status'COMPLETED' | 'HEALTHY' | 'WAITING' | 'ERROR' required

created_atstring date-time required

updated_atstring date-time required

last_run_atstring date-time nullable

namestring required

descriptionstring required

instructionsstring nullable

input_schemaobject required

output_schemaobject required

credentials_input_schemaobject nullable required

Input schema for credentials required by the agent

has_external_triggerboolean required

Whether the agent has an external trigger (e.g. webhook) node

has_human_in_the_loopboolean required

Whether the agent has human-in-the-loop blocks

has_sensitive_actionboolean required

Whether the agent has sensitive action blocks

new_outputboolean required

execution_countinteger

success_ratenumber nullable

avg_correctness_scorenumber nullable

can_access_graphboolean required

Indicates whether the same user owns the corresponding graph

is_latest_versionboolean required

is_favoriteboolean required

folder_idstring nullable

folder_namestring nullable

is_hiddenboolean

recommended_schedule_cronstring nullable

is_scheduledboolean

Whether this agent has active execution schedules

next_scheduled_runstring nullable

ISO 8601 timestamp of the next scheduled run, if any

store_listing_version_idstring nullable

ID of the approved marketplace listing version whose graph snapshot exactly matches this agent's graph_id and graph_version. Install flows can use it directly to install this exact version.