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.

Changes

Changed in 6 of the 92 revisions of this API.46

Aug 17, 202660277099c3041See the full diff
- ○
  added the optional property store_listing_version_id to the response with the 200 status
  response-optional-property-added
Jul 23, 2026195ddd3884ff1See the full diff
- ○
  added the optional property last_run_at to the response with the 200 status
  response-optional-property-added
May 9, 2026f3fe325e083c2See the full diff
- ○
  added the new optional request property is_hidden
  new-optional-request-property
- ○
  added the optional property is_hidden to the response with the 200 status
  response-optional-property-added
May 9, 2026e90a755fa9e12See the full diff
- ●
  removed the request property is_hidden
  request-property-removed
- ●
  removed the optional property is_hidden from the response with the 200 status
  response-optional-property-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 7, 2026937cd0cdc5792See the full diff
- ○
  added the new optional request property is_hidden
  new-optional-request-property
- ○
  added the optional property is_hidden to the response with the 200 status
  response-optional-property-added
Apr 30, 20268c84efcb3afb2See the full diff
- ●
  removed the request property is_hidden
  request-property-removed
- ●
  removed the optional property is_hidden from the response with the 200 status
  response-optional-property-removed
This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history