Asana

Submit parallel requests

POST

/batch

Batch API

Make multiple requests in parallel to Asana's API.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/batch' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
  "data": [
    {
      "body": {
        "data": {
          "completed": false,
          "gid": "1967",
          "name": "Hello, world!",
          "notes": "How are you today?"
        }
      },
      "headers": {
        "location": "/tasks/1234"
      },
      "status_code": 200
    }
  ]
}

Request

Body Params application/json

data

object (BatchRequest)

optional

A request object for use in a batch request.

actions

array[object (BatchRequestAction) {4}]

optional

Examples

Responses

🟢200Successfully completed the requested batch API operations.

application/json

Body

data

array[object (BatchResponse) {3}]

optional

body

object

optional

The JSON body that the invoked endpoint returned.

Example:

{"data":{"completed":false,"gid":"1967","name":"Hello, world!","notes":"How are you today?"}}

headers

object

optional

A map of HTTP headers specific to this result. This is primarily used for returning a Location header to accompany a 201 Created result. The parent HTTP response will contain all common headers.

Example:

{"location":"/tasks/1234"}

status_code

integer

optional

The HTTP status code that the invoked endpoint returned.

Example:

200

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Upload an attachment

Create a custom field