How Integration Studio works
1
Provide the API documentation
From the Integrations page, start a new Integration Studio connector. Provide an integration name and a link to the app’s API documentation, OpenAPI/Swagger spec, or Postman collection. Select which data to track (identities, roles and groups, permissions, or a combination) and optionally enable remediations.
2
The agent researches the API
The research agent runs four sequential stages. Each stage streams its reasoning and the exact documentation pages it read, and completes with a confidence indicator (High, Medium, or Low) based on how much of the result came from a machine-readable spec versus was inferred from partial or human-written docs.
A low-confidence stage flags the specific gap and what it limits - for example, a remediation that can’t be generated without a documented endpoint for it.
3
A deterministic validator checks every draft
Every manifest is checked by a validator that runs outside any AI model. It is a mechanical, rule-based check: a draft that fails returns specific errors, the agent fixes that piece, and only a fully validated manifest advances.
4
Review and connect
Review the manifest, the endpoints discovered, and any remediations the agent proposed. Provide credentials, and Oleria tests the connection against the live app before anything goes live.
Supported authentication methods
Integration Studio detects the app’s authentication scheme during research and pre-fills the credential form. You can override the detected type if it’s wrong.
Every credential form requires a passing Test connection before you can connect. A failed test returns the specific cause: invalid credentials, insufficient scopes, an unreachable base URL, or an unexpected error from the app.
OAuth 2.0 (client credentials and authorization code), custom header, and two-step/session token authentication are coming soon.
Remediations
If you enable remediations during setup, the research agent maps the app’s endpoints to actions Oleria can take directly against it, not just read from it. This is what lets a connector you build through Integration Studio participate in the same governance workflows as any connector in the application catalog:- Identity lifecycle management (ILM) - disable or deprovision an account as part of a joiner/mover/leaver workflow.
- Access reviews - revoke access or remove a group membership when a certification campaign flags it.
- Access requests - grant or remove access as part of a request-and-approval workflow.
- Remediations generated with low confidence default to off.
- Destructive or irreversible remediations (a hard delete, a permanent revoke) always default to off and carry a distinct risk indicator, regardless of confidence.
- Integration Studio has no built-in undo for a triggered remediation - reversing one means taking the opposite action manually in the target app (for example, re-enabling an account you disabled).
Managing an Integration Studio connector
An Integration Studio connector is managed from its own detail page, the same as any other integration:- Manifest - view or edit each artifact (API descriptor, data mapping, application manifest, plugin metadata) individually.
- Sync health - a log of sync attempts with record counts and errors. Errors are specific: an expired auth token, a rate limit with a retry time, or a field-mapping mismatch with a count of affected records.
- Settings - update credentials, update the docs URL and re-run research, enable or disable individual remediations, rename, or delete the connector.
A manifest, not custom code
A traditional connector is code an engineer writes, compiles, and ships. Integration Studio produces a manifest instead: a structured description of the app’s authentication, endpoints, pagination, and field mappings. A generic runtime reads the manifest and behaves as the connector, so a new integration is a configuration change, not a release. This is the same manifest format behind the connectors Oleria’s engineers build for the application catalog, so a connector built through Integration Studio runs on the same foundation as any other.How it fits with the rest of Oleria
An Integration Studio connector feeds the same workflows as every connector in the application catalog:Access Inventory
Posture findings extend to the new app the same as any built-in connector.
Governance
The new app joins your existing access-review campaigns automatically.
NHI discovery
Service accounts and tokens the connector surfaces become visible in NHI discovery.
Copilot queries
Query across the new app the same way you query the rest of your estate.
Get started
Integrations overview
See how integrations fit into the Oleria identity and access graph.
SCIM-Based Integration
Connecting an app that doesn’t have a documented API? Use the SCIM-based connector instead.

