API product catalogEnterprise Governance, Security & Access

Create a custom partner role

Enterprise Governance, Security & Access

POST

/team/roles

Production onlycreatePartnerRole

Parameters

This endpoint has no path or query parameters.

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Idempotency-KeystringheaderRequired

Unique string that makes write calls safe to retry on network failure. Required for money movement, trading, KYC, subscriptions, and webhook creation. Deduplicated for 24 hours -- duplicate keys return the cached response. HTTP 409 if a concurrent request with the same key is still in progress.

Example: dep_user42_1743152580

Request body

namestringRequired

descriptionstring

permissionsstring[]Required

Response fields

See the response format and API Reference for this endpoint.

Response codes

201Custom role created

Request reference

Production only

Use the API Tester for write requests, including request bodies and idempotency keys.

https://mystocks.africa/api/v1/partner/team/roles

API Reference

Response format

Custom role created

curl -X POST 'https://mystocks.africa/api/v1/partner/team/roles' \
  -H "Authorization: Bearer $MYSTOCKS_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID"

GET /team/roles

DELETE /team/roles/{roleId}