Unlock List columns
Pay once to see paid columns for every member of a List, for 12 months in this Workspace. Charges each member x column with a value not yet unlocked; free columns, empty values and the first 5 members cost nothing. Up to 500 members a call (next_cursor). Returns usage (credits_charged, credits_remaining; 1,000,000 = $1.00). max_credits caps the charge: over it, nothing is charged (budget_exceeded).
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
list_id*string^list_[0-7][0-9A-HJKMNP-TV-Z]{25}$Idempotency-Key*string8 <= length <= 200SMB-Workspace-Id*stringuuidapplication/json- body
fields*array<>SMB data columns to unlock, at most 30 per call: unlock more with another call.
1 <= items <= 30after?stringnext_cursor from the previous answer.
1 <= length <= 4096max_credits?SmbV0OperationsGetBusinessRequestMaxCreditsOptional cap on the credits this call may charge (1,000,000 = $1.00). If it would cost more, nothing is charged and the call fails with budget_exceeded, saying how many credits it needs.
0 <= value <= 100000000Successful authorized response.
application/json- response
data*request_id*stringusage?Credits this call used, from the same transaction as any charge. 1,000,000 credits = $1.00. Paid fields cost credits only when a value comes back that this Workspace hasn't unlocked; an unlock lasts 12 months.
action_receipt*idempotent_replay*smb_v0_operations_create_list_request.__local.properties.body.__schema16curl -X POST 'https://example.com/v1/lists/string/unlock' \ -H 'Idempotency-Key: stringst' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "fields": [ "string" ]}'{ "data": { "list_id": "string", "list_version": 1, "fields": [ "string" ], "businesses": 0, "credits": 0, "expires_at": "2019-08-24T14:15:22Z", "next_cursor": "string" }, "request_id": "string", "usage": { "credits_charged": 0, "credits_remaining": 0, "unit": "usd_micro", "unlocked_until": "2019-08-24T14:15:22Z" }, "action_receipt": { "receipt_id": "64d0a161-468e-472a-b00e-a06ee9ab7de7", "command_id": "7d510d78-7444-4252-aeac-9e473949661e", "operation": "unlock_list_fields", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9" }, "idempotent_replay": true}