# Use operators and operator API services

Query available operators, create and maintain custom operators, and publish, enable, disable, or invoke operators as API services. This page does not handle workflow jobs; to run workflows, see [Run, resume, and retry workflow jobs](workflow-jobs-recovery.md).

## Prerequisites

Prepare credentials that can access the target workspace. For service endpoints, authentication, and general request formats, see [Prepare to call an API](../../api-call-basics.md).

Before maintaining a custom operator or operator API service, obtain the target ID from the corresponding list or details.

## Call sequence

1. List operators and get details to confirm available operators and their current information.
2. To create custom processing logic, create a custom operator, query its code and details, then test it after adjustments.
3. After confirming that a custom operator is usable, publish an operator API service and inspect its configuration.
4. Enable a service before invoking it. Disable it to stop service temporarily, then enable it again to resume use.
5. Before deleting a custom operator that is no longer needed, confirm the impact.

## API operations

### Browse operators

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Query operators | [List workflow operators](../../../../reference/api/ai-studio/data-processing/operator-catalog/list-operators.md) | Find available operators. |
| Query operator details | [Get workflow operator details](../../../../reference/api/ai-studio/data-processing/operator-catalog/get-operator.md) | You selected an operator and need its information. |

### Manage custom operators

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Query custom operators | [List custom operators](../../../../reference/api/ai-studio/data-processing/custom-operators/list-custom-operators.md) | Find a custom operator or obtain a target ID. |
| Create a custom operator | [Create a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/create-custom-operator.md) | Add custom processing logic. |
| Query custom-operator details | [Get custom-operator details](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.md) | Confirm current information for one custom operator. |
| Query custom-operator code | [Get custom-operator code](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator-code.md) | View custom-operator code. |
| Update a custom operator | [Update a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/update-custom-operator.md) | Adjust an existing custom operator. |
| Test a custom operator | [Test a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/test-custom-operator.md) | Validate a custom operator before publishing or use. |
| Enable a custom operator | [Enable a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/enable-custom-operator.md) | Enable a disabled custom operator. |
| Disable a custom operator | [Disable a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/disable-custom-operator.md) | Stop using a custom operator temporarily. |
| Delete a custom operator | [Delete a custom operator](../../../../reference/api/ai-studio/data-processing/custom-operators/delete-custom-operator.md) | You confirmed that the custom operator is no longer needed. |

### Publish and invoke API services

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Publish an operator API service | [Publish an operator API service](../../../../reference/api/ai-studio/data-processing/operator-api-services/publish-operator-api-service.md) | Provide an operator as an API service. |
| View operator API service configuration | [Get operator API service configuration](../../../../reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.md) | Confirm service configuration after publishing. |
| Enable an operator API service | [Enable an operator API service](../../../../reference/api/ai-studio/data-processing/operator-api-services/enable-operator-api-service.md) | Enable a disabled service. |
| Disable an operator API service | [Disable an operator API service](../../../../reference/api/ai-studio/data-processing/operator-api-services/disable-operator-api-service.md) | Stop a service temporarily. |
| Invoke an operator API service | [Invoke an operator API service](../../../../reference/api/ai-studio/data-processing/operator-api-services/invoke-operator-api-service.md) | The service is published and available. |

## Confirm the result

After creating, updating, enabling, or disabling a custom operator, use [Get custom-operator details](../../../../reference/api/ai-studio/data-processing/custom-operators/get-custom-operator.md) to confirm current information. After publishing, enabling, or disabling a service, use [Get operator API service configuration](../../../../reference/api/ai-studio/data-processing/operator-api-services/get-operator-api-service.md) to confirm service configuration.

## Limitations and notes

- Publishing, enabling, and invoking are separate operations. Confirm service configuration and availability before invocation.
- Before deleting or disabling a custom operator or disabling an API service, confirm that dependent calls are not affected.

## Next steps

- [Run, resume, and retry workflow jobs](workflow-jobs-recovery.md)