Skip to main content
POST
/
v0
/
business
/
{business_id}
/
task
Create a Task for a Business
curl --request POST \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "<string>",
  "task_type": "reconnect_account",
  "transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
  "external_account_id": "eac_WQMDNUHpBThYSNh4AprDBo",
  "metadata_": {
    "date_from": "2024-12-31",
    "date_to": "2025-01-13"
  }
}'
{
  "data": {
    "business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
    "description": "ABC Business Checking",
    "status": "pending",
    "task_type": "reconnect_account",
    "first_requested_at": "2023-11-07T05:31:56Z",
    "last_requested_at": "2023-11-07T05:31:56Z",
    "id": "tsk_R2fAXCjqJPdpYata112zyW"
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
business_id
string<biz_string>
required

Body

application/json
​
description
string
required

The task description

​
task_type
enum<string>
required

The task type to use when creating the task

Available options:
reconnect_account,
categorize_transaction,
review_personal_transaction,
other,
request_receipt,
request_statement,
request_other_document
​
transaction_id
string<txn_string> | null

The id of the transaction for which a receipt is requested

Examples:

"txn_WQMDNUHpBThYSNh4AprDBo"

​
external_account_id
string<eac_string> | null

The id of the External Account for which a statement is requested

Examples:

"eac_WQMDNUHpBThYSNh4AprDBo"

​
metadata_
object | null

Task-specific metadata

Examples:
{
  "date_from": "2024-12-31",
  "date_to": "2025-01-13"
}

Response

Successful Response

​
data
object
required
  • TaskPublic
  • TaskCategorizationPublic
  • TaskReconnectAccountPublic
  • TaskRequestReceiptPublic
  • TaskRequestStatementPublic