Provider connections

Register where Skilleo resolves customer provider credentials. Skilleo never receives or stores customer API key values. See Secrets.

POST /v1/providers/connections

Create or update a connection (one per provider). Body contains metadata only.

AWS Secrets Manager

curl -s -X POST https://api.skilleo.org/v1/providers/connections \
  -H "Authorization: Bearer $SKILLEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openai","connection_type":"aws_secrets_manager","secret_ref":"arn:aws:secretsmanager:us-east-1:123456789:secret:openai"}'

Environment

curl -s -X POST https://api.skilleo.org/v1/providers/connections \
  -H "Authorization: Bearer $SKILLEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"minimax","connection_type":"environment","secret_ref":"MINIMAX_API_KEY"}'

You set the variable in your secret store. Skilleo stores only the name.

Response 200

{
  "data": {
    "provider": "minimax",
    "connection": "prv_...",
    "connection_type": "environment",
    "secret_ref": "MINIMAX_API_KEY",
    "status": "connected"
  }
}

Sending api_key in the request body is not supported.

GET /v1/providers/connections

List connections. Metadata only.

curl -s https://api.skilleo.org/v1/providers/connections \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

DELETE /v1/providers/connections/

Remove a connection.

curl -s -X DELETE https://api.skilleo.org/v1/providers/connections/prv_abc123 \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

Errors

Code	When
VALIDATION_ERROR	Unknown provider or connection_type; missing secret_ref
SECRET_UNRESOLVED	Secret could not be resolved at execution time
SECRET_RESOLVER_UNAVAILABLE	Connection type not available on this deployment