Connect a service

Attach a reviewed service with write-only credentials or platform-managed credit.

The live connection response is the source of truth for available service definitions, fields, operation schemas, effects, and application connection state.

List reviewed services and current connections

curl https://api.agent.mq/v1/applications/app_<32-lowercase-hex>/connections \
  -H "Authorization: Bearer $AGENTMQ_TOKEN"

Choose a connection model

Bring your own: send the required credential fields. AgentMQ encrypts them and never returns them.
Platform-backed: send platformConnectionId instead of credentials. Calls reserve application credit.

curl -X PUT https://api.agent.mq/v1/applications/app_<32-lowercase-hex>/connections/<connection-id> \
  -H "Authorization: Bearer $AGENTMQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"<service-id>","name":"Production","credentials":{"<field>":"<secret>"},"operations":["<capability>"],"enabled":true,"dailyLimit":100}'

Test deliberately

Use POST /v1/applications/{appId}/service-invocations/{operationId} with a caller-generated requestKey. Saving a connection validates configuration but makes no provider request.

Verify

List connections again. The response shows metadata and enabled operations, never secret values.

Capability groups

The reviewed catalog spans web retrieval, search and SEO, weather and places, translation, media and public archives, files and object storage, contacts and calendars, email and messaging, telephony, and application services. See the capability guide, then discover the live catalog instead of relying on a copied count.

Verify

Capability groups

Next steps