{ "info": { "_postman_id": "cbd53c6f-c545-4988-b2ab-28110b03d274", "name": "Clerk Backend Account Portal Role Sets API", "description": "The Clerk REST Backend API, meant to be accessed by backend servers.\n\n### Versions\n\nWhen the API changes in a way that isn't compatible with older versions, a new version is released.\nEach version is identified by its release date, e.g. `2025-04-10`. For more information, please see [Clerk API Versions](https://clerk.com/docs/versioning/available-versions).\n\nPlease see https://clerk.com/docs for more information.\n\nContact Support:\n Name: Clerk Platform Team\n Email: support@clerk.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:25:02.000Z", "updatedAt": "2026-07-28T01:25:02.000Z", "lastUpdatedBy": "35240", "uid": "35240-cbd53c6f-c545-4988-b2ab-28110b03d274" }, "item": [ { "name": "role_sets", "item": [ { "name": "{role_set_key_or_id}", "item": [ { "name": "replace", "item": [ { "name": "Replace a Role Set", "id": "b421760c-8596-4de4-8ba1-6fec466e5b89", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "id": "869ee4d4-31f3-4980-adfa-575d4854356c", "key": "role_set_key_or_id", "value": "", "description": "(Required) The key or ID of the role set to replace" } ] }, "description": "Replaces a role set with another role set. This is functionally equivalent to deleting\nthe role set but allows for atomic replacement with migration support.\nOrganizations using this role set will be migrated to the destination role set." }, "response": [ { "id": "bd83bc35-2a89-48b2-bbb1-b37117139438", "name": "Deleted Object", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"\",\n \"deleted\": \"\",\n \"id\": \"\",\n \"slug\": \"\",\n \"external_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-bd83bc35-2a89-48b2-bbb1-b37117139438" }, { "id": "bd745324-a889-4926-9677-f0a06fa87f5b", "name": "Request was not successful", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-bd745324-a889-4926-9677-f0a06fa87f5b" }, { "id": "7b675aca-a56e-4611-aeb3-34ded28fe159", "name": "Authentication invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-7b675aca-a56e-4611-aeb3-34ded28fe159" }, { "id": "f58a2350-ee38-4e9a-b49b-bd1cdf355c2a", "name": "Authorization invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-f58a2350-ee38-4e9a-b49b-bd1cdf355c2a" }, { "id": "582a325b-3867-4173-9a5f-c054b805b847", "name": "Resource not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-582a325b-3867-4173-9a5f-c054b805b847" }, { "id": "c7b9343d-69ea-4d47-8b42-747884561bc0", "name": "Invalid request parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"dest_role_set_key\": \"\",\n \"reassignment_mappings\": {\n \"et_7\": \"\",\n \"Lorem_8\": \"\",\n \"adipisicing5\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-c7b9343d-69ea-4d47-8b42-747884561bc0" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-b421760c-8596-4de4-8ba1-6fec466e5b89" } ], "id": "b6fbc3da-c6f1-43bf-a74d-82f12754a884", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-b6fbc3da-c6f1-43bf-a74d-82f12754a884" }, { "name": "roles", "item": [ { "name": "replace", "item": [ { "name": "Replace a Role in a Role Set", "id": "058b968a-92af-4083-9ddf-69621dd457ac", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "id": "a3e6a8f9-6401-4cda-a5b2-252665bf208d", "key": "role_set_key_or_id", "value": "", "description": "(Required) The key or ID of the role set" } ] }, "description": "Replaces a role in a role set with another role. This atomically removes\nthe source role and reassigns any members to the destination role." }, "response": [ { "id": "eaadbdec-9d00-41a5-b1bc-e1ef6c5e3721", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"auteb\": \"\",\n \"aliqua_1f9\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-eaadbdec-9d00-41a5-b1bc-e1ef6c5e3721" }, { "id": "fe292c87-e691-41e0-8650-41f417b79dbd", "name": "Request was not successful", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-fe292c87-e691-41e0-8650-41f417b79dbd" }, { "id": "7cc4f369-110b-4491-9852-248c175bd0e5", "name": "Authentication invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-7cc4f369-110b-4491-9852-248c175bd0e5" }, { "id": "723ec37c-c4a9-437a-bbcf-f002b3b3603f", "name": "Authorization invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-723ec37c-c4a9-437a-bbcf-f002b3b3603f" }, { "id": "b96c918e-39be-4b44-84f3-59cd5d7e2393", "name": "Resource not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-b96c918e-39be-4b44-84f3-59cd5d7e2393" }, { "id": "59f68937-dc4e-4116-9504-454885ff5b44", "name": "Invalid request parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_key\": \"\",\n \"to_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles/replace", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles", "replace" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-59f68937-dc4e-4116-9504-454885ff5b44" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-058b968a-92af-4083-9ddf-69621dd457ac" } ], "id": "dd157c3a-5b28-417a-9216-512f881e5d6d", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-dd157c3a-5b28-417a-9216-512f881e5d6d" }, { "name": "Add Roles to a Role Set", "id": "74961701-cebf-4255-b9aa-2047748e7e80", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "id": "91edcc91-78b6-4e40-99d0-5b62ccc51671", "key": "role_set_key_or_id", "value": "", "description": "(Required) The key or ID of the role set" } ] }, "description": "Adds one or more roles to an existing role set.\nYou can optionally update the default role or creator role when adding new roles." }, "response": [ { "id": "05a2d9e2-57bc-42b7-8a3d-c94967ccfeca", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"auteb\": \"\",\n \"aliqua_1f9\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-05a2d9e2-57bc-42b7-8a3d-c94967ccfeca" }, { "id": "58fdd019-b7e7-421d-87d3-ea47835e5ed3", "name": "Request was not successful", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-58fdd019-b7e7-421d-87d3-ea47835e5ed3" }, { "id": "ea6d4e5a-af68-4cc2-b72e-7a0d59c4f729", "name": "Authentication invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-ea6d4e5a-af68-4cc2-b72e-7a0d59c4f729" }, { "id": "6478e13c-6382-46b9-ae3c-ddd94aed93c6", "name": "Authorization invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-6478e13c-6382-46b9-ae3c-ddd94aed93c6" }, { "id": "f284e259-0648-470f-80e7-738090afb467", "name": "Resource not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-f284e259-0648-470f-80e7-738090afb467" }, { "id": "ec005f5c-0178-4698-bd29-dbec66b0daea", "name": "Invalid request parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_keys\": [\n \"\",\n \"\"\n ],\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id", "roles" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-ec005f5c-0178-4698-bd29-dbec66b0daea" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-74961701-cebf-4255-b9aa-2047748e7e80" } ], "id": "2879a258-5198-49d1-a91c-40ac155b0334", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-2879a258-5198-49d1-a91c-40ac155b0334" }, { "name": "Retrieve a Role Set", "id": "ee42ad45-927a-4e35-9887-1b8b26b51352", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "id": "d0dd480e-c2e1-4b81-8da4-ce520169d29c", "key": "role_set_key_or_id", "value": "", "description": "(Required) The key or ID of the role set" } ] }, "description": "Retrieves an existing role set by its key or ID." }, "response": [ { "id": "d614214a-af94-4edf-892b-1df41e57d0ae", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"auteb\": \"\",\n \"aliqua_1f9\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-d614214a-af94-4edf-892b-1df41e57d0ae" }, { "id": "a224ff54-9486-4723-be0d-ec064da3423f", "name": "Authentication invalid", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-a224ff54-9486-4723-be0d-ec064da3423f" }, { "id": "3ea54184-fc4d-46d2-8014-011ad79b190f", "name": "Authorization invalid", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-3ea54184-fc4d-46d2-8014-011ad79b190f" }, { "id": "6008c73f-ab2c-4c67-9b5d-82ce2ca8af05", "name": "Resource not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-6008c73f-ab2c-4c67-9b5d-82ce2ca8af05" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-ee42ad45-927a-4e35-9887-1b8b26b51352" }, { "name": "Update a Role Set", "id": "48979f28-135e-4579-b96d-2eb76c9dbe8e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "id": "7d684c93-87d0-48db-8b8e-827e2ecc4d82", "key": "role_set_key_or_id", "value": "", "description": "(Required) The key or ID of the role set to update" } ] }, "description": "Updates an existing role set.\nYou can update the name, key, description, type, default role, or creator role.\nAll parameters are optional - you can update only the fields you want to change." }, "response": [ { "id": "bf4a8f03-8a23-43e0-a024-6c82301dcf5b", "name": "Success", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"auteb\": \"\",\n \"aliqua_1f9\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-bf4a8f03-8a23-43e0-a024-6c82301dcf5b" }, { "id": "477f3296-140e-4799-ba6f-dcc39fb97b05", "name": "Request was not successful", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-477f3296-140e-4799-ba6f-dcc39fb97b05" }, { "id": "d1c360cd-09f9-443a-9d60-0d9853c6364f", "name": "Authentication invalid", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-d1c360cd-09f9-443a-9d60-0d9853c6364f" }, { "id": "ed020d19-6299-45b3-9308-67d3cd610eb4", "name": "Authorization invalid", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-ed020d19-6299-45b3-9308-67d3cd610eb4" }, { "id": "2242e877-7ad1-4981-91d9-884e6ee1d99e", "name": "Resource not found", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-2242e877-7ad1-4981-91d9-884e6ee1d99e" }, { "id": "862727b2-20be-4e2c-8ce3-0404fbb7f503", "name": "Invalid request parameters", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"initial\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets/:role_set_key_or_id", "host": [ "{{baseUrl}}" ], "path": [ "role_sets", ":role_set_key_or_id" ], "variable": [ { "key": "role_set_key_or_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-862727b2-20be-4e2c-8ce3-0404fbb7f503" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-48979f28-135e-4579-b96d-2eb76c9dbe8e" } ], "id": "d7a9357a-3721-4073-b1fe-ae3901882bc2", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-d7a9357a-3721-4073-b1fe-ae3901882bc2" }, { "name": "Get a List of Role Sets", "id": "83d901ad-3c46-4b93-97af-41f33009c00a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] }, "description": "Returns a list of role sets for the instance.\nResults can be paginated using the optional `limit` and `offset` query parameters.\nThe role sets are ordered by descending creation date by default." }, "response": [ { "id": "1a41f47e-cbd7-4d6e-94db-581bee9233e2", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"tempor7b\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n },\n {\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"eiusmod2_\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n }\n ],\n \"total_count\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-1a41f47e-cbd7-4d6e-94db-581bee9233e2" }, { "id": "2288ee11-ad92-406c-8018-69dad38b4e7f", "name": "Request was not successful", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-2288ee11-ad92-406c-8018-69dad38b4e7f" }, { "id": "5e4e843b-e16a-4a96-ad9d-39529166837a", "name": "Authentication invalid", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-5e4e843b-e16a-4a96-ad9d-39529166837a" }, { "id": "609cdd9d-7c4a-4898-9e4d-df726d1d96e7", "name": "Authorization invalid", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-609cdd9d-7c4a-4898-9e4d-df726d1d96e7" }, { "id": "e1160b8c-ae21-459b-bc98-52cae98dad88", "name": "Invalid request parameters", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/role_sets?query=&order_by=-created_at&limit=10&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ], "query": [ { "description": "Returns role sets with ID, name, or key that match the given query.\nUses exact match for role set ID and partial match for name and key.", "key": "query", "value": "" }, { "description": "Allows to return role sets in a particular order.\nAt the moment, you can order the returned role sets by their `created_at`, `name`, or `key`.\nIn order to specify the direction, you can use the `+/-` symbols prepended in the property to order by.\nFor example, if you want role sets to be returned in descending order according to their `created_at` property, you can use `-created_at`.\nIf you don't use `+` or `-`, then `+` is implied.\nDefaults to `-created_at`.", "key": "order_by", "value": "-created_at" }, { "description": "Applies a limit to the number of results returned.\nCan be used for paginating the results together with `offset`.", "key": "limit", "value": "10" }, { "description": "Skip the first `offset` results when paginating.\nNeeds to be an integer greater or equal to zero.\nTo be used in conjunction with `limit`.", "key": "offset", "value": "0" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-e1160b8c-ae21-459b-bc98-52cae98dad88" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-83d901ad-3c46-4b93-97af-41f33009c00a" }, { "name": "Create a Role Set", "id": "7b6d69f6-1c8b-4329-a756-040658573146", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] }, "description": "Creates a new role set with the given name and roles.\nThe key must be unique for the instance and start with the 'role_set:' prefix, followed by lowercase alphanumeric characters and underscores only.\nYou must provide at least one role and specify a default role key and creator role key." }, "response": [ { "id": "3bd17419-540e-449c-a1a9-3f6fca0c9d8d", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"object\": \"role_set\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"roles\": [\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n }\n ],\n \"type\": \"initial\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"default_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"creator_role\": {\n \"object\": \"role_set_item\",\n \"id\": \"\",\n \"name\": \"\",\n \"key\": \"\",\n \"description\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"members_count\": \"\",\n \"has_members\": \"\"\n },\n \"role_set_migration\": {\n \"object\": \"role_set_migration\",\n \"id\": \"\",\n \"instance_id\": \"\",\n \"source_role_set_id\": \"\",\n \"trigger_type\": \"\",\n \"status\": \"\",\n \"migrated_members\": \"\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"organization_id\": \"\",\n \"dest_role_set_id\": \"\",\n \"mappings\": {\n \"auteb\": \"\",\n \"aliqua_1f9\": \"\"\n },\n \"started_at\": \"\",\n \"completed_at\": \"\"\n }\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-3bd17419-540e-449c-a1a9-3f6fca0c9d8d" }, { "id": "5d8cdddf-27e4-413e-a7ad-3a81ff131016", "name": "Request was not successful", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-5d8cdddf-27e4-413e-a7ad-3a81ff131016" }, { "id": "8e98a05e-2a81-4c9a-b232-f350b6a6b0cb", "name": "Authentication invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-8e98a05e-2a81-4c9a-b232-f350b6a6b0cb" }, { "id": "4c031112-5a06-4e00-9a37-5ddcf5a5d08d", "name": "Payment required", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Payment Required", "code": 402, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-4c031112-5a06-4e00-9a37-5ddcf5a5d08d" }, { "id": "322d88bc-9074-4b6a-8c82-20f5fcbdf81b", "name": "Authorization invalid", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-322d88bc-9074-4b6a-8c82-20f5fcbdf81b" }, { "id": "619c08fc-efad-4987-8fd1-aaebbfe0e2ed", "name": "Resource not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-619c08fc-efad-4987-8fd1-aaebbfe0e2ed" }, { "id": "435dfed5-2a89-4a39-9313-ca633237001f", "name": "Invalid request parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"default_role_key\": \"\",\n \"creator_role_key\": \"\",\n \"roles\": [\n \"\",\n \"\"\n ],\n \"key\": \"\",\n \"description\": \"\",\n \"type\": \"custom\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/role_sets", "host": [ "{{baseUrl}}" ], "path": [ "role_sets" ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n },\n {\n \"message\": \"\",\n \"long_message\": \"\",\n \"code\": \"\",\n \"meta\": {}\n }\n ],\n \"meta\": {},\n \"clerk_trace_id\": \"\"\n}", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-435dfed5-2a89-4a39-9313-ca633237001f" } ], "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-7b6d69f6-1c8b-4329-a756-040658573146" } ], "id": "69ab88e8-512b-4a4e-89e8-f2fd0acd7911", "createdAt": "2026-07-28T01:25:03.000Z", "updatedAt": "2026-07-28T01:25:03.000Z", "uid": "35240-69ab88e8-512b-4a4e-89e8-f2fd0acd7911" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.clerk.com/v1" } ] }