Integrations oauth
Botyard REST API endpoints for integrations oauth.
3 endpoints in this group. Every request authenticates with an API key; see the API reference for the other groups.
- Get Shopify Connector State:
GET /v1/integrations/shopify/connector - Issue Shopify Oauth Authorize Url:
POST /v1/orgs/{org_id}/integrations/shopify/oauth/authorize - Issue Oauth Authorize Url:
POST /v1/orgs/{org_id}/integrations/{provider}/oauth/authorize
Claim Github Installation
Consume a state UUID, fetch installation metadata, write the credential. Authenticated by the state UUID (which was issued to a specific org+user). Session cookie is optional — if present, defense-in-depth checks `session.user_id == row.initiated_by_user_id`. If absent (cookie expired during the GitHub detour), the state alone is sufficient. All errors raise BotyardError subclasses so the central handler emits RFC 9457 Problem Details with the right ``error_code`` for the frontend.
Get Shopify Connector State
Return shop-bound connector health without relying on iframe cookies.