{ "item": [ { "id": "84d16d58-db65-4d1e-8775-4fd21b27d175", "name": "Customers", "description": { "content": "Customer records — full CRUD in Phase 2.", "type": "text/plain" }, "item": [ { "id": "2c027751-3898-427b-a9ea-09005b75ff22", "name": "List customers", "request": { "name": "List customers", "description": {}, "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "created_after", "value": "", "description": "Return customers created strictly after this ISO-8601 timestamp." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "40cc6bfe-63f6-4c06-8149-08bc3c014a8d", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"5ab7c846-c3fa-9494-3332-530fb28cc03c\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1996-05-09T00:05:03.810Z\",\n \"updated_at\": \"1998-07-16T19:27:26.433Z\"\n },\n {\n \"id\": \"06888e68-e7c4-b1d3-0f90-e4354cda7cdd\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1991-05-21T20:34:57.276Z\",\n \"updated_at\": \"1994-09-30T16:29:15.468Z\"\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a9ec557-bf3f-42e7-bb45-0306353b3d98", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8b64f3a-7b83-4ec7-af11-e5425d0b682e", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e416d312-6f4d-47b8-b204-0d6870385326", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60bebed8-63cd-405a-87a5-e069004259cb", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8f94116a-3f4e-4017-81eb-0de42d61ec64", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1382d608-2cde-4a1d-8c71-cf8bd3e57487", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8e1bcb43-766a-44dd-824e-f8c133e25ec4", "name": "Create or upsert a customer", "request": { "name": "Create or upsert a customer", "description": { "content": "POSTing the same `external_id` + `external_source` twice upserts the existing row instead of creating a duplicate.", "type": "text/plain" }, "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"external_id\": \"\",\n \"external_source\": \"\",\n \"company_name\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"phone_alt\": \"\",\n \"billing_address_line_1\": \"\",\n \"billing_address_line_2\": \"\",\n \"billing_city\": \"\",\n \"billing_state\": \"\",\n \"billing_zip\": \"\",\n \"source\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "14719121-3e35-4cbd-9943-c3c5f5deb6b0", "name": "OK — an existing row was updated. Returned when the supplied `external_id` + `external_source` matched an existing row (idempotent retry).", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"52b5b2e8-8e02-8171-bc59-71c25be5cd12\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1997-05-25T06:45:33.909Z\",\n \"updated_at\": \"2000-10-18T15:05:22.181Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "952bde40-57e0-487b-88d3-b318800022e3", "name": "Created — a new row was inserted.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"52b5b2e8-8e02-8171-bc59-71c25be5cd12\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1997-05-25T06:45:33.909Z\",\n \"updated_at\": \"2000-10-18T15:05:22.181Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0882be3b-9b78-4248-bc5b-94901d9cb198", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94f892ce-abf3-443b-98b2-80472e552f06", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b07ae06-1cd0-4dc3-b7c0-74f2f7076010", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eea8ad45-b1e6-418e-8cd4-8b8c85565819", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a435d321-9cdb-46ea-a897-8e843059291d", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a66e648b-5dee-44b6-b7bf-c24b729a6f0a", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c35db20-e2e2-428e-b172-5c4c513960b3", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03e3a5ee-41a2-49dc-b61f-03bb3fe2494b", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "55ff4154-d040-4492-bc82-f9c7b0d61237", "name": "Get a customer", "request": { "name": "Get a customer", "description": {}, "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4550b4d1-1d9f-4ba3-8777-d9de92982752", "name": "Single resource.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"52b5b2e8-8e02-8171-bc59-71c25be5cd12\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1997-05-25T06:45:33.909Z\",\n \"updated_at\": \"2000-10-18T15:05:22.181Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93dfef17-251c-4d7e-83ce-14e469dd4bb5", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb40646a-302d-476f-91bd-d801a49c27b0", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "059d8a75-5b4f-4e3b-929e-6f90ebdd3c8c", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0bc7b6d1-4466-48d5-b109-56b3d9fee089", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f22ec52a-8599-437f-87c0-b5e69a6f26bb", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "802465e6-7159-4930-b598-5fd9108967ac", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "de620cbc-ff8c-40f6-94d4-710d89282ae5", "name": "Update a customer", "request": { "name": "Update a customer", "description": {}, "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"company_name\": \"\",\n \"email\": \"\",\n \"phone\": \"\",\n \"phone_alt\": \"\",\n \"billing_address_line_1\": \"\",\n \"billing_address_line_2\": \"\",\n \"billing_city\": \"\",\n \"billing_state\": \"\",\n \"billing_zip\": \"\",\n \"source\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2ebbcc4a-51d8-4988-a6bb-429edce93a6b", "name": "OK — row updated. Body returns the full updated resource.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"52b5b2e8-8e02-8171-bc59-71c25be5cd12\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1997-05-25T06:45:33.909Z\",\n \"updated_at\": \"2000-10-18T15:05:22.181Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf873f44-a672-4469-8df2-6709cf6eb6fe", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23edb84f-235b-4d7d-8d4a-3c4336499b64", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7639371-969e-45ec-97ee-1a97b0f7aeab", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97fc7433-9e62-41a2-a01d-07bdec01bc98", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d46310a4-3d3c-448f-8d0a-2669e8624acf", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b2c1c5c-0962-4e10-b278-18599720660e", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38b709b9-2e0b-4151-a5c5-0d9b41b02df7", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "068509fe-749d-4efa-8e14-ff994353a461", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "customers", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "eb09be3c-a086-43ec-97d8-8aed28f39dc1", "name": "Look up a customer by phone, email, or external_id", "request": { "name": "Look up a customer by phone, email, or external_id", "description": { "content": "Returns the most-recent match plus a `has_duplicates` hint when more than one customer shares the lookup key.", "type": "text/plain" }, "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "phone", "value": "" }, { "disabled": false, "key": "email", "value": "" }, { "disabled": false, "key": "external_id", "value": "" }, { "disabled": false, "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4edb23bc-1aa9-49ea-ac20-07fb3e21e386", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a55451a6-4fda-51b8-cf8f-f381fb1b6470\",\n \"external_id\": \"crm-acme-001\",\n \"external_source\": \"servicetitan\",\n \"first_name\": \"Jenny\",\n \"last_name\": \"Rosen\",\n \"company_name\": \"Acme HVAC\",\n \"email\": \"jenny.rosen@example.com\",\n \"phone\": \"+15555550100\",\n \"phone_alt\": \"+15555550101\",\n \"billing_address_line_1\": \"510 Townsend St\",\n \"billing_address_line_2\": \"Suite 200\",\n \"billing_city\": \"San Francisco\",\n \"billing_state\": \"CA\",\n \"billing_zip\": \"94103\",\n \"source\": \"google\",\n \"tags\": [\n \"vip\",\n \"commercial\"\n ],\n \"created_at\": \"1960-04-04T14:19:09.489Z\",\n \"updated_at\": \"2009-05-18T15:39:31.055Z\"\n },\n \"has_duplicates\": true\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e773cff7-0682-42b3-a7ac-663719fb9cc7", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fb3586b-2aee-46d0-aa6a-472b27071112", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa3ed79b-3581-4a96-8ebf-624edc05b868", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5657b4c7-cb11-4e75-b64a-150bf7147e40", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71ddcc6a-d666-4a53-9c27-1b5f6b13fa57", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b5df153-cad0-43a1-932d-a082164a194e", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "customers", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "phone", "value": "" }, { "key": "email", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "e0b04b5a-1f4c-4828-af34-ae01667a0112", "name": "Properties", "description": { "content": "Service locations belonging to a customer.", "type": "text/plain" }, "item": [ { "id": "f0cd2635-8f3e-4e56-acb8-c3aa1efad3ee", "name": "List properties", "request": { "name": "List properties", "description": {}, "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "32605f69-ac2b-43b8-b27f-4d59eb6032a8", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"78cdba47-f85b-0c77-d7bf-7d05860252b2\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"4d70a976-7eac-eb1b-5a93-625b0f824506\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"2012-03-13T05:50:43.778Z\",\n \"updated_at\": \"1989-07-06T14:48:42.985Z\"\n },\n {\n \"id\": \"dc074a82-b1d8-2959-00ca-1d3c00a484fb\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"2135ff6e-5efc-d09b-867d-29f796017af2\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1988-05-06T00:44:51.113Z\",\n \"updated_at\": \"1961-01-07T16:57:06.108Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e3091d9-971f-43b3-b56f-70805c12f74f", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "85165c9b-d5eb-4efc-b7b4-5ef6a6588ead", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5560556e-b8f2-477d-8269-7d8f495e9e09", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ffbd1a1-f000-48ad-aa3b-dcc9cfdbbc45", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d8e044e8-cd37-4f77-9900-6c12d71db8e1", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32a237f0-8bc1-47ea-b389-10900f60c653", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f06c995f-3cc0-4080-b3a3-be4046d3890a", "name": "Create or upsert a property", "request": { "name": "Create or upsert a property", "description": { "content": "Provide `customer_id` (UUID) OR `customer_external_id` + `customer_external_source` to identify the owning customer.", "type": "text/plain" }, "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"external_id\": \"\",\n \"external_source\": \"\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"\",\n \"customer_external_source\": \"\",\n \"address_line_2\": \"\",\n \"type\": \"\",\n \"access_notes\": \"\",\n \"lat\": \"\",\n \"lng\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "f1693117-1806-47f2-b07a-49105de13c0c", "name": "OK — an existing row was updated. Returned when the supplied `external_id` + `external_source` matched an existing row (idempotent retry).", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d2e22b87-4fcc-e572-adcd-ce63cc823e93\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"be945a18-b1eb-d0e5-1e4b-895ffb980113\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1949-06-05T11:50:07.884Z\",\n \"updated_at\": \"1976-10-06T22:47:33.043Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7214378-95ce-4340-9e67-163643f92888", "name": "Created — a new row was inserted.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d2e22b87-4fcc-e572-adcd-ce63cc823e93\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"be945a18-b1eb-d0e5-1e4b-895ffb980113\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1949-06-05T11:50:07.884Z\",\n \"updated_at\": \"1976-10-06T22:47:33.043Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8bb669ea-f060-4399-8488-fcd1f0438390", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "069ee6c4-3fea-4d18-8c4a-f79a660a25d7", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5195cc2c-f64e-4456-b863-3777d3336020", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2ebadb6-7d85-4d3a-b864-85622f511d8d", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a43fc7a-6c1f-4605-a57c-c1335abf38a6", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8da9647-669a-4c14-acdd-c39c3b123d9a", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a327deb-2756-4f0d-93e6-bd4dda9e69d7", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6339681-b38b-45b4-8d96-7e3b83e20fdf", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "properties" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"address_line_2\": \"Suite 200\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d6e135fc-df5c-4a3a-a7ab-c8fcc1a42c84", "name": "Get a propertie", "request": { "name": "Get a propertie", "description": {}, "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3b2a2cb2-31a2-40fe-ae99-acadbd03ef97", "name": "Single resource.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d2e22b87-4fcc-e572-adcd-ce63cc823e93\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"be945a18-b1eb-d0e5-1e4b-895ffb980113\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1949-06-05T11:50:07.884Z\",\n \"updated_at\": \"1976-10-06T22:47:33.043Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c90f455f-472c-47f5-b069-5c2e108f8b5c", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "83857266-a5e4-4c21-94db-598175f6ee6e", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0381685f-69c8-4d1a-877f-c68dcf09afed", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4aceaffc-73d9-4873-9c3e-a0687853a3d7", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b81c7567-029e-4436-b97e-134986f7aad5", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80619514-4a16-41d3-8af2-743e571164ac", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3290979f-4c69-4e28-bb15-942eee8be22e", "name": "Update a property", "request": { "name": "Update a property", "description": {}, "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"type\": \"\",\n \"access_notes\": \"\",\n \"lat\": \"\",\n \"lng\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9be117eb-0244-41b9-967f-8cb6999b4d62", "name": "OK — row updated. Body returns the full updated resource.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d2e22b87-4fcc-e572-adcd-ce63cc823e93\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"be945a18-b1eb-d0e5-1e4b-895ffb980113\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1949-06-05T11:50:07.884Z\",\n \"updated_at\": \"1976-10-06T22:47:33.043Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c18c8be9-7ad9-456a-b232-9fcca5f52599", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a58575b-9a93-4f3d-ac36-bf8ed6b4d6a1", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2d58145-c0a2-4165-87bf-1e7341ec51ae", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b03f731-a688-4995-aa7b-d18fe839aae5", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "240c24ab-9ea3-4f1d-82c1-d9c91c4be0cc", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5687c98e-9c0d-4044-bcd9-996629cc186e", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ddc1520d-eb7e-4065-84a0-ec652121f8d5", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e0e3fce9-14d6-4041-b257-7767739a19c5", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "properties", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3a7315fe-d980-41b5-bb45-fd44c1723d3c", "name": "Look up a property by external_id", "request": { "name": "Look up a property by external_id", "description": {}, "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "external_id", "value": "", "description": "(Required) " }, { "disabled": false, "key": "external_source", "value": "", "description": "(Required) " } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "cbff753f-772e-4e6f-b92b-229ce1bd9142", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"d2e22b87-4fcc-e572-adcd-ce63cc823e93\",\n \"external_id\": \"crm-acme-001-prop1\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"be945a18-b1eb-d0e5-1e4b-895ffb980113\",\n \"address_line_1\": \"510 Townsend St\",\n \"address_line_2\": \"Suite 200\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94103\",\n \"type\": \"residential\",\n \"access_notes\": \"Gate code: 4321. Dog in backyard.\",\n \"lat\": 37.7793,\n \"lng\": -122.4192,\n \"created_at\": \"1949-06-05T11:50:07.884Z\",\n \"updated_at\": \"1976-10-06T22:47:33.043Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99071d8e-d628-4534-a6df-52f225a9e441", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ae66a46-6e49-444f-b126-c7fede476098", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfaefdec-8920-43ac-9f78-c2fdf23a5523", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88facb13-af8d-4d64-83d9-b1eb27842239", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2949770-ecac-4e43-b300-48d1b4291a07", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31e82b94-a26f-4b4f-b67c-7e9b0c98b105", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "properties", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3d96141f-415c-412d-97e5-54116b2e02cb", "name": "Equipment", "description": { "content": "HVAC equipment installed at a property.", "type": "text/plain" }, "item": [ { "id": "af7c7ad2-fe80-43e7-b02b-31a159073958", "name": "List equipment", "request": { "name": "List equipment", "description": {}, "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "property_id", "value": "" }, { "disabled": false, "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "157cce57-35e4-4115-8bf9-6c7fa3fc8ea5", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"2329100c-6104-3203-96b7-10ff258afc0c\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"71ed326a-871f-575f-1a87-88f4820a4df9\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1976-08-08T11:48:02.416Z\",\n \"updated_at\": \"1989-03-15T07:01:41.422Z\"\n },\n {\n \"id\": \"cee1cc75-5bb9-5054-09f7-4af698956a67\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"b9bcc435-5f9a-4fd8-a291-498e7e58feab\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1963-08-31T17:32:41.616Z\",\n \"updated_at\": \"1956-07-24T08:06:02.599Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44ed6488-7a7b-4bbb-b5eb-843ef4f0ca93", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e20eb8f0-2e30-4aa1-b625-4706699bca74", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2d82d3f-8397-4025-9401-a545d145bfc2", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "544f1f2d-182d-4d28-8492-57101053ae1a", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f15adc5a-c87d-44c4-81dd-c9703a52171f", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af23894c-eab6-4318-9598-deb8259f16a7", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "property_id", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4c35452a-f864-4a05-a9bc-c288ff46c495", "name": "Create or upsert equipment", "request": { "name": "Create or upsert equipment", "description": { "content": "Provide `property_id` (UUID) OR `property_external_id` + `property_external_source` to identify the property the unit is installed at.", "type": "text/plain" }, "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"\",\n \"external_source\": \"\",\n \"property_id\": \"\",\n \"property_external_id\": \"\",\n \"property_external_source\": \"\",\n \"manufacturer\": \"\",\n \"model\": \"\",\n \"serial_number\": \"\",\n \"install_date\": \"\",\n \"warranty_expiry\": \"\",\n \"condition\": \"\",\n \"notes\": \"\",\n \"data_plate_photo_url\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d9a3db0d-f33f-46fe-87e8-a161c4c9798c", "name": "OK — an existing row was updated. Returned when the supplied `external_id` + `external_source` matched an existing row (idempotent retry).", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"c3c10087-06d4-d9b0-946c-4e15ad32461c\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"81a73e1b-34cc-8587-378d-7c12c9fd8c11\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1980-11-29T13:54:30.220Z\",\n \"updated_at\": \"1957-06-17T00:42:47.616Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "164632d8-66f0-480d-981b-1c9cd1035106", "name": "Created — a new row was inserted.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"c3c10087-06d4-d9b0-946c-4e15ad32461c\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"81a73e1b-34cc-8587-378d-7c12c9fd8c11\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1980-11-29T13:54:30.220Z\",\n \"updated_at\": \"1957-06-17T00:42:47.616Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc75a1c9-69e9-4bb7-9d9f-fd9e92d823c4", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "61a036b3-ccb5-4686-83ec-28a47323cea5", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b27a3c15-e48b-48a2-9510-958489d18997", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "adc57948-3028-4515-9fdc-3fbd0a6443fe", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b61133bf-a591-41fe-af03-7fb0ae33ab98", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d396d8d-3cbb-4fcc-9e42-f379d2a87dd1", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7c5bafae-ae96-4161-aefb-dda20ef40adb", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "715b60dd-fd15-47b4-a798-4670a4fcf02c", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "equipment" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1fba51b0-bb4d-44e9-ab31-3dea2323458a", "name": "Get a equipment", "request": { "name": "Get a equipment", "description": {}, "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a2d1c316-5486-439b-80a3-66c7089515d9", "name": "Single resource.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"c3c10087-06d4-d9b0-946c-4e15ad32461c\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"81a73e1b-34cc-8587-378d-7c12c9fd8c11\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1980-11-29T13:54:30.220Z\",\n \"updated_at\": \"1957-06-17T00:42:47.616Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71cced7a-ad02-4217-b060-25ed9b2bddd3", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a4f527c-b4fe-4624-b89c-4cdb20c2582e", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bd20b56-0321-444b-a44f-1df179879dbe", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3d79d5a-c864-4287-a52d-3a420bdb7607", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88fbb87f-5a70-431a-80b9-b58386adfb53", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1989107b-6f3c-44ad-8da0-1e3c0fa25c50", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e97c15bf-43cc-4b6d-bd47-4f1d0b106e2b", "name": "Update equipment", "request": { "name": "Update equipment", "description": {}, "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"\",\n \"model\": \"\",\n \"serial_number\": \"\",\n \"install_date\": \"\",\n \"warranty_expiry\": \"\",\n \"condition\": \"\",\n \"notes\": \"\",\n \"data_plate_photo_url\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "334d2883-5c58-4f88-948f-dda1b7435917", "name": "OK — row updated. Body returns the full updated resource.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"c3c10087-06d4-d9b0-946c-4e15ad32461c\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"81a73e1b-34cc-8587-378d-7c12c9fd8c11\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1980-11-29T13:54:30.220Z\",\n \"updated_at\": \"1957-06-17T00:42:47.616Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be50ab96-3874-4054-a425-b5eba03828ec", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "87bb481f-8bc1-4bcd-b78e-910515d51762", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58d1080e-1f48-45c4-a8cb-9676936ed3d7", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09b06c71-5dcf-4547-9c33-92adb0383ffb", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22b381fd-76dc-4606-9c24-22d130b60f08", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5f1f1e89-729a-422f-889e-a6818220a4dd", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2d8ed72-8397-4c49-988a-58d1364879a9", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af40eed3-d496-4b9c-8fe4-350288d1e22e", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "equipment", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "91a21987-d4af-4b67-8a81-988b1c705378", "name": "Look up equipment by serial number or external_id", "request": { "name": "Look up equipment by serial number or external_id", "description": {}, "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "serial_number", "value": "" }, { "disabled": false, "key": "external_id", "value": "" }, { "disabled": false, "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "53040863-9be0-4f3c-a8cc-8f550496a04e", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"1c87a69d-da65-0691-d101-ac6a6fcf49cc\",\n \"external_id\": \"crm-acme-001-eq1\",\n \"external_source\": \"servicetitan\",\n \"property_id\": \"1c298192-a017-a2e2-003b-ada50e416573\",\n \"type\": \"ac\",\n \"manufacturer\": \"Carrier\",\n \"model\": \"24ABC636A003\",\n \"serial_number\": \"3618E12345\",\n \"install_date\": \"2018-06-15\",\n \"warranty_expiry\": \"2028-06-15\",\n \"condition\": \"good\",\n \"notes\": \"3-ton split system, R-410A refrigerant.\",\n \"data_plate_photo_url\": \"https://storage.runacall.com/eq-photos/{org}/3618E12345.jpg\",\n \"created_at\": \"1965-02-23T11:06:01.020Z\",\n \"updated_at\": \"1981-01-23T19:59:19.344Z\"\n },\n \"has_duplicates\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1376d0d8-95e1-4fac-b2a4-a37ded48e8cd", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1474d374-bbc0-41f3-b0df-f6432d6ef22c", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68cb38b5-9e41-47e9-9fa5-828ee62e23fb", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6224b632-a36e-4cce-9ff9-00468399eb83", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee4db235-e868-403b-b597-67b261d5f17f", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "471cbb21-59c2-4b5f-b9ff-7fbb012a309a", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "equipment", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "serial_number", "value": "" }, { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "6d130c12-3168-42f9-8c71-9f8d02191749", "name": "Jobs", "description": { "content": "Service / install / maintenance / estimate jobs.", "type": "text/plain" }, "item": [ { "id": "b74b05a4-011a-4767-b628-8d1b2dafc9ea", "name": "List jobs", "request": { "name": "List jobs", "description": {}, "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "status", "value": "" }, { "disabled": false, "key": "scheduled_after", "value": "" }, { "disabled": false, "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b279906b-296d-49c1-b3d2-e4ff65668c9c", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"ce522d3d-2528-8ce1-b1f4-8c3834f6696f\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"81aedcef-b4ad-1558-c3d0-5e34f2d3461b\",\n \"property_id\": \"2fd84030-38f0-7146-674d-1f2a7f38ca65\",\n \"equipment_id\": \"5bd1b256-25fd-0328-1d2f-dd915fc3bba5\",\n \"assigned_tech_id\": \"26f240c8-fdaa-5498-02c2-6f0de093105e\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2000-01-22T12:07:08.792Z\",\n \"scheduled_end\": \"1979-09-13T13:19:12.255Z\",\n \"actual_arrival\": \"1955-10-13T03:56:28.916Z\",\n \"actual_start\": \"2008-05-21T02:14:09.004Z\",\n \"actual_end\": \"2010-11-23T20:46:07.688Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"9288350c-f912-8662-785d-df59e65a72d4\",\n \"estimate_id\": \"a6b407ad-ba23-ee03-8f45-c800d892e729\",\n \"created_at\": \"2010-07-07T23:06:44.473Z\",\n \"updated_at\": \"1948-04-13T08:54:30.464Z\"\n },\n {\n \"id\": \"bccc5dfc-d591-65f7-d4d6-4527373283ab\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"611d9350-ade6-6c0c-7d0e-9e67a8da3c1d\",\n \"property_id\": \"aa9133fb-673f-4dd0-a7ae-79ef62dea27c\",\n \"equipment_id\": \"36d213b7-104c-072e-7e46-b6c678b3172d\",\n \"assigned_tech_id\": \"c95c2c58-d9d5-fa0b-ef08-7b7c4f82b28d\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"1992-01-23T22:53:49.171Z\",\n \"scheduled_end\": \"1967-07-30T03:14:40.966Z\",\n \"actual_arrival\": \"1981-11-13T06:14:17.151Z\",\n \"actual_start\": \"2026-01-05T03:01:49.017Z\",\n \"actual_end\": \"1966-02-15T23:12:24.646Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"c08e04f5-bc2a-98a5-aade-fb32b0785712\",\n \"estimate_id\": \"8df7dee5-a835-071c-a5b9-f42f316f722a\",\n \"created_at\": \"1948-10-16T00:10:29.981Z\",\n \"updated_at\": \"2008-01-08T22:35:55.466Z\"\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e522e90-1225-42fd-99f6-a0f6f8591296", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca767d92-7f13-4d1c-89ea-eeb4fcc9a726", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a81b9d8-9322-4fe8-961b-d91a270d2b73", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc8e4238-1779-4106-8447-439f69185f9f", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b16a548-2b74-4a21-be8d-0389a8fd7a99", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "211c9ade-7806-4cbe-9d40-00858ab17e46", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "scheduled_after", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "64c7ac55-cfae-49e1-8948-2e661eef419a", "name": "Create or upsert a job", "request": { "name": "Create or upsert a job", "description": { "content": "Required FKs (customer, property) can be supplied as UUID OR external_id pair. equipment is optional, same dual form. PATCH on this resource is status-only.", "type": "text/plain" }, "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"external_id\": \"\",\n \"external_source\": \"\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"\",\n \"customer_external_source\": \"\",\n \"property_id\": \"\",\n \"property_external_id\": \"\",\n \"property_external_source\": \"\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"\",\n \"equipment_external_source\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"\",\n \"scheduled_start\": \"\",\n \"scheduled_end\": \"\",\n \"problem_description\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "fd97bff3-a302-471e-b0d9-426168060468", "name": "OK — an existing row was updated. Returned when the supplied `external_id` + `external_source` matched an existing row (idempotent retry).", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2fae464f-7740-9276-e020-8fb7b9e7b6ee\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"188d2545-d401-a1e5-3b92-502bfafeb953\",\n \"property_id\": \"dd8b3be0-c4f1-84e7-86ba-607a61d76b44\",\n \"equipment_id\": \"43c1737c-4d92-fd8f-8f96-6cac33157af9\",\n \"assigned_tech_id\": \"55048dcb-418c-0466-d8c4-5601bf64d219\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2007-05-30T06:28:53.552Z\",\n \"scheduled_end\": \"1957-11-26T19:51:00.574Z\",\n \"actual_arrival\": \"1980-11-01T11:42:55.013Z\",\n \"actual_start\": \"2014-07-13T21:11:54.022Z\",\n \"actual_end\": \"2007-08-25T16:13:50.590Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"8cdc0321-6f07-28d9-7a68-49da581ad46c\",\n \"estimate_id\": \"3b286256-298c-5e26-a49d-27694158e8c6\",\n \"created_at\": \"2016-06-09T18:02:11.275Z\",\n \"updated_at\": \"1980-06-19T23:10:17.640Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d54ccf97-311d-4979-b69a-5a88618aef90", "name": "Created — a new row was inserted.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2fae464f-7740-9276-e020-8fb7b9e7b6ee\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"188d2545-d401-a1e5-3b92-502bfafeb953\",\n \"property_id\": \"dd8b3be0-c4f1-84e7-86ba-607a61d76b44\",\n \"equipment_id\": \"43c1737c-4d92-fd8f-8f96-6cac33157af9\",\n \"assigned_tech_id\": \"55048dcb-418c-0466-d8c4-5601bf64d219\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2007-05-30T06:28:53.552Z\",\n \"scheduled_end\": \"1957-11-26T19:51:00.574Z\",\n \"actual_arrival\": \"1980-11-01T11:42:55.013Z\",\n \"actual_start\": \"2014-07-13T21:11:54.022Z\",\n \"actual_end\": \"2007-08-25T16:13:50.590Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"8cdc0321-6f07-28d9-7a68-49da581ad46c\",\n \"estimate_id\": \"3b286256-298c-5e26-a49d-27694158e8c6\",\n \"created_at\": \"2016-06-09T18:02:11.275Z\",\n \"updated_at\": \"1980-06-19T23:10:17.640Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0ef03da-1608-405a-96a1-53536310346c", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12b92dca-0548-4701-bbed-23b6da13a6bc", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a2dba12-f743-42d0-9190-e13a99967460", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a0a1a4d-c49f-4294-8ae8-92ff4d8b4052", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eac8800c-8083-4389-a9bf-f39b80512f17", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e77772cb-abfb-48a5-843f-858b95990922", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "faae0996-5e07-4edf-9896-04fd604bdb1b", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9e81e9d-5854-40ee-91a9-62263f46e207", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "jobs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"property_id\": \"\",\n \"property_external_id\": \"crm-acme-001-prop1\",\n \"property_external_source\": \"servicetitan\",\n \"equipment_id\": \"\",\n \"equipment_external_id\": \"crm-acme-001-eq1\",\n \"equipment_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"priority\": \"\",\n \"type\": \"\",\n \"source\": \"\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2026-05-20T16:00:00Z\",\n \"scheduled_end\": \"2026-05-20T18:00:00Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant.\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "790e401a-2fb2-4163-867e-dabcc6bc4649", "name": "Get a job", "request": { "name": "Get a job", "description": {}, "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "881ee7e2-07d3-46f7-8d5c-5a4fafec1635", "name": "Single resource.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2fae464f-7740-9276-e020-8fb7b9e7b6ee\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"188d2545-d401-a1e5-3b92-502bfafeb953\",\n \"property_id\": \"dd8b3be0-c4f1-84e7-86ba-607a61d76b44\",\n \"equipment_id\": \"43c1737c-4d92-fd8f-8f96-6cac33157af9\",\n \"assigned_tech_id\": \"55048dcb-418c-0466-d8c4-5601bf64d219\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2007-05-30T06:28:53.552Z\",\n \"scheduled_end\": \"1957-11-26T19:51:00.574Z\",\n \"actual_arrival\": \"1980-11-01T11:42:55.013Z\",\n \"actual_start\": \"2014-07-13T21:11:54.022Z\",\n \"actual_end\": \"2007-08-25T16:13:50.590Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"8cdc0321-6f07-28d9-7a68-49da581ad46c\",\n \"estimate_id\": \"3b286256-298c-5e26-a49d-27694158e8c6\",\n \"created_at\": \"2016-06-09T18:02:11.275Z\",\n \"updated_at\": \"1980-06-19T23:10:17.640Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0cdf9ec2-9cef-4a70-9c82-e825e4788ded", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97c501bc-7865-4bfa-9710-c88a15deafb5", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ddb8ba6-42d0-4560-a471-55f815509e86", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93b71f1c-43b2-4d2f-8471-a8ccf5999c5d", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b9955b4d-52f4-47c0-b438-7e10b4965240", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef226357-0422-427b-a50d-50e3feaca643", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "56b60e1d-07b4-4d56-a7ee-28c0a32039cb", "name": "Update a job's status", "request": { "name": "Update a job's status", "description": { "content": "Status-only. Invalid transitions per VALID_STATUS_TRANSITIONS return 422 (e.g. completed → scheduled). No-op (same status) returns 200 with the unchanged row.", "type": "text/plain" }, "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ecbc07e8-c9f5-4309-893b-d70785835923", "name": "OK — row updated. Body returns the full updated resource.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"2fae464f-7740-9276-e020-8fb7b9e7b6ee\",\n \"external_id\": \"crm-acme-job-2026-1042\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"188d2545-d401-a1e5-3b92-502bfafeb953\",\n \"property_id\": \"dd8b3be0-c4f1-84e7-86ba-607a61d76b44\",\n \"equipment_id\": \"43c1737c-4d92-fd8f-8f96-6cac33157af9\",\n \"assigned_tech_id\": \"55048dcb-418c-0466-d8c4-5601bf64d219\",\n \"status\": \"scheduled\",\n \"priority\": \"scheduled\",\n \"type\": \"service\",\n \"source\": \"call\",\n \"scheduled_date\": \"2026-05-20\",\n \"scheduled_start\": \"2007-05-30T06:28:53.552Z\",\n \"scheduled_end\": \"1957-11-26T19:51:00.574Z\",\n \"actual_arrival\": \"1980-11-01T11:42:55.013Z\",\n \"actual_start\": \"2014-07-13T21:11:54.022Z\",\n \"actual_end\": \"2007-08-25T16:13:50.590Z\",\n \"problem_description\": \"AC not cooling — possibly low refrigerant. Customer says it ran fine yesterday.\",\n \"diagnosis\": \"R-410A leak at evaporator coil. ~0.5 lb low.\",\n \"work_performed\": \"Replaced evaporator coil. Recharged refrigerant to spec. Pressure-tested.\",\n \"parent_job_id\": \"8cdc0321-6f07-28d9-7a68-49da581ad46c\",\n \"estimate_id\": \"3b286256-298c-5e26-a49d-27694158e8c6\",\n \"created_at\": \"2016-06-09T18:02:11.275Z\",\n \"updated_at\": \"1980-06-19T23:10:17.640Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0756640-9808-4ee1-97cd-d1d910ed91b5", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fefa14e-c70d-4c5c-9c98-fbd4d4118967", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3f501136-6773-4738-9994-746914b81400", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d04ae1c5-fe52-4fd5-862f-e2daec045765", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11accc3a-467b-4ca2-9506-198bf693b1b2", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12469518-15fd-42e2-8717-ffa965dfe134", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30693787-3565-402b-b179-22c5523ea3d2", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "48717974-aba3-471d-83ab-9d52d21dd33a", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "jobs", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3e3d475f-b2c2-4989-b77d-6a5cdd6aa1c2", "name": "Memberships", "description": { "content": "Customer service-agreement subscriptions.", "type": "text/plain" }, "item": [ { "id": "ab02e1dd-9066-4db5-930d-52edb3e0ce38", "name": "List memberships", "request": { "name": "List memberships", "description": {}, "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "f64f90bb-78cf-4a53-aa76-ee3702f5fe29", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"638f580f-70ea-fb5a-0a3b-1217edbcff0a\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"16a1ba58-7a21-703c-54dc-99f5274736b2\",\n \"service_agreement_id\": \"9c790268-467f-ef8c-ae7a-0b3288c05d05\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"2009-05-04T01:57:40.457Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2012-08-10T16:45:55.978Z\",\n \"created_at\": \"1969-06-24T21:52:48.267Z\",\n \"updated_at\": \"1966-09-10T21:12:07.614Z\"\n },\n {\n \"id\": \"ed39955e-08a6-8e0d-31dd-2067b502d5eb\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"9714cc84-bed1-b73c-1726-610bd55eead0\",\n \"service_agreement_id\": \"25cced23-e864-24f2-dc89-f1bbf0880a5b\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"2016-07-02T01:23:58.474Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2006-05-07T10:26:14.251Z\",\n \"created_at\": \"1990-10-26T23:00:11.046Z\",\n \"updated_at\": \"1954-05-03T15:24:07.828Z\"\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "557bb459-33eb-4101-9844-177264b7332c", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "101b700f-8741-4ba6-8ff9-06985fe34ab1", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d828e1a-7209-4b72-ae45-cab06bafe11f", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38b3a388-1b31-438d-ad1a-6650e12c5a87", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e82d56b-563d-4838-a8a7-3fec59fdc68d", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cc84fffd-6685-40a1-8305-759e815c04c0", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4f868296-6b94-479f-bbd6-7faa36e84431", "name": "Create or upsert a membership", "request": { "name": "Create or upsert a membership", "description": { "content": "Provide `customer_id` (UUID) OR `customer_external_id` + `customer_external_source` for the owning customer. `service_agreement_id` is UUID-only — that table has no external_id columns in V1. PATCH on this resource is status-only.", "type": "text/plain" }, "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"\",\n \"external_source\": \"\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"\",\n \"customer_external_source\": \"\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"next_billing_date\": \"\",\n \"next_maintenance_date\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9885810f-4cb2-48da-bf20-d16a15a480ee", "name": "OK — an existing row was updated. Returned when the supplied `external_id` + `external_source` matched an existing row (idempotent retry).", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"485ef4ad-7e25-291c-defb-3104658c4b0e\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"14d30608-e95d-563c-bcfb-7dc0ef87ad0e\",\n \"service_agreement_id\": \"41acffeb-15e1-27a8-5bdc-a57285f650dc\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"1976-09-16T00:17:46.163Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2020-05-09T14:07:22.352Z\",\n \"created_at\": \"2006-04-30T23:38:25.954Z\",\n \"updated_at\": \"1970-10-13T03:18:17.808Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "63e0f93d-b5af-4a5c-bfb7-87223dfe2672", "name": "Created — a new row was inserted.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"485ef4ad-7e25-291c-defb-3104658c4b0e\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"14d30608-e95d-563c-bcfb-7dc0ef87ad0e\",\n \"service_agreement_id\": \"41acffeb-15e1-27a8-5bdc-a57285f650dc\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"1976-09-16T00:17:46.163Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2020-05-09T14:07:22.352Z\",\n \"created_at\": \"2006-04-30T23:38:25.954Z\",\n \"updated_at\": \"1970-10-13T03:18:17.808Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "43f7af1f-9545-4b7a-87f3-a7aae2ef8b2d", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "03c883c7-bb99-42e7-9e10-b0c6e45a5c2f", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff71e79c-abc8-4db5-9bf5-e944aeecf612", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "36989ded-6931-4b8d-9075-97eba5f863f4", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe883d92-1554-48db-a826-d6089647f819", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6eb26e97-5a0f-4274-8435-e9e2125148cf", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b57e59ee-cb52-49b5-b0ca-05fca84553f0", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11e4c8de-eeb0-41d2-a9aa-b36e220ab1fe", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "memberships" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"service_agreement_id\": \"\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"\",\n \"customer_external_id\": \"crm-acme-001\",\n \"customer_external_source\": \"servicetitan\",\n \"status\": \"\",\n \"billing_cycle\": \"\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "586adfe0-5313-41a2-b755-83e1e4bcd08f", "name": "Get a membership", "request": { "name": "Get a membership", "description": {}, "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "dad00238-c1d9-4403-88d1-712f6db98037", "name": "Single resource.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"485ef4ad-7e25-291c-defb-3104658c4b0e\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"14d30608-e95d-563c-bcfb-7dc0ef87ad0e\",\n \"service_agreement_id\": \"41acffeb-15e1-27a8-5bdc-a57285f650dc\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"1976-09-16T00:17:46.163Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2020-05-09T14:07:22.352Z\",\n \"created_at\": \"2006-04-30T23:38:25.954Z\",\n \"updated_at\": \"1970-10-13T03:18:17.808Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71858e79-6994-4c41-bdbd-b342f90a2562", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6f7ee937-7692-4bf2-87b9-d05f40a82836", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1143d169-39ee-463e-87fa-7f7dd4223444", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8af2a715-e484-4aac-b765-bcb548de4e9d", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2699c1c1-a8ab-41e2-b5e3-023f0064a1e7", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8e092f8-abab-47ec-9645-94d019ba3e5c", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "02940016-0ee6-43f8-bf7b-59e4251ade12", "name": "Update a membership's status", "request": { "name": "Update a membership's status", "description": {}, "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "80b06759-1ecd-44ee-8d70-21e6da9e1d7b", "name": "OK — row updated. Body returns the full updated resource.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"485ef4ad-7e25-291c-defb-3104658c4b0e\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"14d30608-e95d-563c-bcfb-7dc0ef87ad0e\",\n \"service_agreement_id\": \"41acffeb-15e1-27a8-5bdc-a57285f650dc\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"1976-09-16T00:17:46.163Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2020-05-09T14:07:22.352Z\",\n \"created_at\": \"2006-04-30T23:38:25.954Z\",\n \"updated_at\": \"1970-10-13T03:18:17.808Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1597ce6-b83b-4ad5-8d72-8e2c538ecf21", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d1f36d88-2af2-4332-bc2c-c62f5649cab2", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "daec542d-1a5e-46cc-894d-3d4fba81d3fd", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ef59439-64eb-42fb-9fcd-6f80d8cac966", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a300aad-c822-4cd2-9d0c-db2aecc6b1fa", "name": "Concurrent INSERT race lost — another request with the same `external_id` + `external_source` won. Retry the same payload; the upsert will hit the existing row and return 200.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c6d378ec-f1d8-429f-8dbd-533eefd988f5", "name": "Request body validation failed (Zod). Common causes: missing required field, unknown field (.strict()), `external_id` without `external_source`, FK reference not found in this organization, invalid job status transition.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17d1d68d-fd26-4d81-b928-a38276df04ac", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41a6c296-20a6-46d7-81cb-1b605a8c0cd5", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "memberships", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c7bf6126-36f5-4279-b6a3-30b44149c9b8", "name": "Look up a membership by external_id", "request": { "name": "Look up a membership by external_id", "description": {}, "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "external_id", "value": "", "description": "(Required) " }, { "disabled": false, "key": "external_source", "value": "", "description": "(Required) " } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4689045e-99cc-47ba-935a-a62f228e3500", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"485ef4ad-7e25-291c-defb-3104658c4b0e\",\n \"external_id\": \"crm-acme-mship-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"14d30608-e95d-563c-bcfb-7dc0ef87ad0e\",\n \"service_agreement_id\": \"41acffeb-15e1-27a8-5bdc-a57285f650dc\",\n \"status\": \"active\",\n \"billing_cycle\": \"monthly\",\n \"start_date\": \"2026-01-15\",\n \"end_date\": \"2027-01-15\",\n \"next_billing_date\": \"2026-06-15\",\n \"next_maintenance_date\": \"2026-09-15\",\n \"cancelled_at\": \"1976-09-16T00:17:46.163Z\",\n \"cancellation_reason\": \"Customer moved out of service area.\",\n \"suspended_at\": \"2020-05-09T14:07:22.352Z\",\n \"created_at\": \"2006-04-30T23:38:25.954Z\",\n \"updated_at\": \"1970-10-13T03:18:17.808Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97400306-a161-4d79-be56-162f46c755a2", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4dc68826-4662-464b-be58-601b0ce2c9d9", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c40f1b46-9ed8-44b3-b5cf-77740cae2053", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe8f98eb-8fd1-48d0-82fe-c3ce4851f1a5", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "104abe66-fb4a-4885-b577-efaf17cafbb8", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e8659e6-1a5c-4416-8ac4-9e9dc35fe4e8", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "memberships", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "145607db-c8f2-409f-9c2a-0f5cb408671e", "name": "Estimates", "description": { "content": "Good/Better/Best estimates (read-only — push via Jobs).", "type": "text/plain" }, "item": [ { "id": "a00e8ae3-79ff-4129-b38f-ce86dd0ebab4", "name": "List estimates", "request": { "name": "List estimates", "description": {}, "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "status", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "076633bf-ec39-46bb-b20c-55a52e803f0a", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"df1fb42a-249c-0f6a-5f63-475140729509\",\n \"external_id\": \"crm-acme-est-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"74f33c2b-da45-09e7-59c9-d2f2642e7637\",\n \"property_id\": \"c0af43f6-dc43-0812-ed48-fe23d2a6b0b3\",\n \"equipment_id\": \"e9dbfb54-0953-9fb8-c4a0-844e938174a2\",\n \"status\": \"sent\",\n \"valid_until\": \"2026-06-13\",\n \"customer_approved_at\": \"1993-04-20T15:20:50.081Z\",\n \"notes\": \"AC replacement + new smart thermostat install. Includes 10-year parts warranty.\",\n \"converted_job_id\": \"32733a9b-9239-cbbf-5303-80597a9826af\",\n \"currency\": \"USD\",\n \"amount\": 7850,\n \"options\": [\n {\n \"id\": \"6ba0006d-d1c9-f8f3-92a8-a77bfc593523\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": false,\n \"sort_order\": 9135.159327891555\n },\n {\n \"id\": \"17aea502-c757-d3b8-1fd8-360ea8bd5fc3\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": false,\n \"sort_order\": 3149.5269198606866\n }\n ],\n \"created_at\": \"1965-12-27T11:15:21.782Z\",\n \"updated_at\": \"1969-06-21T15:34:48.815Z\"\n },\n {\n \"id\": \"d4a77da2-6d51-1bf4-5ca9-32c8b57345d7\",\n \"external_id\": \"crm-acme-est-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"629fcd3b-8b87-761a-6034-e638754057dd\",\n \"property_id\": \"d3158b96-12ea-f9be-5e6b-61343c62327b\",\n \"equipment_id\": \"b39ab64e-56a3-bb64-199f-6b3b7f84aa84\",\n \"status\": \"sent\",\n \"valid_until\": \"2026-06-13\",\n \"customer_approved_at\": \"2002-10-15T04:54:58.024Z\",\n \"notes\": \"AC replacement + new smart thermostat install. Includes 10-year parts warranty.\",\n \"converted_job_id\": \"01975a15-1679-1e4b-f139-2c94673b6297\",\n \"currency\": \"USD\",\n \"amount\": 7850,\n \"options\": [\n {\n \"id\": \"2ffdfbde-5bf7-9dcb-ed4e-cb2aff47bdf9\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": false,\n \"sort_order\": 8691.690978410763\n },\n {\n \"id\": \"b734db73-3337-806f-87c9-1a7b22f354a8\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": true,\n \"sort_order\": 754.3809160474957\n }\n ],\n \"created_at\": \"1997-02-14T11:13:14.048Z\",\n \"updated_at\": \"1968-05-04T10:52:14.559Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8e70513-9a6b-431d-87e9-40d91a32f9ea", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15d1a4f4-187c-499e-a6fe-c2e18cbb0dd9", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ce13498-bfa5-4e78-b9ed-c1d12e08a444", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55a68dd7-064d-400e-8d0d-9d5b36fb5f2b", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbcac4d5-0a7f-454d-9467-028d5f1501c4", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "652c454a-6626-47b0-a6aa-b0aebdb403e5", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "estimates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "129da728-b40e-41bb-a46a-9bd88c5179eb", "name": "Get a estimate", "request": { "name": "Get a estimate", "description": {}, "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "a77c0a5b-afbe-48aa-adc5-cf7066027107", "name": "Single resource.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"e4651223-85e3-3c88-762c-4bd684396e4b\",\n \"external_id\": \"crm-acme-est-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"c3d6ad9a-5277-58a4-2ef6-4b93fe376bbc\",\n \"property_id\": \"c9dc0664-c97d-f916-e489-304e852a8af0\",\n \"equipment_id\": \"f53f9c62-62e7-c9ec-53b0-0580c09d0366\",\n \"status\": \"sent\",\n \"valid_until\": \"2026-06-13\",\n \"customer_approved_at\": \"2020-07-23T06:58:13.587Z\",\n \"notes\": \"AC replacement + new smart thermostat install. Includes 10-year parts warranty.\",\n \"converted_job_id\": \"3d7411c9-a780-9822-9c64-5f4e6b682646\",\n \"currency\": \"USD\",\n \"amount\": 7850,\n \"options\": [\n {\n \"id\": \"a6243ecb-9944-805b-5ffa-702a4871bad6\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": true,\n \"sort_order\": 4272.0675220238645\n },\n {\n \"id\": \"fcae4916-2d3a-7f7f-fbb1-90df08436e14\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": false,\n \"sort_order\": 5217.849370481038\n }\n ],\n \"created_at\": \"1983-02-10T21:07:20.750Z\",\n \"updated_at\": \"1989-09-28T16:23:27.993Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c5deb59c-40f8-4899-a4a5-4a0b8b500a0d", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e5cbcc1-ed15-4945-ab4c-032bee7bf5c1", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "736735e2-d9e3-4d50-880f-04122417f64d", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9806025-d60c-4732-94f5-53c0905186cb", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d810ba40-58c9-4710-be10-f703366045df", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0858c0b9-7e80-4494-b78e-a9bb25a9b619", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "estimates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8f247458-6f93-44cc-a96d-3d3b6b245608", "name": "Look up an estimate by external_id", "request": { "name": "Look up an estimate by external_id", "description": {}, "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "external_id", "value": "", "description": "(Required) " }, { "disabled": false, "key": "external_source", "value": "", "description": "(Required) " } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "4a4141fa-dc2e-4a79-a73d-fe9760ab00a3", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"e4651223-85e3-3c88-762c-4bd684396e4b\",\n \"external_id\": \"crm-acme-est-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"c3d6ad9a-5277-58a4-2ef6-4b93fe376bbc\",\n \"property_id\": \"c9dc0664-c97d-f916-e489-304e852a8af0\",\n \"equipment_id\": \"f53f9c62-62e7-c9ec-53b0-0580c09d0366\",\n \"status\": \"sent\",\n \"valid_until\": \"2026-06-13\",\n \"customer_approved_at\": \"2020-07-23T06:58:13.587Z\",\n \"notes\": \"AC replacement + new smart thermostat install. Includes 10-year parts warranty.\",\n \"converted_job_id\": \"3d7411c9-a780-9822-9c64-5f4e6b682646\",\n \"currency\": \"USD\",\n \"amount\": 7850,\n \"options\": [\n {\n \"id\": \"a6243ecb-9944-805b-5ffa-702a4871bad6\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": true,\n \"sort_order\": 4272.0675220238645\n },\n {\n \"id\": \"fcae4916-2d3a-7f7f-fbb1-90df08436e14\",\n \"tier\": \"better\",\n \"title\": \"Better — 16 SEER AC + smart thermostat\",\n \"description\": \"Carrier Performance series, smart thermostat install, 10-year parts warranty.\",\n \"total_price\": 7850,\n \"is_selected\": false,\n \"sort_order\": 5217.849370481038\n }\n ],\n \"created_at\": \"1983-02-10T21:07:20.750Z\",\n \"updated_at\": \"1989-09-28T16:23:27.993Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "991a9f79-6975-4fb8-9ef1-69bb3bed8c71", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac9abe1d-3ad7-40b2-b50d-b2c03bea1d40", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ba63646-3af0-44c6-b88f-ed82ba7e30c4", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "591bc497-6083-465d-a18d-2ba45ce4199c", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18f70373-bfdc-4a85-bbac-02182a1990f7", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c2c473ca-d3e9-41a1-8f3f-a2e1cb4e0417", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "estimates", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7efbf11f-77b4-4250-bc2a-b3acb17f5c7f", "name": "Invoices", "description": { "content": "Derived from completed jobs (read-only).", "type": "text/plain" }, "item": [ { "id": "ac0ce30c-db7d-4f5d-a5fb-a8793e625724", "name": "List invoices", "request": { "name": "List invoices", "description": {}, "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "status", "value": "" }, { "disabled": false, "key": "paid", "value": "", "description": "Convenience shortcut: `paid=true` → status='paid'; `paid=false` → status≠'paid'." }, { "disabled": false, "key": "issued_after", "value": "", "description": "Filter by `sent_at > issued_after` (not created_at — drafts predate issuance)." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "42de491a-1ca0-4725-9ff1-5dbfe62747b1", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"20779a1a-5c41-8f78-0515-eb1037eea65a\",\n \"external_id\": \"crm-acme-inv-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"5aeb53f6-b938-82cc-5206-5b3f7fd65a70\",\n \"job_id\": \"7f452dc8-624b-be3e-21d7-6f0520fc923a\",\n \"invoice_number\": \"INV-2026-1042\",\n \"status\": \"sent\",\n \"subtotal\": 450,\n \"tax_amount\": 36,\n \"tax_rate\": 0.08,\n \"total\": 486,\n \"currency\": \"USD\",\n \"due_date\": \"2026-06-12\",\n \"sent_at\": \"1962-01-11T23:58:57.774Z\",\n \"paid_at\": \"1990-08-23T15:01:58.762Z\",\n \"notes\": \"Service call + evaporator coil replacement. Net 30.\",\n \"created_at\": \"2013-07-18T01:36:56.839Z\",\n \"updated_at\": \"1950-10-19T09:23:09.584Z\"\n },\n {\n \"id\": \"96c6a29c-e6cb-9762-50aa-853be70c72f6\",\n \"external_id\": \"crm-acme-inv-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"b43daed1-a662-e202-b37f-70b31f88b7c9\",\n \"job_id\": \"a0373863-3f9b-de55-28bd-5494c48adf1d\",\n \"invoice_number\": \"INV-2026-1042\",\n \"status\": \"sent\",\n \"subtotal\": 450,\n \"tax_amount\": 36,\n \"tax_rate\": 0.08,\n \"total\": 486,\n \"currency\": \"USD\",\n \"due_date\": \"2026-06-12\",\n \"sent_at\": \"1987-08-03T20:18:13.234Z\",\n \"paid_at\": \"2015-03-19T18:50:27.787Z\",\n \"notes\": \"Service call + evaporator coil replacement. Net 30.\",\n \"created_at\": \"1955-07-24T05:18:31.859Z\",\n \"updated_at\": \"2021-03-27T05:37:47.161Z\"\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38ddce90-1c65-4db4-b4f7-96d67924fd52", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c1cefcf-76b4-49bc-8917-6cefc36829e5", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "39004f79-7c27-4311-bc73-15a13c3431c6", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c4c58de-e08d-4cea-9acb-7f85b29a94bc", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a894bcf8-83d3-4618-87b9-d04af9089b89", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75b67c11-885e-4189-bef2-5cfffbb4bead", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "status", "value": "" }, { "key": "paid", "value": "" }, { "key": "issued_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "39b10750-e489-4d13-9cff-6c20dd6fc926", "name": "Get a invoice", "request": { "name": "Get a invoice", "description": {}, "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3552aabd-c304-4d72-82fc-3c7fffd64bef", "name": "Single resource.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"27d84be3-4d7b-f367-185f-9d457fa5773a\",\n \"external_id\": \"crm-acme-inv-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"6e1c05e5-70ee-9187-6dc2-8f7a0a28df43\",\n \"job_id\": \"9d76cc43-cd71-2a86-2445-dfaad7db3f46\",\n \"invoice_number\": \"INV-2026-1042\",\n \"status\": \"sent\",\n \"subtotal\": 450,\n \"tax_amount\": 36,\n \"tax_rate\": 0.08,\n \"total\": 486,\n \"currency\": \"USD\",\n \"due_date\": \"2026-06-12\",\n \"sent_at\": \"1999-03-13T16:33:34.669Z\",\n \"paid_at\": \"2016-12-06T04:45:32.578Z\",\n \"notes\": \"Service call + evaporator coil replacement. Net 30.\",\n \"created_at\": \"1963-03-31T12:52:20.573Z\",\n \"updated_at\": \"1967-04-08T02:36:49.344Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eaf38832-7a3f-416e-9d0f-d065585feccf", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cb1d6a95-88bd-4916-99d9-5df9c26070ec", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0fa9fc6a-ea32-4977-8585-a8cd7d8c9f5d", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "911dc685-882a-4c8e-a083-d312686165cc", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf3d9157-3d7d-4678-8137-46ae36f9d887", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6c5c80a3-ea0a-4283-8173-4d39dc6360a6", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "invoices", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3c386d5d-1aff-48c1-97a1-4caa2a92c166", "name": "Look up an invoice by external_id", "request": { "name": "Look up an invoice by external_id", "description": {}, "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "external_id", "value": "", "description": "(Required) " }, { "disabled": false, "key": "external_source", "value": "", "description": "(Required) " } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "eaf1704d-5162-4279-8488-c99aeef8b57f", "name": "Matched resource.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"27d84be3-4d7b-f367-185f-9d457fa5773a\",\n \"external_id\": \"crm-acme-inv-001\",\n \"external_source\": \"servicetitan\",\n \"customer_id\": \"6e1c05e5-70ee-9187-6dc2-8f7a0a28df43\",\n \"job_id\": \"9d76cc43-cd71-2a86-2445-dfaad7db3f46\",\n \"invoice_number\": \"INV-2026-1042\",\n \"status\": \"sent\",\n \"subtotal\": 450,\n \"tax_amount\": 36,\n \"tax_rate\": 0.08,\n \"total\": 486,\n \"currency\": \"USD\",\n \"due_date\": \"2026-06-12\",\n \"sent_at\": \"1999-03-13T16:33:34.669Z\",\n \"paid_at\": \"2016-12-06T04:45:32.578Z\",\n \"notes\": \"Service call + evaporator coil replacement. Net 30.\",\n \"created_at\": \"1963-03-31T12:52:20.573Z\",\n \"updated_at\": \"1967-04-08T02:36:49.344Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "890959bc-105f-44ef-9f49-39e0efaaf077", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41d8b014-fef3-411c-a310-75e8dc041935", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0afb2ab5-8fc6-46cc-b431-80175912f553", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9bf462c3-ac8d-46e4-83ab-5f1c50f44db5", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1781644-32a6-4af0-b899-cb12072bfb1e", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5a41e168-0858-4f9b-8524-445f682d3425", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "invoices", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "external_id", "value": "" }, { "key": "external_source", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7e7f54f9-cde5-4f47-9f93-405d2feb650a", "name": "Payments", "description": { "content": "Recorded against invoices (read-only).", "type": "text/plain" }, "item": [ { "id": "12e3a498-bdd3-4fb6-82d0-fbabacecf9e4", "name": "List payments", "request": { "name": "List payments", "description": {}, "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "invoice_id", "value": "" }, { "disabled": false, "key": "status", "value": "" }, { "disabled": false, "key": "method", "value": "" }, { "disabled": false, "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "336dfc51-97b1-40c5-aef8-757d6aa71355", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"0173c236-0451-7964-4adb-ac1f4a5c9d4a\",\n \"invoice_id\": \"796e5583-0349-f721-e647-ebb47419c882\",\n \"amount\": 486,\n \"currency\": \"USD\",\n \"method\": \"credit_card\",\n \"status\": \"succeeded\",\n \"stripe_payment_id\": \"pi_3OqK4nJ8ZcU2bC0a1Y2eX3f\",\n \"collected_at\": \"1973-09-11T12:59:14.855Z\",\n \"collected_by\": \"7343d7d6-5a82-3e85-adf6-98128e6939b8\",\n \"created_at\": \"1963-02-24T10:32:41.360Z\",\n \"updated_at\": \"1985-01-14T15:55:13.854Z\"\n },\n {\n \"id\": \"1e42ab7c-abcb-b9c9-1e0d-8916d9955087\",\n \"invoice_id\": \"82993da4-8e74-9672-33f3-a45e25e17931\",\n \"amount\": 486,\n \"currency\": \"USD\",\n \"method\": \"credit_card\",\n \"status\": \"succeeded\",\n \"stripe_payment_id\": \"pi_3OqK4nJ8ZcU2bC0a1Y2eX3f\",\n \"collected_at\": \"2004-07-03T07:59:48.955Z\",\n \"collected_by\": \"854c2856-b3f9-cc69-8607-715b073e0abb\",\n \"created_at\": \"1974-05-10T18:59:50.991Z\",\n \"updated_at\": \"2015-09-27T11:10:32.823Z\"\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55f94b90-d695-4b68-be43-6be46560b9b3", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f697a95c-7746-49cc-8275-3bed13273d7e", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "97ae2799-1f9a-456a-b155-ee440627929b", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d27ba439-6ac4-4f8f-a658-7495bff0dbf6", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "68d8b9fe-e0b1-4cf3-aac5-6ef1bcac922f", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12e2f6ab-68d1-4a7b-9da4-65e469c5765c", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "payments" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "invoice_id", "value": "" }, { "key": "status", "value": "" }, { "key": "method", "value": "" }, { "key": "collected_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f1bdb08d-f383-4023-b940-60e298a95347", "name": "Get a payment", "request": { "name": "Get a payment", "description": {}, "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1bc4f268-f328-4d37-b9c4-8c09b832db93", "name": "Single resource.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"a6dec712-383d-8dff-823d-212275f3247c\",\n \"invoice_id\": \"53222f27-1b44-eda8-9b7e-1c0232747f3e\",\n \"amount\": 486,\n \"currency\": \"USD\",\n \"method\": \"credit_card\",\n \"status\": \"succeeded\",\n \"stripe_payment_id\": \"pi_3OqK4nJ8ZcU2bC0a1Y2eX3f\",\n \"collected_at\": \"2016-11-05T02:40:01.673Z\",\n \"collected_by\": \"cae78609-8c78-ef03-9be4-01176d501ec8\",\n \"created_at\": \"2019-12-28T05:51:37.689Z\",\n \"updated_at\": \"1970-02-22T00:24:32.470Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa645552-606b-46b5-808e-8258b5e6d352", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d5729ee-ed05-4272-85f9-295ff84eb5aa", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8fcb5f61-a508-4404-966c-a94d19d9a69a", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed1e4aea-43e2-44e3-ae03-c4ba08b2165b", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34148585-c679-477b-9315-a53742566b6e", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b927b27-376f-444b-be63-76928216a1b8", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "payments", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "58d4546f-97b5-4ede-9086-c1374066568f", "name": "Voice Calls", "description": { "content": "AI receptionist calls — unique-to-us asset with transcripts.", "type": "text/plain" }, "item": [ { "id": "60c04e87-c1c5-4bd5-976c-085fa4ac193c", "name": "List voice calls", "request": { "name": "List voice calls", "description": { "content": "List endpoint excludes `transcript` and `recording_url` to keep payloads small. Detail includes both.", "type": "text/plain" }, "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "triage_status", "value": "" }, { "disabled": false, "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "758b61ee-3285-4666-bf16-1bbe31967125", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"723ab8fb-9618-f583-5f75-d7a63c45c499\",\n \"customer_id\": \"d6259b70-ae7e-ff43-5769-949d3a28dcee\",\n \"call_direction\": \"inbound\",\n \"call_status\": \"completed\",\n \"from_number\": \"+15555550100\",\n \"to_number\": \"+15555550199\",\n \"duration_seconds\": 247,\n \"is_spam\": true,\n \"is_billable\": true,\n \"summary\": \"Customer reporting AC not cooling. Requested same-day service. Confirmed appointment for tomorrow 9am.\",\n \"user_sentiment\": \"positive\",\n \"call_intent\": \"service_request\",\n \"urgency_level\": \"routine\",\n \"triage_status\": \"new\",\n \"created_at\": \"2018-05-12T01:57:40.409Z\",\n \"updated_at\": \"1976-04-28T15:15:45.744Z\"\n },\n {\n \"id\": \"01770616-ff55-04e9-e812-e9c97aac012f\",\n \"customer_id\": \"1be1c6b3-cfe5-8897-5924-9a1bb14bf149\",\n \"call_direction\": \"inbound\",\n \"call_status\": \"completed\",\n \"from_number\": \"+15555550100\",\n \"to_number\": \"+15555550199\",\n \"duration_seconds\": 247,\n \"is_spam\": false,\n \"is_billable\": false,\n \"summary\": \"Customer reporting AC not cooling. Requested same-day service. Confirmed appointment for tomorrow 9am.\",\n \"user_sentiment\": \"positive\",\n \"call_intent\": \"service_request\",\n \"urgency_level\": \"routine\",\n \"triage_status\": \"new\",\n \"created_at\": \"2006-05-14T16:28:55.831Z\",\n \"updated_at\": \"1952-12-11T15:46:58.944Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d869b7c-95be-49f9-8817-370c7347bc6e", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42a04614-f56b-46d6-b2a8-231c13bac496", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f1f013f2-61f0-40c4-a629-037312e3210f", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d808a12-d7d9-4dba-b565-681365bcd4e3", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "756ebe45-5252-446f-bf8d-971fc5bf0eb1", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81afea20-5381-4e68-bc01-6d2dae6c3501", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "voice-calls" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "triage_status", "value": "" }, { "key": "created_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "da043f83-f864-4444-8947-1761fdf66162", "name": "Get a voice call", "request": { "name": "Get a voice call", "description": { "content": "Returns full call detail including transcript text and recording_url. Recording URLs are signed when fetched from Supabase Storage; they expire after 15 minutes.", "type": "text/plain" }, "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "57c06f6c-1a7a-4e42-b2f5-d268ba219fc1", "name": "Single resource.", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"value\": \"", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b27fea4-4df9-4276-9be5-2ceea1b71ac9", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a072bb4c-2836-4241-b544-8510d633f0d2", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b3f4f20-46e0-4184-820b-206bf32cf5bf", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4114dffd-6dd4-4453-9187-aa33d16a30c1", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80f4742f-c098-404c-b4ff-f1e81e57ea7e", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "voice-calls", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "721f6740-3dbc-4c44-b378-1963c8978539", "name": "Pricebook", "description": { "content": "Services, parts, labor, and bundles.", "type": "text/plain" }, "item": [ { "id": "f8db870b-44f7-4949-a24b-a43f06bf7099", "name": "List pricebook", "request": { "name": "List pricebook", "description": {}, "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "category_id", "value": "" }, { "disabled": false, "key": "type", "value": "" }, { "disabled": false, "key": "active", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b6ef53d7-bd5d-4b9b-9851-e4e593ae98a3", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"c8591b1d-bb4c-19ca-faf1-675465172531\",\n \"category_id\": \"8742b4d1-d925-0063-1c5b-7a934e5b1b1f\",\n \"name\": \"Diagnostic Service Call\",\n \"description\": \"1-hour HVAC system diagnostic. Includes written estimate.\",\n \"type\": \"service\",\n \"unit_price\": 89,\n \"unit_cost\": 25,\n \"currency\": \"USD\",\n \"is_taxable\": true,\n \"is_active\": false,\n \"created_at\": \"1966-04-14T03:00:01.619Z\",\n \"updated_at\": \"1982-11-17T10:25:13.191Z\"\n },\n {\n \"id\": \"1fdd8aa6-2e8b-bcab-6bff-57509fc73dd1\",\n \"category_id\": \"d5045a8d-889b-3247-eb1f-33537de23b59\",\n \"name\": \"Diagnostic Service Call\",\n \"description\": \"1-hour HVAC system diagnostic. Includes written estimate.\",\n \"type\": \"service\",\n \"unit_price\": 89,\n \"unit_cost\": 25,\n \"currency\": \"USD\",\n \"is_taxable\": true,\n \"is_active\": false,\n \"created_at\": \"2005-07-03T02:20:43.258Z\",\n \"updated_at\": \"1988-03-16T15:58:18.618Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "319aba95-c981-4d6d-be12-d3aab49090da", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3790f3d9-d426-4263-a12a-371e8745707f", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b174537-d824-4317-8503-9d1f14e0d982", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e9bf685-d012-4b25-bb7a-9483bd25e217", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8e8402d8-ea05-4d76-bfff-ebf87af2ab4f", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "405abb1e-c2aa-44e0-9852-ed73da1776ab", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "pricebook" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "category_id", "value": "" }, { "key": "type", "value": "" }, { "key": "active", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8b746618-d348-4031-8164-bcbb1362e923", "name": "Get a pricebook", "request": { "name": "Get a pricebook", "description": {}, "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "09f3a86d-7c0c-4755-b1cf-4d95336f6f47", "name": "Single resource.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"5e513fb3-99b0-3ddc-309e-3d96e0a415dd\",\n \"category_id\": \"f02e17ef-3bed-c969-b5a6-132cfb098c4e\",\n \"name\": \"Diagnostic Service Call\",\n \"description\": \"1-hour HVAC system diagnostic. Includes written estimate.\",\n \"type\": \"service\",\n \"unit_price\": 89,\n \"unit_cost\": 25,\n \"currency\": \"USD\",\n \"is_taxable\": true,\n \"is_active\": false,\n \"created_at\": \"1988-06-07T23:15:01.888Z\",\n \"updated_at\": \"1967-01-20T03:29:50.885Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e429c095-df8c-4b7f-b612-42fbe70bd720", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "93fde959-0c02-4686-a42f-a6ba29a10c3c", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42b0ac4d-90fe-4704-989e-be610d17fbe6", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8736dcd-12d2-4e96-8409-af73016e447b", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d297f063-86cb-4ddd-95c6-9aedf1c6a198", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4afcef27-05dd-4b5e-81f0-86231e97bc36", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "pricebook", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "67306496-66a6-417c-a9ce-b49e0286792b", "name": "Communications", "description": { "content": "Outbound + inbound SMS/email log per customer.", "type": "text/plain" }, "item": [ { "id": "ab3439a2-dd86-41c2-9e36-95d4064a2089", "name": "List communications", "request": { "name": "List communications", "description": {}, "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "", "description": "Page size. Default 50, hard-capped at 100." }, { "disabled": false, "key": "starting_after", "value": "", "description": "Opaque cursor from a previous response's `next_cursor`." }, { "disabled": false, "key": "customer_id", "value": "" }, { "disabled": false, "key": "job_id", "value": "" }, { "disabled": false, "key": "channel", "value": "" }, { "disabled": false, "key": "direction", "value": "" }, { "disabled": false, "key": "status", "value": "" }, { "disabled": false, "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "16c99ee7-5014-41cc-9f79-b4ef58f66d86", "name": "Paginated list.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"1a8c78cd-5c1e-883c-1780-ba2d7ac1ac25\",\n \"customer_id\": \"478a8383-2514-a975-d49e-d751baede666\",\n \"job_id\": \"e1dd6116-c449-1a26-acd8-2e7b775ffce4\",\n \"channel\": \"sms\",\n \"direction\": \"outbound\",\n \"type\": \"on_my_way\",\n \"recipient\": \"+15555550100\",\n \"message_body\": \"Hi Jenny, this is Acme HVAC. Your tech is on the way — ETA 9:15am.\",\n \"status\": \"delivered\",\n \"twilio_message_sid\": \"SM3a8f7e6d5c4b3a2918e7f6d5c4b3a291\",\n \"sent_at\": \"1989-09-17T04:18:32.967Z\",\n \"created_at\": \"1996-12-30T14:13:03.908Z\",\n \"updated_at\": \"2001-01-19T14:01:48.459Z\"\n },\n {\n \"id\": \"b63c7e1b-6871-cdaf-1163-f4aafe4499e5\",\n \"customer_id\": \"13a41c7f-9add-6c2f-9364-6e0a7fa21014\",\n \"job_id\": \"e732fd38-e6da-a72a-2ecb-8c3c005d778e\",\n \"channel\": \"sms\",\n \"direction\": \"outbound\",\n \"type\": \"on_my_way\",\n \"recipient\": \"+15555550100\",\n \"message_body\": \"Hi Jenny, this is Acme HVAC. Your tech is on the way — ETA 9:15am.\",\n \"status\": \"delivered\",\n \"twilio_message_sid\": \"SM3a8f7e6d5c4b3a2918e7f6d5c4b3a291\",\n \"sent_at\": \"1991-05-14T07:37:14.991Z\",\n \"created_at\": \"2020-12-31T23:26:23.217Z\",\n \"updated_at\": \"2004-11-05T09:54:05.228Z\"\n }\n ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92ea0098-1558-4e67-b7c1-020105015d9d", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5eb92da-8833-4ced-adf8-fe2f7f2e74eb", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "773ee223-bdf6-4574-8159-d9b59a533430", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2a8fc70-77e7-4055-b658-6ac3075e6109", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b98d07cd-d614-4e12-af8c-cd7a3365529f", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1fe4113e-65e1-4c89-b57b-c0e34c81b4e1", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "communications" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "50" }, { "key": "starting_after", "value": "" }, { "key": "customer_id", "value": "" }, { "key": "job_id", "value": "" }, { "key": "channel", "value": "" }, { "key": "direction", "value": "" }, { "key": "status", "value": "" }, { "key": "sent_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9ea93b77-d527-44ac-a1f9-5cfda4ad4e0b", "name": "Get a communication", "request": { "name": "Get a communication", "description": {}, "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "12663517-b595-4f98-82e2-7309c71e6a4d", "name": "Single resource.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"06bcfdee-cad1-0de1-3386-1cff26130173\",\n \"customer_id\": \"d25ff877-5682-830c-a595-5de52a1b5acd\",\n \"job_id\": \"91255808-6ee3-5958-07c5-56ae1208ee33\",\n \"channel\": \"sms\",\n \"direction\": \"outbound\",\n \"type\": \"on_my_way\",\n \"recipient\": \"+15555550100\",\n \"message_body\": \"Hi Jenny, this is Acme HVAC. Your tech is on the way — ETA 9:15am.\",\n \"status\": \"delivered\",\n \"twilio_message_sid\": \"SM3a8f7e6d5c4b3a2918e7f6d5c4b3a291\",\n \"sent_at\": \"1985-10-08T00:48:20.992Z\",\n \"created_at\": \"1991-05-10T03:43:48.580Z\",\n \"updated_at\": \"1981-03-21T10:00:56.750Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c39adb2c-af1a-48ea-b8bf-d49c92d206c6", "name": "Invalid request — query parameter validation failed.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c548b30-50b7-4512-a688-2ff42935eba1", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "316044e4-07c8-4223-bcca-ab27b14aa0b5", "name": "Insufficient scope.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed4e2270-9de0-4dad-b54d-471ae289986c", "name": "Resource not found (or exists in another org — existence is masked).", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2e2f510-b045-4eeb-b2ac-9c03eb41e585", "name": "Rate limit exceeded. Retry after the seconds in `Retry-After`.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d5224e9-508a-467c-ba0b-97297c59cb65", "name": "Unexpected server error.", "originalRequest": { "url": { "path": [ "communications", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) Resource UUID." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"method_not_allowed\",\n \"message\": \"Missing or malformed Authorization header. Expected: Authorization: Bearer rkc_live_...\",\n \"doc_url\": \"https://docs.runacall.com/api#errors-unauthorized\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "6e9c0557-be20-42b5-95b7-b5f8d3a0f06a", "name": "Webhooks", "description": { "content": "Outbound HTTP webhook deliveries from Run a Call to subscriber URLs.\n\n**Authentication.** Every POST carries `Run-A-Call-Signature: t=,v1=`.\nThe signed string is `${ts}.${raw_body}`. Verify with HMAC-SHA256 against the\nsubscription secret. Reject if `Math.abs(now - t) > 5 minutes` to defeat\nreplay attacks.\n\n**Deduplication.** Each delivery's `event.id` (header\n`Run-A-Call-Event-Id`, also in the JSON body) is stable across retries\nof the same logical event. Store the last N event ids you've processed\nand dedupe before applying business logic.\n\n**Retry policy.** Subscriber returns 2xx within 10 seconds → success.\nAnything else (non-2xx, timeout, network error) is retried up to 3 total\nattempts with default Inngest backoff. After 10 consecutive terminal\nfailures, the subscription is auto-paused and the org owner is emailed.\nResume from /settings/integrations/webhooks/{id}.\n\n**Concurrency.** Run a Call caps fan-out at 100 matching subscriptions\nper single internal event and concurrent deliveries at 50 in-flight per\nfunction — beyond that, the system bails rather than fan out unbounded.", "type": "text/plain" }, "item": [], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.runacall.com/v1", "key": "baseUrl" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "info": { "_postman_id": "a11e6e59-fe40-4a44-8892-d2108205f93e", "name": "Run a Call External API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "A bearer-authenticated REST API for pushing data into and pulling data out of **[Run a Call](https://runacall.com)** — the field service platform built for small-to-mid HVAC companies.\n\nUse it to migrate from your old CRM, sync data with accounting tools, fire Zapier / Make / n8n flows on real-time events, or wire your own custom scripts. Same surface internally — no second-class endpoints.\n\n## Quick start\n\n```bash\ncurl https://api.runacall.com/v1/customers \\\n -H \"Authorization: Bearer rkc_live_...\"\n```\n\nGenerate a key from **[Settings → Integrations → API](https://app.runacall.com/settings/integrations/api)**. The token is shown once at creation — store it in a secret manager.\n\n## Authentication\n\nEvery request needs an `Authorization: Bearer rkc_live_...` header.\n\n| Scope | Grants |\n|---|---|\n| `read` | All `GET` endpoints |\n| `write` | `POST` and `PATCH` on customers / properties / equipment / jobs / memberships |\n\nKeys are SHA-256 hashed at rest. The raw token is shown to the org owner exactly once at creation; we cannot retrieve it later.\n\n## Tenant isolation\n\nEvery request is scoped to the organization that owns the bearer token. Cross-org reads return **404 (not 403)** to mask existence. There's no admin scope and no DELETE endpoints anywhere — soft-delete remains a UI-only operation.\n\n## Rate limits\n\n| Layer | Limit | Window |\n|---|---|---|\n| Per key — sustained | 60 req | 1 min rolling |\n| Per key — burst | 120 req | 10 s rolling |\n| Per org — all keys combined | 300 req | 1 min rolling |\n| Concurrent in-flight | 5 | — |\n\nExceeding any layer returns **429** with a `Retry-After` header. Founders can raise a known integrator's limit via per-key override — email **admin@runacall.com**.\n\n## Idempotency: upsert by external_id\n\nEvery writable resource (customers, properties, equipment, jobs, memberships) accepts `external_id` + `external_source`. POSTing the same pair twice **upserts** the existing row (returns 200 with the same id) instead of creating a duplicate (201). Safe to retry, safe to script bulk imports against.\n\n## Pagination\n\nCursor-based, never offset. Pass back the `next_cursor` from a response as `?starting_after=` to fetch the next page.\n\n```json\n{\n \"data\": [ /* up to 100 items */ ],\n \"has_more\": true,\n \"next_cursor\": \"MjAyNi0wNS0wN1QwODo1OTowMi4xMjIzNDQrMDA6MDB8MzZhNTlmMDQ\"\n}\n```\n\nDefault page size 50, hard cap 100.\n\n## Errors\n\nEvery error is the same envelope:\n\n```json\n{\n \"error\": {\n \"code\": \"invalid_request\",\n \"message\": \"external_id is required when upserting\",\n \"doc_url\": \"https://docs.runacall.com/#errors-invalid_request\",\n \"request_id\": \"req_a93a7817f5a8485d80204becea\"\n }\n}\n```\n\nQuote `request_id` when reaching out for support — it correlates to our audit log.\n\n| Code | Status | Meaning |\n|---|---|---|\n| `invalid_request` | 400 / 422 | Body or query validation failed |\n| `unauthorized` | 401 | Missing or invalid bearer token |\n| `forbidden` | 403 | Token lacks the required scope |\n| `not_found` | 404 | Resource doesn't exist (or belongs to another org) |\n| `conflict` | 409 | Concurrent upsert race lost — retry will hit the existing row |\n| `rate_limited` | 429 | Layer exceeded — see `Retry-After` |\n| `internal_error` | 500 | Bug on our end — quote the request_id |\n\n## Webhooks\n\nSubscribe a URL via **[Settings → Integrations → Webhooks](https://app.runacall.com/settings/integrations/webhooks)** to receive real-time events for customers, jobs, estimates, invoices, payments, voice calls, and memberships. Deliveries are **HMAC-SHA256 signed** over `\\${ts}.\\${raw_body}` with the signature in the `Run-A-Call-Signature` header. See the **Webhooks** section in the sidebar for the full event catalog + delivery contract.\n\nContact Support:\n Name: Run a Call Support\n Email: admin@runacall.com", "type": "text/plain" } } }