{ "info": { "_postman_id": "5ae2bbf1-a4af-4ed4-a230-04b2b0229778", "name": "Amigo Account Role Grants API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "lastUpdatedBy": "35240", "uid": "35240-5ae2bbf1-a4af-4ed4-a230-04b2b0229778" }, "item": [ { "name": "v1", "item": [ { "name": "{workspace_id}", "item": [ { "name": "role-grants", "item": [ { "name": "{grant_id}", "item": [ { "name": "Get Role Grant", "id": "4d6055d2-47a1-4f02-a749-3b4f460c2476", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "id": "682b0756-efe0-40f0-b740-7fc48a2ce6b0", "key": "workspace_id", "value": "", "description": "(Required) " }, { "id": "69d97e40-1c96-4250-a9fd-b3574d6bd086", "key": "grant_id", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "0a11fb2d-1773-42dd-bd96-e9a0d03b2f98", "name": "Successful Response", "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}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"role_id\": \"\",\n \"resource_type\": \"integration_endpoint\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"status\": \"active\",\n \"created_at\": \"\",\n \"param_binding\": \"\",\n \"changed_by\": \"\"\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-0a11fb2d-1773-42dd-bd96-e9a0d03b2f98" }, { "id": "7fa6a731-de52-499c-ba7e-ab5b93b8630f", "name": "Role grant not found", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-7fa6a731-de52-499c-ba7e-ab5b93b8630f" }, { "id": "0e82a9c2-c2b2-4c53-af87-fd2fd75db7e9", "name": "Validation Error", "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}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-0e82a9c2-c2b2-4c53-af87-fd2fd75db7e9" } ], "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-4d6055d2-47a1-4f02-a749-3b4f460c2476" }, { "name": "Delete Role Grant", "id": "ad342ed3-7de6-4151-8c65-0dbdd68edb36", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "id": "6d0e723f-532d-4a72-ae17-a896b385e062", "key": "workspace_id", "value": "", "description": "(Required) " }, { "id": "ab1f2af9-4402-42f7-92ec-b740cfad49a0", "key": "grant_id", "value": "", "description": "(Required) " } ] }, "description": "Supersede an active grant (immutable history) \u2014 never a physical delete." }, "response": [ { "id": "edbdec9d-718c-4cae-b656-1f0806399304", "name": "Successful Response", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-edbdec9d-718c-4cae-b656-1f0806399304" }, { "id": "1f41c3f9-87b8-4c12-998b-f57657466baf", "name": "Active role grant not found", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-1f41c3f9-87b8-4c12-998b-f57657466baf" }, { "id": "dde21b3d-6b92-4387-99c2-c278e0e7a9e8", "name": "Validation Error", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants/:grant_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants", ":grant_id" ], "variable": [ { "key": "workspace_id" }, { "key": "grant_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-dde21b3d-6b92-4387-99c2-c278e0e7a9e8" } ], "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-ad342ed3-7de6-4151-8c65-0dbdd68edb36" } ], "id": "99251350-22ca-4878-a55c-89311bfc1983", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-99251350-22ca-4878-a55c-89311bfc1983" }, { "name": "List Role Grants", "id": "f096a13d-bbde-46f2-9721-deb2d6617c8c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants?limit=50&title=Continuation Token&status=active", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "query": [ { "key": "limit", "value": "50" }, { "key": "title", "value": "Continuation Token" }, { "key": "status", "value": "active" } ], "variable": [ { "id": "40d2bcb0-fcac-4001-8de3-c28d76508075", "key": "workspace_id", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "b512b7ab-562f-441b-aa15-32fcd466ffdf", "name": "Successful Response", "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}}/v1/:workspace_id/role-grants?limit=50&title=Continuation Token&status=active", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "query": [ { "key": "limit", "value": "50" }, { "key": "title", "value": "Continuation Token" }, { "key": "status", "value": "active" } ], "variable": [ { "key": "workspace_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"role_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"write\",\n \"status\": \"superseded\",\n \"created_at\": \"\",\n \"param_binding\": \"\",\n \"changed_by\": \"\"\n },\n {\n \"id\": \"\",\n \"role_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"status\": \"superseded\",\n \"created_at\": \"\",\n \"param_binding\": \"\",\n \"changed_by\": \"\"\n }\n ],\n \"has_more\": \"\",\n \"continuation_token\": {\n \"title\": \"Continuation Token\"\n }\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-b512b7ab-562f-441b-aa15-32fcd466ffdf" }, { "id": "7db3ffd5-37bd-4d18-a708-486f6c83bd19", "name": "Validation Error", "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}}/v1/:workspace_id/role-grants?limit=50&title=Continuation Token&status=active", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "query": [ { "key": "limit", "value": "50" }, { "key": "title", "value": "Continuation Token" }, { "key": "status", "value": "active" } ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-7db3ffd5-37bd-4d18-a708-486f6c83bd19" } ], "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-f096a13d-bbde-46f2-9721-deb2d6617c8c" }, { "name": "Create Role Grant", "id": "6cab7608-0999-4310-8ecc-ee65dbb65e29", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"role_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"param_binding\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "variable": [ { "id": "e940950c-354f-478d-9289-136b879cf255", "key": "workspace_id", "value": "", "description": "(Required) " } ] } }, "response": [ { "id": "b0cd9961-9c79-40d0-9c32-126792511278", "name": "Successful Response", "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_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"param_binding\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"role_id\": \"\",\n \"resource_type\": \"integration_endpoint\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"status\": \"active\",\n \"created_at\": \"\",\n \"param_binding\": \"\",\n \"changed_by\": \"\"\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-b0cd9961-9c79-40d0-9c32-126792511278" }, { "id": "02535258-f694-40c3-aa49-c876669c5a18", "name": "An active grant for this (role, resource, access) already exists", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"role_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"param_binding\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-02535258-f694-40c3-aa49-c876669c5a18" }, { "id": "7a4f9061-dfe1-455c-ba07-31ba5e606461", "name": "Validation Error", "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_id\": \"\",\n \"resource_type\": \"kb_scope\",\n \"resource_key\": \"\",\n \"access\": \"read\",\n \"param_binding\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/:workspace_id/role-grants", "host": [ "{{baseUrl}}" ], "path": [ "v1", ":workspace_id", "role-grants" ], "variable": [ { "key": "workspace_id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-7a4f9061-dfe1-455c-ba07-31ba5e606461" } ], "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-6cab7608-0999-4310-8ecc-ee65dbb65e29" } ], "id": "76d45ea4-9af4-43d7-ace6-c59ffbf8f1b7", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-76d45ea4-9af4-43d7-ace6-c59ffbf8f1b7" } ], "id": "3e1c81c1-41a8-44d4-99d1-ad38989425c1", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-3e1c81c1-41a8-44d4-99d1-ad38989425c1" } ], "id": "c901802b-d2aa-482c-a97a-db138d638e61", "createdAt": "2026-07-28T01:01:47.000Z", "updatedAt": "2026-07-28T01:01:47.000Z", "uid": "35240-c901802b-d2aa-482c-a97a-db138d638e61" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.amigo.ai" } ] }