Customers API

curl https://api.modelrelay.ai/api/v1/customers \
  -H "Authorization: Bearer mr_sk_..."

import { ModelRelay } from "@modelrelay/sdk";

const mr = ModelRelay.fromSecretKey(process.env.MODELRELAY_SECRET_KEY!);

const customers = await mr.customers.list();
for (const entry of customers) {
  const tier = entry.subscription?.tier_code ?? "none";
  console.log(`${entry.customer.external_id}: ${tier}`);
}

customers, err := client.Customers.List(ctx)
if err != nil {
    return err
}

for _, entry := range customers {
    tier := "none"
    if entry.Subscription != nil {
        tier = entry.Subscription.TierCode.String()
    }
    fmt.Printf("%s: %s\n", entry.Customer.ExternalID, tier)
}

curl -X POST https://api.modelrelay.ai/api/v1/customers \
  -H "Authorization: Bearer mr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "user_456",
    "email": "bob@example.com",
    "metadata": {
      "signup_source": "landing_page"
    }
  }'

const customer = await mr.customers.create({
  external_id: "user_456",
  email: "bob@example.com",
  metadata: {
    signup_source: "landing_page",
  },
});

console.log(`Created customer: ${customer.customer.id}`);

customer, err := client.Customers.Create(ctx, sdk.CustomerCreateRequest{
    ExternalID: sdk.NewCustomerExternalID("user_456"),
    Email:      "bob@example.com",
    Metadata: sdk.CustomerMetadata{
        "signup_source": "landing_page",
    },
})
if err != nil {
    return err
}

fmt.Printf("Created customer: %s\n", customer.Customer.ID)

curl https://api.modelrelay.ai/api/v1/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer mr_sk_..."

const customer = await mr.customers.get("550e8400-e29b-41d4-a716-446655440000");
const tier = customer.subscription?.tier_code ?? "none";
console.log(`${customer.customer.external_id} is on the ${tier} tier`);

customer, err := client.Customers.Get(ctx, uuid.MustParse("550e8400-e29b-41d4-a716-446655440000"))
if err != nil {
    return err
}

tier := "none"
if customer.Subscription != nil {
    tier = customer.Subscription.TierCode.String()
}
fmt.Printf("%s is on the %s tier\n", customer.Customer.ExternalID, tier)

curl -X PUT https://api.modelrelay.ai/api/v1/customers \
  -H "Authorization: Bearer mr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "user_456",
    "email": "bob@newdomain.com"
  }'

// Creates if not exists, updates if exists
const customer = await mr.customers.upsert({
  external_id: "user_456",
  email: "bob@newdomain.com",
});

customer, err := client.Customers.Upsert(ctx, sdk.CustomerUpsertRequest{
    ExternalID: sdk.NewCustomerExternalID("user_456"),
    Email:      "bob@newdomain.com",
})

curl -X DELETE https://api.modelrelay.ai/api/v1/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer mr_sk_..."

await mr.customers.delete("550e8400-e29b-41d4-a716-446655440000");

err := client.Customers.Delete(ctx, uuid.MustParse("550e8400-e29b-41d4-a716-446655440000"))

curl -X POST https://api.modelrelay.ai/api/v1/customers/550e8400-e29b-41d4-a716-446655440000/subscribe \
  -H "Authorization: Bearer mr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tier_id": "550e8400-e29b-41d4-a716-446655440111",
    "success_url": "https://myapp.com/success",
    "cancel_url": "https://myapp.com/billing"
  }'

const session = await mr.customers.subscribe(
  "550e8400-e29b-41d4-a716-446655440000",
  {
    tier_id: "550e8400-e29b-41d4-a716-446655440111",
    success_url: "https://myapp.com/success",
    cancel_url: "https://myapp.com/billing",
  }
);

// Redirect user to Stripe
res.redirect(session.url);

session, err := client.Customers.Subscribe(ctx,
    uuid.MustParse("550e8400-e29b-41d4-a716-446655440000"),
    sdk.CustomerSubscribeRequest{
        TierID:     uuid.MustParse("550e8400-e29b-41d4-a716-446655440111"),
        SuccessURL: "https://myapp.com/success",
        CancelURL:  "https://myapp.com/billing",
    },
)
if err != nil {
    return err
}

http.Redirect(w, r, session.URL, http.StatusSeeOther)

curl https://api.modelrelay.ai/api/v1/customers/550e8400-e29b-41d4-a716-446655440000/subscription \
  -H "Authorization: Bearer mr_sk_..."

const subscription = await mr.customers.getSubscription(
  "550e8400-e29b-41d4-a716-446655440000"
);

if (subscription.active) {
  console.log(`Active until ${subscription.current_period_end}`);
}

sub, err := client.Customers.GetSubscription(ctx,
    uuid.MustParse("550e8400-e29b-41d4-a716-446655440000"),
)
if err != nil {
    return err
}

if sub.Active {
    fmt.Printf("Active until %s\n", sub.CurrentPeriodEnd)
}

curl -X POST https://api.modelrelay.ai/api/v1/customers/claim \
  -H "Authorization: Bearer mr_pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alice@example.com",
    "provider": "github",
    "subject": "12345678"
  }'

// After user authenticates with OAuth
const customer = await mr.customers.claim({
  email: user.email,
  provider: "github",
  subject: user.id,
});

customer, err := client.Customers.Claim(ctx, sdk.CustomerClaimRequest{
    Email:    user.Email,
    Provider: sdk.CustomerIdentityProvider("github"),
    Subject:  sdk.CustomerIdentitySubject(user.ID),
})