Update task input
PUT/v2/actor-tasks/:actorTaskId/input
Updates the input of a task using values specified by an object passed as JSON in the PUT payload.
If the object does not define a specific property, its value is not updated.
The response is the full task input as returned by the Get task input endpoint.
The request needs to specify the Content-Type: application/json HTTP
header!
When providing your API authentication token, we recommend using the
request's Authorization header, rather than the URL. (More
info).
Request
Path Parameters
Task ID or a tilde-separated owner's username and task's name.
Example:janedoe~my-taskBodyrequired
- object object
Status 200
Response Headers
{
"myField1": "some-value",
"myField2": "updated-value",
"myField3": 1
}
Schema
- object object
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
Status 413
Payload too large - the request body exceeds the size limit.
{
"error": {
"type": "request-too-large",
"message": "The POST payload is too large (limit: 9437184 bytes, actual length: 10485760 bytes)."
}
}
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
Status 415
Unsupported media type - the Content-Encoding of the request is not supported.
{
"error": {
"type": "unsupported-content-encoding",
"message": "Content-Encoding \"bla\" is not supported."
}
}
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)
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,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,token-not-valid,unknown-build-tag,unsupported-content-encoding] - message string
Human-readable error message describing what went wrong.
- type ErrorType (string)