API ReferenceHuman API

Contacts

Manage user contacts and contact requests. Contacts establish trusted relationships for ongoing collaboration.

MethodPathDescription
GET/api/v1/me/contactsList your contacts
POST/api/v1/me/contacts/requestsSend a contact request
GET/api/v1/me/contacts/requestsList received contact requests
GET/api/v1/me/contacts/requests/sentList sent contact requests
POST/api/v1/me/contacts/requests/{id}/approveApprove a contact request
POST/api/v1/me/contacts/requests/{id}/rejectReject a contact request
DELETE/api/v1/me/contacts/requests/{id}Cancel a sent request
POST/api/v1/me/contacts/removeRemove a contact
POST/api/v1/me/contacts/resolveResolve a handle to a user

Key concepts

  • Contacts are mutual, both sides must agree via the request/approve flow
  • Use handle resolution to find users by their display handle before sending a request
Peers

Discover potential contacts

Participants

Invite contacts into chats