--- schema_version: "1" id: 16c7124dfa9d20b32684d32ef78f775c5a41c0b60b77889964b0fa5fdd3edd96 title: OperationLog collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_operationlog.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_operationlog.htm source_site: developer.salesforce.com content_type: documentation content_hash: 469e4e2f4a4a0ad24daa0d4d32e15f188f666a148791a12ea20fbb4a6b1216c2 description: Represents long-running or asynchronous operations triggered and tracked through Tooling API. This object is available in API version 37.0 and later. --- # OperationLog Represents long-running or asynchronous operations triggered and tracked through Tooling API. This object is available in API version 37.0 and later. ## Supported SOAP Calls create(), describeSObjects() ## Supported REST HTTP Methods Query, GET, POST ## Special Access Rules As of the Spring '20 release, to access OperationLog you must have the View Setup user permission. ## Fields | Field | Details | | --- | --- | | DetailedStatus | Type string Properties Filter, Group, Nillable, Sort Description Complements the Status field with an operation processor-specific status code. | | Message | Type string Properties Filter, Group, Nillable, Sort Description Complements the Status field with information helpful to the user. For example, if Status=FAILED, state the reason in this field. | | Parameters | Type [OperationParameters](#OperationParameters_title) Properties Create, Nillable Description A complex type that represents a set of parameters passed to the operation processor. Specify the parameters by using the [OperationPayload](#OperationPayload_title) value that corresponds to your operation type. | | Status | Type picklist Properties Filter, Group, Restricted picklist, Sort Description Indicates the status of an operation triggered through Tooling API. Valid values are: - NEW - RUNNING - COMPLETED - FAILED - ABORTED Only records with Status=NEW can be created through the API. | | Type | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort Description The type of operation submitted through Tooling API. For each operation type, use the corresponding payload of input parameters. Valid operation types are: RunTerritoryRules Runs account assignment rules for any territory that has rules defined and belongs to a territory model in Planning or Active state. When you run rules from Setup, accounts are assigned to territories according to your rules if your territory model is in Active or Planning state. Accounts are assigned to territories according to your rules automatically on account creation or update only if your territory model is in Active state. When you choose this operation type, use the payload [Territory2RunTerritoryRulesPayload](#Territory2RunTerritoryRulesPayload) in the Parameters field. RunOppTerrAssignmentApex Uses filter-based opportunity territory assignment to assign territories to opportunities using a simple job. We provide code for an Apex class that you can use as-is or modify as needed based on our guidelines. After you create and deploy the class, run the job to complete the assignment process. Job options include making assignments within date ranges and assigning territories to open opportunities only. When you choose this operation type, use the payload [Territory2RunOppTerrAssignmentApexPayload](#Territory2RunOppTerrAssignmentApexPayload) in the Parameters field. | ## changeOwnPassword Represents the password details when users change their own passwords. Users can’t use setPassword() to change their own passwords, and must use changeOwnPassword(). This type is available in API version 40.0 and later. | Field | Details | | --- | --- | | oldPassword | Type string Description The user’s previous password that is being replaced. | | newPassword | Type string Description The user’s new password. | ## OperationParameters Represents parameters to be passed to an operation triggered by Tooling API. This type is available in API version 37.0 and later. | Field | Details | | --- | --- | | payload | Type [OperationPayload](#OperationPayload_title) Description Use the payload that corresponds to the type of operation you want to trigger through Tooling API. Valid values are: - [Territory2RunTerritoryRulesPayload](#Territory2RunTerritoryRulesPayload) - [Territory2RunOppTerrAssignmentApexPayload](#Territory2RunOppTerrAssignmentApexPayload) | ## OperationPayload Represents a named set of input parameters, or payload, that corresponds to the operation type specified in the [Type](#OperationLog-Type) field of OperationLog. For example, if you choose the operation type [RunTerritoryRules](#RunTerritoryRules), use the payload [Territory2RunTerritoryRulesPayload](#Territory2RunTerritoryRulesPayload). Payloads that are supported by OperationLog are extensions of the OperationPayload type. This type is available in API version 37.0 and later. ## Territory2RunTerritoryRulesPayload Represents a set of parameters to be specified when triggering a [RunTerritoryRules](#RunTerritoryRules) operation through Tooling API. Extends the complex type [OperationPayload](#OperationPayload_title). This type is available in API version 37.0 and later. | Field | Details | | --- | --- | | keyPrefix | Type string Description The key prefix of the entity on which the territory assignment rules should be run. The Account key prefix (001) is currently supported. | | territoryId | Type string Description The TerritoryID of the Planning or Active territory model you want to run rules for. | | territoryModelId | Type string Description The ID for the territory model the territory belongs to. You can run assignment rules on territory models in a Planning or Active state. | ## Territory2RunOppTerrAssignmentApexPayload Represents a set of parameters to be specified when triggering a [RunOppTerrAssignmentApex](#RunOppTerrAssignmentApex) operation through Tooling API. Extends the complex type [OperationPayload](#OperationPayload_title). This type is available in API version 37.0 and later. | Field | Details | | --- | --- | | excludeClosedOpportunities | Type string Description If true, excludes from the operation all opportunities that are already closed. | | opportunityCloseDateFrom | Type string Description Use to filter opportunities based on a range of close dates. The operation applies to opportunities with close dates within the specified range. Use this field to specify a starting date for the range using the format ddmmyyyy. | | opportunityCloseDateTo | Type string Description Use to filter opportunities based a range of close dates. The operation applies to opportunities with close dates within the specified range. Use this field to specify an ending date for the range using the format ddmmyyyy. | | opportunityLastModifiedDateFrom | Type string Description Use to filter opportunities based a range of last-modified dates. The operation applies to opportunities with last-modified dates within the specified range. Use this field to specify a starting date for the range using the format ddmmyyyy. | | opportunityLastModifiedDateTo | Type string Description Use to filter opportunities based a range of last-modified dates. The operation applies to opportunities with last-modified dates within the specified range. Use this field to specify an ending date for the range using the format ddmmyyyy. | | territoryModelId | Type string Description The ID for the active territory model. Opportunities can be assigned to an active territory model only. |