Developers · GraphQL
GraphQL Admin Mutations
Last updated 11 November 2026
Admin GraphQL mutations change how your instance is set up: its notifications, assets, pages, tables and other admin resources. They are different from data mutations, which change the records your site stores. Send them to your instance's /api/graph endpoint with an admin key. Each entry below shows the mutation, its arguments and the type it returns.
For example, this mutation turns off an email notification by updating its trigger condition, and reads the new value back:
mutation {
admin_email_notification_update(
id: 123
email_notification: { trigger_condition: "false", delay_by: "0" }
) {
id
trigger_condition
}
}Always send trigger_condition and delay_by when you update an email notification. Fields you leave out are reset to their defaults.
admin_api_call_notification_create
Creates an API call notification.
admin_api_call_notification_create(
api_call_notification: ApiCallNotificationInputType!
): ApiCallNotificationArguments
Type
admin_api_call_notification_delete
Deletes an API call notification.
admin_api_call_notification_delete(
id: ID
physical_file_path: String
): ApiCallNotificationArguments
Deprecated; please use physical_file_path.
Type
admin_api_call_notification_update
Updates an API call notification.
admin_api_call_notification_update(
api_call_notification: UpdateApiCallNotificationInputType!
id: ID
physical_file_path: String
): ApiCallNotificationArguments
Deprecated; please use physical_file_path.
Type
admin_asset_delete
Remove an asset, including the physical file. There is no way to revert this operation. Use with caution.
admin_asset_delete(
physical_file_path: String!
): AssetArguments
Type
admin_asset_delete_all
Removes all assets that match the filter.
admin_asset_delete_all(
filter: MutationAssetsFilterInput!
hard_delete: Boolean = false
): StringArguments
Default false.
Type
admin_asset_update
Updates asset and physically move the file to the new location.
admin_asset_update(
asset: AssetUpdateInput!
physical_file_path: String!
): AssetArguments
Takes an optional
Identifier of a file that you want to update.
Type
admin_asset_update_all
Updates all assets that match the filter.
admin_asset_update_all(
asset: AssetUpdateAllInput!
filter: MutationAssetsFilterInput!
): ObjectCountArguments
Type
admin_assets_create
Creates an asset.
admin_assets_create(
assets: [AssetInput!]!
): AssetsCreateMutationPayloadArguments
Upload each file first with
Type
admin_assets_listing_create
Asynchronously generates a report of the current s3 state. Returns ID, to be used in
admin_assets_listing_create: AssetsListingIdentifier!Type
admin_assets_presign_urls
Pre-signs assets URLs for a given path.
admin_assets_presign_urls(
paths: [AssetPresignInput!]!
): AssetsPresignUrlsMutationPayloadArguments
Type
admin_authorization_policy_create
Creates an authorization policy.
admin_authorization_policy_create(
authorization_policy: AuthorizationPolicyInputType!
): AuthorizationPolicyArguments
Type
admin_authorization_policy_delete
Deletes an authorization policy.
admin_authorization_policy_delete(
id: ID
physical_file_path: String
): AuthorizationPolicyArguments
Deprecated; please use physical_file_path.
Type
admin_authorization_policy_update
Updates an authorization policy.
admin_authorization_policy_update(
authorization_policy: UpdateAuthorizationPolicyInputType!
id: ID
physical_file_path: String
): AuthorizationPolicyArguments
Deprecated; please use physical_file_path.
Type
admin_background_job_delete
Deletes a background job.
admin_background_job_delete(
id: ID!
): BackgroundJobArguments
Type
admin_background_job_retry
Retries a failed background job.
admin_background_job_retry(
id: ID!
): BackgroundJobArguments
Type
admin_background_jobs_delete_all
Deletes all background jobs that match the filter.
admin_background_jobs_delete_all(
filter: BackgroundJobsFilterInput
): BackgroundJobsResultArguments
Type
admin_email_notification_create
Creates an email_notification schema.
admin_email_notification_create(
email_notification: EmailNotificationInputType!
): EmailNotificationArguments
Type
admin_email_notification_delete
Deletes an email_notification schema.
admin_email_notification_delete(
id: ID
physical_file_path: String
): EmailNotificationArguments
Deprecated; please use physical_file_path.
Type
admin_email_notification_delete_all
Deletes email notifications that match the filter.
admin_email_notification_delete_all(
filter: EmailNotificationsFilterInput!
): ObjectCountArguments
Filter for matching email notifications to delete.
Type
admin_email_notification_update
Updates email_notification schema.
admin_email_notification_update(
email_notification: UpdateEmailNotificationInputType!
id: ID
physical_file_path: String
): EmailNotificationArguments
Deprecated; please use physical_file_path.
Type
admin_email_notification_update_all
Updates all email notifications that match the filter.
admin_email_notification_update_all(
email_notification: UpdateEmailNotificationInputType!
filter: EmailNotificationsFilterInput!
): ObjectCountArguments
Filter for matching email notifications to update.
Type
admin_graphql_create
Creates GraphQL.
admin_graphql_create(
graphql: GraphqlInputType!
): GraphQLArguments
TypeType
admin_graphql_delete
Deletes GraphQL.
admin_graphql_delete(
physical_file_path: String!
): GraphQLArguments
Type
admin_graphql_update
Updates GraphQL.
admin_graphql_update(
graphql: UpdateGraphqlInputType!
physical_file_path: String!
): GraphQLArguments
Type
admin_liquid_layout_create
Creates liquid layout.
admin_liquid_layout_create(
liquid_layout: LiquidLayoutInputType!
): LiquidLayoutArguments
Type
admin_liquid_layout_delete
Deletes liquid layout.
admin_liquid_layout_delete(
id: ID
physical_file_path: String
): LiquidLayoutArguments
Deprecated; please use physical_file_path.
Type
admin_liquid_layout_delete_all
Deletes multiple liquid layouts.
admin_liquid_layout_delete_all(
filter: LiquidLayoutsFilterInput!
sync: Boolean = false
): ObjectCountArguments
Set to true to run it synchronously. Default false.
Type
admin_liquid_layout_update
Updates liquid layout.
admin_liquid_layout_update(
id: ID
liquid_layout: UpdateLiquidLayoutInputType!
physical_file_path: String
): LiquidLayoutArguments
Deprecated; please use physical_file_path.
Type
admin_liquid_layout_update_all
Updates multiple liquid layouts.
admin_liquid_layout_update_all(
filter: LiquidLayoutsFilterInput!
liquid_layout: UpdateLiquidLayoutInputType!
): ObjectCountArguments
Type
admin_liquid_partial_create
Creates liquid partial.
admin_liquid_partial_create(
liquid_partial: LiquidPartialInputType!
): LiquidPartialArguments
Type
admin_liquid_partial_delete
Deletes liquid partial.
admin_liquid_partial_delete(
id: ID
physical_file_path: String
): LiquidPartialArguments
Deprecated; please use physical_file_path.
Type
admin_liquid_partial_delete_all
Deletes multiple liquid partials.
admin_liquid_partial_delete_all(
filter: LiquidPartialsFilterInput!
sync: Boolean = false
): ObjectCountArguments
Set to true to run it synchronously. Default false.
Type
admin_liquid_partial_update
Updates liquid partial.
admin_liquid_partial_update(
id: ID
liquid_partial: UpdateLiquidPartialInputType!
physical_file_path: String
): LiquidPartialArguments
Deprecated; please use physical_file_path.
Type
admin_liquid_partial_update_all
Updates multiple liquid partials.
admin_liquid_partial_update_all(
filter: LiquidPartialsFilterInput!
liquid_partial: UpdateLiquidPartialInputType!
): ObjectCountArguments
Type
admin_model_schema_create
Creates model schema.
admin_model_schema_create(
model_schema: ModelSchemaInputType!
): ModelSchemaArguments
Type
admin_model_schema_delete
Deletes model schema.
admin_model_schema_delete(
id: ID
physical_file_path: String
): ModelSchemaArguments
Deprecated; please use physical_file_path.
Type
admin_model_schema_update
Updates model schema.
admin_model_schema_update(
id: ID
model_schema: UpdateModelSchemaInputType!
physical_file_path: String
): ModelSchemaArguments
Deprecated; please use physical_file_path.
Type
admin_page_create
Creates page.
In
admin_page_create(
page: PageInputType!
): PageArguments
Type
admin_page_delete
Deletes page.
admin_page_delete(
id: ID
physical_file_path: String
): PageArguments
Deprecated; please use physical_file_path.
Type
admin_page_update
Updates page.
admin_page_update(
id: ID
page: UpdatePageInputType!
physical_file_path: String
): PageArguments
Deprecated; please use physical_file_path.
Type
admin_page_update_all
Updates multiple pages.
admin_page_update_all(
filter: PageFilterInput!
page: UpdatePageInputType!
): ObjectCount!Arguments
Type
admin_pages_delete_all
Remove all pages. Beware, there is no coming back!
admin_pages_delete_all(
filter: PageFilterInput!
sync: Boolean = false
): ObjectCount!Arguments
Set to true if you want it to run synchronously. Default false.
Type
admin_property_create
Creates property.
admin_property_create(
property: StandalonePropertyInputType!
): PropertyArguments
Type
admin_property_delete
Deletes a property.
admin_property_delete(
id: ID!
): PropertyArguments
Type
admin_property_update
Updates a property.
admin_property_update(
id: ID!
property: UpdateStandalonePropertyInputType!
): PropertyArguments
Type
admin_sms_notification_create
Creates sms_notification schema.
admin_sms_notification_create(
sms_notification: SmsNotificationInputType!
): SmsNotificationArguments
Type
admin_sms_notification_delete
Deletes sms_notification schema.
admin_sms_notification_delete(
id: ID
physical_file_path: String
): SmsNotificationArguments
Type
admin_sms_notification_update
Updates sms_notification schema.
admin_sms_notification_update(
id: ID
physical_file_path: String
sms_notification: UpdateSmsNotificationInputType!
): SmsNotificationArguments
Type
admin_table_create
Creates a table.
admin_table_create(
table: TableInputType!
): TableArguments
Type
admin_table_delete
Deletes a table.
admin_table_delete(
physical_file_path: String!
): TableArguments
Type
admin_table_update
Updates a table.
admin_table_update(
physical_file_path: String!
table: UpdateTableInputType!
): TableArguments
Type
admin_translation_set
Creates translation if the key/locale pair does not exist or updates existing translation.
admin_translation_set(
translation: TranslationInputType!
): TranslationArguments
Type
admin_translation_set_json
Sets the whole JSON branch by merging it with the existing translations or overwriting the whole branch.
admin_translation_set_json(
strategy: TranslationJsonStrategy!
translation: TranslationJsonInputType!
): TranslationJsonArguments
json with translation tree, which should be set
Type
admin_translation_unset
Unsets the translation key for a given locale.
admin_translation_unset(
key: String!
locale: String!
): TranslationArguments
for example en, de etc.
Type
Reference
You may visit the following resources for more information:
- ApiCallNotification
- ApiCallNotificationInputType
- Asset
- AssetInput
- AssetPresignInput
- AssetUpdateInput
- AssetsCreateMutationPayload
- AssetsListingIdentifier
- AssetsPresignUrlsMutationPayload
- AssetUpdateAllInput
- AuthorizationPolicy
- AuthorizationPolicyInputType
- BackgroundJob
- BackgroundJobsFilterInput
- BackgroundJobsResult
- Boolean
- EmailNotification
- EmailNotificationsFilterInput
- EmailNotificationInputType
- GraphQL
- GraphqlInputType
- ID
- LiquidLayout
- LiquidLayoutInputType
- LiquidLayoutsFilterInput
- LiquidPartial
- LiquidPartialInputType
- LiquidPartialsFilterInput
- ModelSchema
- ModelSchemaInputType
- MutationAssetsFilterInput
- ObjectCount
- Page
- PageFilterInput
- PageInputType
- Property
- SmsNotification
- SmsNotificationInputType
- StandalonePropertyInputType
- String
- Table
- TableInputType
- Translation
- TranslationInputType
- TranslationJson
- TranslationJsonInputType
- TranslationJsonStrategy
- UpdateApiCallNotificationInputType
- UpdateAuthorizationPolicyInputType
- UpdateEmailNotificationInputType
- UpdateGraphqlInputType
- UpdateLiquidLayoutInputType
- UpdateLiquidPartialInputType
- UpdateModelSchemaInputType
- UpdatePageInputType
- UpdateSmsNotificationInputType
- UpdateStandalonePropertyInputType
- UpdateTableInputType