Resources

API Keys

API keys allows you to create and manage API keys across environments.

• GET /api-keys
• GET /api-keys/{api_key_id}
• POST /api-keys
• PUT /api-keys/{api_key_id}
• DEL /api-keys/{api_key_id}

Environments

Environments typically represent the stages of your software development lifecylce (common environments include development, staging, and production). With this resource, you can create and manage environments. Some objects are shared across environments.

• POST /environments
• PUT /environments/{environment_id}
• DEL /environments/{environment_id}

Plans

Plans allows you to create and manage both plans and plan audiences, making it easier to ensure plan audiences are governed by the right conditions. You can also retrieve plans for one or more companies.

• GET /plans
• GET /plans/{plan_id}
• POST /plans
• PUT /plans/{plan_id}
• DEL /plans/{plan_id}
• PUT /plan-audiences/{plan_audience_id}
• DEL /plan-audiences/{plan_audience_id}

Companies

Companies allows you to upsert and delete companies and their corresponding metadata, as well as create user and company associations. You can also retrieve company plans, users, and metadata with this resource.

• GET /companies
• POST /companies
• GET /companies/lookup
• DEL /companies/{company_id}
• POST /companies/delete
• GET /company-memberships
• POST /company-memberships
• DEL /company-memberships/{company_membership_id}
• GET /company-plans
• POST /company-traits

Users

Users allows you to upsert and delete users, as well as lookup a user’s company associations.

• GET /users
• GET /users/lookup
• POST /users
• DEL /users/{user_id}
• POST /users/delete
• POST /user-traits

Events

Events allows you to create identify and track event calls either indivdually or in a batched fashion, making it easier to update company and user traits as well as emit usage data to Schematic.

• GET /events
• POST /events
• POST /event-batch
• GET /events/{event_id}

Features

Features allows you to create and manage features, making it easier to build and manage default feature configuration.

• GET /features
• GET /features/{feature_id}
• POST /features
• PUT /features/{feature_id}
• DEL /features/{feature_id}

Flags

Flags allows you to create and manage flags, making it easier to programatically build and manage flag conditions. You can also use this resource to retrieve flag evaluations individually or in a batched fashion with or without a context (e.g. company).

• GET /flags
• GET /flags/{flag_id}
• POST /flags
• PUT /flags/{flag_id}
• DEL /flags/{flag_id}
• PUT /flags/{flag_id}/rules
• POST /flags/{key}/check
• POST /flags/check
• GET /flag-checks
• GET /flag-checks/{flag_check_id}
• GET /flag-checks/latest

Entitlements

Entitlements allows you to manage default plan entitlements and individual company entitlements (aka overrides). You can also retrieve feature usage data at the feature or company levels from this resource.

• GET /company-overrides
• GET /company-overrides/{company_override_id}
• POST /company-overrides
• POST /company-overrides/{company_override_id}
• DEL /company-overrides/{company_override_id}
• GET /plan-entitlements
• GET /plan-entitlements/{plan_entitlement_id}
• POST /plan-entitlements
• PUT /plan-entitlements/{plan_entitlement_id}
• DEL /plan-entitlements/{plan_entitlement_id}

Feature Usage

Feature Usage allows you to retrieve usage at the feature and company-feature levels, making it easy to populate components within your application.

• GET /feature-usage
• GET /usage-by-company