Agent Connections

set Agent Connection Visibility

Changed on Nov 3, 2026

Hide, unhide, pin or unpin an agent. hidden:true hides it until someone unhides it and clears any pin. hidden:false shows it again and restarts its idle clock, so the idle sweep does not hide it again until it has been idle for the full threshold from now. keep_visible:true pins it visible: it is shown and never hidden for idleness. keep_visible:false removes the pin. hidden:true together with keep_visible:true is rejected. Never changes the connection status, its credential or mail delivery. A current personal owner may change their own agents; organization owners and admins may change any.

patch/agent-connections/{address}/visibility

Request

Base URL
https://api.primitive.dev/v1
URL
https://api.primitive.dev/v1/agent-connections/{address}/visibility
Auth
HTTP bearer

Path parameters

addressstring email required

address for agent connections.

Request body

hiddenboolean

keep_visibleboolean

Response

Success

successunknown required

Changes

Nov 3, 2026bce409c97acb Revision changes
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new access_mode_unavailable enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new builtin_role enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cleanup_incomplete enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new cli_access_refused enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new confirmation_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new connection_owner_address_required enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_author_only enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_compiler_unavailable enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_conflict enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new email_rule_not_compiled enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new grant_forbidden enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new keep_refused enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new last_owner enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_not_claimable enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new mailbox_shared_with_others enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new member_address_reserved enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new plan_required enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new redeploy_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_failed enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new removal_timeout enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assigned enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_assignment_unavailable enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new role_key_taken enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_in_progress enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new rotation_incomplete enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_invalid enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_not_accepted enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_refused enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new step_up_required enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new template_role enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
- warning
  added the new upstream_unavailable enum value to the / response property for the response status
This list may be incomplete.
Oct 21, 20260360ea8d4f3d Revision changes
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_changed enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new agent_limit enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new already_member enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new directory_limit enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_accepted enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_changed enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_pending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_sending enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitation_unconfirmed enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new invitations_pending enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new member_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new project_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status
- warning
  added the new recipient_changed enum value to the / response property for the response status

Operation history (6 revisions)