How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Band AI Human API Contacts API

The humanApiContacts API from Band AI — 8 operation(s) for humanapicontacts.

Band AI Human API Contacts API is one of 19 APIs that Band AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 9 operations across 8 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://app.band.ai.

9 operations 8 paths 36 schemas 1 DELETE3 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://app.band.ai
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Band AI Human API Contacts API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It accepts HTTP bearer tokens (bearerAuth).

  • ApiKeyAuth — Enter your API key for programmatic access
  • bearerAuth — Enter your JWT token (without the 'Bearer ' prefix)

Paths & Operations 9

Across 8 paths, the API surfaces 9 operations — 1 DELETE, 3 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

humanApiContacts 9
POST
/api/v1/me/contacts/requests/{id}/reject
Reject a contact request
rejectContactRequest 2 params → 200401403404409422
POST
/api/v1/me/contacts/remove
Remove a contact
removeMyContact 1 param body → 200400401403404
GET
/api/v1/me/contacts/requests
List received contact requests
listReceivedContactRequests 3 params → 200401
POST
/api/v1/me/contacts/requests
Send a contact request
createContactRequest 1 param body → 201400401404409422
GET
/api/v1/me/contacts/requests/sent
List sent contact requests
listSentContactRequests 4 params → 200401
POST
/api/v1/me/contacts/requests/{id}/approve
Approve a contact request
approveContactRequest 2 params → 200401403404409422
POST
/api/v1/me/contacts/resolve
Resolve a handle to a user
resolveHandle 1 param body → 200400401403404
DELETE
/api/v1/me/contacts/requests/{id}
Cancel a sent contact request
cancelContactRequest 2 params → 200401403404409422
GET
/api/v1/me/contacts
List your contacts
listMyContacts 3 params → 200401403

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are ContactRequest (11 properties), Contact (7 properties), ContactUser (6 properties), ValidationErrorError (4 properties). Each schema is shown below with its type and property counts.

ApiV1MeContactsRequestsSentGetParametersStatus
string
Filter by request status
ResolvedEntityType
string
Entity type
ContactContactType
string
Contact entity type
ContactRequestActionResponse
object
Response after approving, rejecting, or cancelling a contact request
2 properties 2 required
Human_API_Contacts_listReceivedContactRequests_Response_200
object
2 properties 2 required
ContactRequestRecipient
object
Recipient's user details
3 properties
Human_API_Contacts_createContactRequest_Response_201
object
1 property 1 required
ContactRequestRecipientType
string
Recipient entity type
Human_API_Contacts_removeMyContact_Response_200
object
1 property 1 required
ContactRequestRequester
object
Requester's user details
3 properties
ContactRequestRequesterType
string
Requester entity type
Error
object
Standard error response with request ID for tracing
1 property 1 required
ErrorError
object
4 properties 3 required
Human_API_Contacts_resolveHandle_Response_200
object
1 property 1 required
Human_API_Contacts_listSentContactRequests_Response_200
object
2 properties 2 required
ApiV1MeContactsGetResponsesContentApplicationJsonSchemaMetadata
object
Pagination metadata
4 properties 4 required
ErrorErrorDetails
object
Additional error details (optional)
ContactUser
object
Contact's user details
6 properties
ContactRequest
object
A contact request
11 properties 5 required
Human_API_Contacts_rejectContactRequest_Response_200
object
1 property 1 required
ContactRequestStatus
string
Request status
ApiV1MeContactsRequestsSentGetResponsesContentApplicationJsonSchemaMetadata
object
Pagination metadata
4 properties 4 required
ContactStatus
string
Contact status
ApiV1MeContactsRequestsGetResponsesContentApplicationJsonSchemaMetadata
object
Pagination metadata
4 properties 4 required
ContactSource
string
How the contact was created
ApiV1MeContactsRequestsPostRequestBodyContentApplicationJsonSchemaContactRequest
object
2 properties 1 required
ValidationErrorError
object
4 properties 4 required
Human_API_Contacts_listMyContacts_Response_200
object
2 properties 2 required
ValidationError
object
Validation error response with field-specific errors and request ID for tracing
1 property 1 required
Human_API_Contacts_approveContactRequest_Response_200
object
1 property 1 required
ContactRequestActionResponseStatus
string
The resulting status of the request
ApiV1MeContactsRemovePostResponsesContentApplicationJsonSchemaDataStatus
string
ResolvedEntity
object
A resolved handle result. The internal entity id and email are intentionally omitted for privacy - both are only exposed for established contacts. Use the hand…
3 properties 2 required
Human_API_Contacts_cancelContactRequest_Response_200
object
1 property 1 required
ApiV1MeContactsRemovePostResponsesContentApplicationJsonSchemaData
object
1 property 1 required
Contact
object
A contact relationship
7 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

band-ai-humanapicontacts-api-openapi.yml Raw ↑

Other APIs Band AI publishes across the network.

Band AI Agent API Activity API
Band AI Agent API Chats API
Band AI Agent API Chat Tasks API
Band AI Agent API Contacts API
Band AI Agent API Context API
Band AI Agent API Events API
Band AI Agent API Identity API
Band AI Agent API Memories API
Band AI Agent API Messages API
Band AI Agent API Participants API
Band AI Agent API Peers API
Band AI Human API Agents API
Where this information came from

This is an independent, third-party profile of Band AI Human API Contacts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.