workspace-connectors

Relay a message envelope to the connector's service as the signed-in person [write]

Changed on

{id} is a connector id or a kind (the oldest connector of that kind answers). The person's workspace role picks the connector's vault; the vault's credential (a <KIND>_API_KEY environment secret, or a bearer secret for the service's host) goes on a POST to {origin}/v1/ingest/messages and never reaches the caller. The body is the service's message envelope, or an array of them, and passes through unchanged (JSON, at most 1 MiB); Idempotency-Key passes through, defaulting to the envelope's external_message_id or id, or for an array to a digest of its envelopes' ids. ?sync=true passes through (the CRM then ingests inline for at most 100 envelopes); otherwise the service may answer 202 {data:{inbox_id,count,status}} and ingest later, which GET ../ingest/inbox/{inbox_id} follows. The answer is the service's status and body as they were, with x-agentsky-relay naming the audit record. 404 connector_not_installed, 403 role_not_granted, 409 connector_misconfigured, 502 service_unreachable. A workspace identity cannot call this; it exchanges itself instead.

post/workspace-connectors/{id}/ingest/messages

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/workspace-connectors/{id}/ingest/messages
  • Auth
    HTTP bearer

Path parameters

idstring required

Query parameters

sync'true'

Forwarded to the service: ingest inline and answer the counts

Headers

Idempotency-Keystring

Request body

object required
OR
object[] required

Response

The service's answer, as it was

object required

Changes