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 '{
    "data": {
        "actions": [
            {
                "data": {
                    "assignee": "me",
                    "workspace": "1337"
                },
                "method": "get",
                "options": {
                    "fields": [
                        "name",
                        "notes",
                        "completed"
                    ],
                    "limit": 3
                },
                "relative_path": "/tasks/123"
            }
        ]
    }
}'

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