Delete default dataset

DELETE 
/v2/actor-runs/:runId/dataset

Deletes default dataset associated with an Actor run.

This endpoint is a shortcut for getting the last run's defaultDatasetId and then using the Delete dataset endpoint.

Request

Path Parameters

runId string required
Actor run ID.

Example: 3KH8gEpp4d8uQSe8T

Status 204

No content

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 401

Unauthorized - authentication required or invalid token.

{
  "error": {
    "type": "token-not-valid",
    "message": "Authentication token is not valid."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 403

Forbidden - insufficient permissions to perform this action.

{
  "error": {
    "type": "permission-denied",
    "message": "You do not have permission to perform this action."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 404

Not found - the requested resource does not exist.

{
  "error": {
    "type": "record-not-found",
    "message": "The requested resource was not found."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 405

Method not allowed.

{
  "error": {
    "type": "method-not-allowed",
    "message": "This API end-point can only be accessed using the following HTTP methods: OPTIONS,GET"
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.

Status 429

Too many requests - rate limit exceeded.

{
  "error": {
    "type": "rate-limit-exceeded",
    "message": "You have exceeded the rate limit. Please try again later."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [actor-memory-limit-exceeded, actor-not-found, invalid-input, method-not-allowed, page-not-found, permission-denied, rate-limit-exceeded, record-not-found, record-not-unique, record-or-token-not-found, request-id-invalid, request-too-large, run-failed, run-timeout-exceeded, schedule-actor-not-found, schedule-actor-task-not-found, token-not-valid, unknown-build-tag, unsupported-content-encoding, user-not-found]

  • message string

    Human-readable error message describing what went wrong.