Contacts

list Agent Contacts

Changed on Nov 3, 2026

Organization directory and agent preferences; no profiles, message history or runtime presence. Organization credentials retain tenant directory permissions. Human organization members may read and change agent notification contacts only for personal connections bound to their current membership incarnation; owners and admins may manage all. Connected keys may read the directory, create address-only missing contacts using if_absent:true, and access only their own agent memberships; they cannot edit shared labels or delete directory entries. Function credentials are not granted access. Memberships require an existing local agent connection (including revoked connections) and an existing contact. PUT requires exactly one precondition. if_absent returns an existing row unchanged when supplied fields agree; otherwise 409. notify defaults false. Off-to-on generates a new server timestamp and generation; on-to-on and purpose-only edits preserve them. Disable clears activation metadata. Deletion atomically removes membership eligibility. Receivers must recheck generation/preferences before dispatch and pause admission when their policy cache is older than 30 seconds; explicit reply waits are independent. DELETE requires if_version, returns deleted:false for an absent row, and rejects stale versions of recreated rows. Pages use ascending canonical address, with meta.cursor null on the last page. Lists are live pages, not snapshots.

get/agent-contacts/{agent_address}

Request

Base URL
https://api.primitive.dev/v1
URL
https://api.primitive.dev/v1/agent-contacts/{agent_address}
Auth
HTTP bearer

Path parameters

agent_addressstring email required

Bare email address; trim and lowercase, preserving dots and plus tags.

agent_address for contacts.

Query parameters

cursorstring email

Bare email address; trim and lowercase, preserving dots and plus tags.

cursor for contacts.

limitinteger

limit for contacts.

Response

Success

successtrue 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 (8 revisions)