Aborts an Actor run and returns an object that contains all the details about the run.
Only runs that are starting or running are aborted. For runs with status
FINISHED, FAILED, ABORTING and TIMED-OUT this call does nothing.
643 matches
Developer Tools/Apify
Abort run
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
{
"type": "object",
"properties": {
"gracefully": {
"type": "boolean"
},
"runId": {
"type": "string"
}
},
"required": [
"runId"
],
"additionalProperties": false
}Output
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
- 205
- 206
- 207
- 208
- 209
- 210
- 211
- 212
- 213
- 214
- 215
- 216
- 217
- 218
- 219
- 220
- 221
- 222
- 223
- 224
- 225
- 226
- 227
- 228
- 229
- 230
- 231
- 232
- 233
- 234
- 235
- 236
- 237
- 238
- 239
- 240
- 241
- 242
- 243
- 244
- 245
- 246
- 247
- 248
- 249
- 250
- 251
- 252
- 253
- 254
- 255
- 256
- 257
- 258
- 259
- 260
- 261
- 262
- 263
- 264
- 265
- 266
- 267
- 268
- 269
- 270
- 271
- 272
- 273
- 274
- 275
- 276
- 277
- 278
- 279
- 280
- 281
- 282
- 283
- 284
- 285
- 286
- 287
- 288
- 289
- 290
- 291
- 292
- 293
- 294
- 295
- 296
- 297
- 298
- 299
- 300
- 301
- 302
- 303
- 304
- 305
- 306
- 307
- 308
- 309
- 310
- 311
- 312
- 313
- 314
- 315
- 316
- 317
- 318
- 319
- 320
- 321
- 322
- 323
- 324
- 325
- 326
- 327
- 328
- 329
- 330
- 331
- 332
- 333
- 334
- 335
- 336
- 337
- 338
- 339
- 340
- 341
- 342
- 343
- 344
- 345
- 346
- 347
- 348
- 349
- 350
- 351
- 352
- 353
- 354
- 355
- 356
- 357
- 358
- 359
- 360
- 361
- 362
- 363
- 364
- 365
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"description": "Represents an Actor run and its associated data.",
"required": [
"actId",
"buildId",
"defaultDatasetId",
"defaultKeyValueStoreId",
"defaultRequestQueueId",
"generalAccess",
"id",
"meta",
"options",
"startedAt",
"stats",
"status",
"userId"
],
"properties": {
"actId": {
"type": "string",
"description": "ID of the Actor that was run."
},
"actorTaskId": {
"type": [
"string",
"null"
],
"description": "ID of the Actor task, if the run was started from a task."
},
"buildId": {
"type": "string",
"description": "ID of the Actor build used for this run."
},
"buildNumber": {
"type": [
"string",
"null"
],
"description": "Build number of the Actor build used for this run."
},
"chargedEventCounts": {
"type": "object",
"description": "A map of charged event types to their counts. The keys are event type identifiers defined by the Actor's pricing model (pay-per-event), and the values are the number of times each event was charged during this run."
},
"containerUrl": {
"type": "string",
"format": "uri",
"description": "URL of the container running the Actor."
},
"defaultDatasetId": {
"type": "string",
"description": "ID of the default dataset for this run."
},
"defaultKeyValueStoreId": {
"type": "string",
"description": "ID of the default key-value store for this run."
},
"defaultRequestQueueId": {
"type": "string",
"description": "ID of the default request queue for this run."
},
"exitCode": {
"type": [
"integer",
"null"
],
"description": "Exit code of the Actor run process."
},
"finishedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Time when the Actor run finished."
},
"generalAccess": {
"type": "string",
"description": "General access level for the Actor run.",
"enum": [
"ANYONE_WITH_ID_CAN_READ",
"ANYONE_WITH_NAME_CAN_READ",
"FOLLOW_USER_SETTING",
"RESTRICTED"
]
},
"gitBranchName": {
"type": [
"string",
"null"
],
"description": "Name of the git branch used for the Actor build."
},
"id": {
"type": "string",
"description": "Unique identifier of the Actor run."
},
"isContainerServerReady": {
"type": [
"boolean",
"null"
],
"description": "Whether the container's HTTP server is ready to accept requests."
},
"isStatusMessageTerminal": {
"type": [
"boolean",
"null"
],
"description": "Whether the status message is terminal (final)."
},
"meta": {
"type": "object",
"description": "Metadata about the Actor run.",
"required": [
"origin"
],
"properties": {
"clientIp": {
"type": [
"string",
"null"
],
"description": "IP address of the client that started the run."
},
"origin": {
"type": "string",
"enum": [
"DEVELOPMENT",
"WEB",
"API",
"SCHEDULER",
"TEST",
"WEBHOOK",
"ACTOR",
"CLI",
"CI",
"STANDBY",
"MCP"
]
},
"scheduleId": {
"type": [
"string",
"null"
],
"description": "ID of the schedule that triggered the run."
},
"scheduledAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Time when the run was scheduled."
},
"userAgent": {
"type": [
"string",
"null"
],
"description": "User agent of the client that started the run."
}
}
},
"metamorphs": {
"description": "List of metamorph events that occurred during the run.",
"type": "object"
},
"options": {
"type": "object",
"description": "Configuration options for the Actor run.",
"required": [
"build",
"diskMbytes",
"memoryMbytes",
"timeoutSecs"
],
"properties": {
"build": {
"type": "string"
},
"diskMbytes": {
"type": "integer"
},
"maxItems": {
"type": [
"integer",
"null"
]
},
"maxTotalChargeUsd": {
"type": [
"number",
"null"
]
},
"memoryMbytes": {
"type": "integer"
},
"timeoutSecs": {
"type": "integer"
}
}
},
"platformUsageBillingModel": {
"type": "string",
"description": "Indicates which party covers platform usage costs for this run."
},
"pricingInfo": {
"description": "Pricing information for the Actor.",
"type": "object"
},
"startedAt": {
"type": "string",
"format": "date-time",
"description": "Time when the Actor run started."
},
"stats": {
"type": "object",
"description": "Statistics of the Actor run.",
"properties": {
"computeUnits": {
"type": "number"
},
"cpuAvgUsage": {
"type": "number"
},
"cpuCurrentUsage": {
"type": "number"
},
"cpuMaxUsage": {
"type": "number"
},
"durationMillis": {
"type": "integer"
},
"inputBodyLen": {
"type": [
"integer",
"null"
]
},
"memAvgBytes": {
"type": "number"
},
"memCurrentBytes": {
"type": "integer"
},
"memMaxBytes": {
"type": "integer"
},
"metamorph": {
"type": "integer"
},
"migrationCount": {
"type": "integer"
},
"netRxBytes": {
"type": "integer"
},
"netTxBytes": {
"type": "integer"
},
"rebootCount": {
"type": "integer"
},
"restartCount": {
"type": "integer"
},
"resurrectCount": {
"type": "integer"
},
"runTimeSecs": {
"type": "number"
}
}
},
"status": {
"type": "string",
"description": "Status of an Actor job (run or build).",
"enum": [
"READY",
"RUNNING",
"SUCCEEDED",
"FAILED",
"TIMING-OUT",
"TIMED-OUT",
"ABORTING",
"ABORTED"
]
},
"statusMessage": {
"type": [
"string",
"null"
],
"description": "Detailed message about the run status."
},
"storageIds": {
"type": "object",
"description": "A map of aliased storage IDs associated with this run, grouped by storage type.",
"properties": {
"datasets": {
"type": "object",
"description": "Aliased dataset IDs for this run.",
"properties": {
"default": {
"type": "string",
"description": "ID of the default dataset for this run."
}
}
},
"keyValueStores": {
"type": "object",
"description": "Aliased key-value store IDs for this run.",
"properties": {
"default": {
"type": "string",
"description": "ID of the default key-value store for this run."
}
}
},
"requestQueues": {
"type": "object",
"description": "Aliased request queue IDs for this run.",
"properties": {
"default": {
"type": "string",
"description": "ID of the default request queue for this run."
}
}
}
}
},
"usage": {
"description": "Resource usage statistics for the run.",
"type": "object"
},
"usageTotalUsd": {
"type": [
"number",
"null"
],
"description": "Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For run non-owners: only available for Pay-Per-Event Actors (event costs only). Requires authentication token to access."
},
"usageUsd": {
"description": "Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). Not available for standard Pay-Per-Event Actors. Requires authentication token to access.",
"type": "object"
},
"userId": {
"type": "string",
"description": "ID of the user who started the run."
}
}
}
}
}