---
title: "/task/action"
method: POST
path: "/task/action"
tags: ["Tasks"]
---

# /task/action

`POST /task/action`

## Request

- Base URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0`
- URL: `{corename}.gft-dispute-api.{env}.gpsrv.com/gft-dispute-api/1.0/task/action`
- Auth: none declared

This resource is used perform an available task action (as identified by the `/task/details/list` endpoint)

## Request body

- object
  - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
  - `Action` string, required: Action to perform
  - `TaskList` object[], required: List of Tasks to be actions
    - `TaskId` string, required: Task identifier to be actioned
  - `Detail` object: When an action requires action specific details, these are passed in the Detail object.

## Response `200`

Successful task action request

- object
  - `StatusList` object[]
    - `Type` 'Error' | 'Success': Status of the request
    - `Message` string: Message about the status
    - `Code` string: Numeric code for the status
  - `rtoken` string, nullable: A system-generated ID used for tracking
  - `StatusCode` integer, nullable: The HTTP response status code

## Other responses

- `400`: Error task action request
- `500`: Error task list request

---

[API](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/dispute-api-3-0/revisions/cf13cabe7c95?raw)