v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB

App Instance API

Create App Instance

Create a new app instance for a team.

post/v2/app-instances

customServiceIdstring

Option: custom_service_id — The ID of a custom service to create the app instance for.

servicestring

Option: service — The service identifier (for built-in services like "github", "okta", "aws").

teamIdstring required

The ID of the team.

externalServiceInstanceIdstring required

The external service instance ID (e.g., GitHub org name, Okta domain, AWS account ID).

namestring required

The name of the app instance.

defaultAccessPolicyIdstring nullable

The default access policy for the app instance (optional).

accessRequestsEnabledboolean

Whether access requests are enabled for the app instance.

Success