Relays

Proxy external APIs through Picklayer with connectors (upstream services) and routes (endpoint mappings).

Connectors

Operation	GraphQL
List connectors	`relay_connectors(where: {application_id: {_eq: $appId}, enabled: {_eq: true}}, order_by: {created_at: desc})`
Create connector	`insert_relay_connectors_one(object: {name, provider, base_url, auth_type, auth_config, default_headers, rate_limit, timeout_seconds, ...})`
Update connector	`update_relay_connectors_by_pk(pk_columns: {id: $id}, _set: {name, base_url, auth_type, auth_config, rate_limit, ...})`
Delete connector	`update_relay_connectors_by_pk(pk_columns: {id: $id}, _set: {enabled: false})` (soft-delete)
Create secret	`insert_relay_connector_secrets_one(object: {connector_id, secret_name, ...})`
Update secret	`update_relay_connector_secrets_by_pk(pk_columns: {id: $id}, _set: {secret_name, is_active, ...})`

Routes

Operation	GraphQL
List routes	`relay_routes(where: {application_id: {_eq: $appId}, deleted: {_neq: true}}, order_by: {created_at: desc})`
Create route	`insert_relay_routes_one(object: {connector_id, name, path, method, request_template, body_template, response_transform, qps_limit, cache_ttl_seconds, ...})`
Update route	`update_relay_routes_by_pk(pk_columns: {id: $id}, _set: {name, path, method, enabled, ...})`
Delete route	`update_relay_routes_by_pk(pk_columns: {id: $id}, _set: {deleted: true})` (soft-delete)
Active routes by connector	`relay_routes(where: {connector_id: {_eq: $connectorId}, enabled: {_eq: true}})`

For route response caching, omit cache_ttl_seconds or set it to null to keep caching disabled. A positive cache_ttl_seconds value explicitly opts the route into caching for that TTL.