Accept Trading Permission

View as Markdown
### Accept a trading permission granted by another party. **Available to:** All authenticated users **Environments:** Demo, Live **[Rate Limit](/api/authentication#request-rate-limits-and-time-penalties):** No endpoint-specific limit Accepts a pending trading permission, transitioning its status from `Requested` to `Accepted`. A trading permission authorizes a CTA (commodity trading advisor) to trade on an account holder's behalf; accepting it is the step where the named CTA confirms the arrangement. Identify the permission with `tradingPermissionId` (the integer entity ID). Only the CTA named on the permission can accept it — the request fails for any other caller. The permission must still be in `Requested` status; once it has moved to another status, it can no longer be accepted. To find pending permissions and their IDs, query [tradingPermissionList](/api/rest-api-endpoints/users/trading-permission-list). On success, the response returns the updated `tradingPermission` with its new status and an empty `errorText`. On a handled failure, the `tradingPermission` is still returned alongside a non-empty `errorText` describing the problem. **Common Failure Scenarios** - The permission is no longer in `Requested` status, so it is too late to accept it. - The caller is not the CTA named on the permission (returns an access-denied error). - The `tradingPermissionId` doesn't exist or isn't accessible to the caller. - The access token is missing or invalid (returns `HTTP 401`). **Error Messages** | `errorText` | Trigger | |-------------|---------| | `"It is too late, the status has been changed"` | The permission is no longer in `Requested` status. | | Non-empty `errorText` | The request failed; the field describes the reason. |

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
tradingPermissionIdlongRequired

Response

TradingPermissionResponse
errorTextstring<=8192 characters

Non-empty if the request failed

tradingPermissionobject