{"info":{"_postman_id":"d30cfdc6-60a9-4717-a4aa-491eadcb40c6","name":"1. Spotilla API","description":"

Spotilla API collection.

\n

This collection contains the Spotilla REST API endpoints, including WAP session lifecycle operations such as /v3/wap_sessions/start, /v3/wap_sessions/status, /v3/wap_sessions/checkin, and /v3/wap_sessions/stop.

\n

Use the individual request descriptions for endpoint-specific details, headers, and example flows.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"3207762","collectionId":"d30cfdc6-60a9-4717-a4aa-491eadcb40c6","publishedId":"TzJsgyUY","public":true,"customColor":{"top-bar":"286090","right-sidebar":"303030","highlight":"286090"},"publishDate":"2023-12-21T09:49:21.000Z"},"item":[{"name":"Folders / Collections","item":[{"name":"/v3/collections","id":"97b4d821-5370-4c71-8c21-b4f52078c539","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/collections","description":"

This endpoint is used to retrieve a list of folders for which the current user has permissions.

\n

Request Body

\n

This request does not require a request body.

\n","urlObject":{"path":["api","v3","collections"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"c5bda5a9-0fac-48e4-bbde-0b62e1a65d55","name":"/v3/collections","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":"api.spotilla.fi/api/v3/collections"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"spot_ids\": [\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n ],\r\n \"children_ids\": [],\r\n \"num_of_spots\": 2,\r\n \"collection_permissions\": {\r\n \"read\": true,\r\n \"update\": true\r\n },\r\n \"message_permissions\": {\r\n \"read\": true,\r\n \"create\": true\r\n },\r\n \"attachment_permissions\": {\r\n \"read\": true,\r\n \"create\": true\r\n },\r\n \"depth\": 3,\r\n \"collection_extra_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"key\": \"Volume of container\",\r\n \"value\": \"\",\r\n \"input_type\": \"number\",\r\n \"value_selections\": []\r\n }\r\n ],\r\n \"upload_items\": [],\r\n \"locked_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Device Class\",\r\n \"input_type\": \"select\",\r\n \"created_at\": \"2021-02-06T11:05:25.735+02:00\",\r\n \"updated_at\": \"2021-02-06T11:05:25.735+02:00\",\r\n \"type_dependent_data\": \"Class 1,\\nClass 2,\\nClass 3,\\nClass 4,\\nClass 5,\\nClass 6\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Item Health Grading\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Purchase date\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Purchase price\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Voltage (V)\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"spot_ids\": [\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n ],\r\n \"children_ids\": [],\r\n \"num_of_spots\": 2,\r\n \"collection_permissions\": {\r\n \"read\": true,\r\n \"update\": true\r\n },\r\n \"message_permissions\": {\r\n \"read\": true,\r\n \"create\": true\r\n },\r\n \"attachment_permissions\": {\r\n \"read\": true,\r\n \"create\": true\r\n },\r\n \"depth\": 3,\r\n \"collection_extra_fields\": [],\r\n \"upload_items\": [],\r\n \"locked_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Device Class\",\r\n \"input_type\": \"select\",\r\n \"created_at\": \"2021-02-06T11:05:25.735+02:00\",\r\n \"updated_at\": \"2021-02-06T11:05:25.735+02:00\",\r\n \"type_dependent_data\": \"Class 1,\\nClass 2,\\nClass 3,\\nClass 4,\\nClass 5,\\nClass 6\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Item Health Grading\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Purchase date\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Purchase price\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Voltage (V)\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\r\n \"type_dependent_data\": \"\",\r\n \"is_default_attribute\": false\r\n }\r\n ]\r\n }\r\n]"}],"_postman_id":"97b4d821-5370-4c71-8c21-b4f52078c539"},{"name":"/v3/collections/children","id":"f5b01f78-5391-415b-a0a8-95bb6888735f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/collections/children?parent_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&page=1&per_page=100","description":"

This endpoint is used to retrieve a list of folders for which the current user has permissions.

\n

By default returns roots but using the parent_id param gives the children of the specified collection

\n

Request Body

\n

This request does not require a request body.

\n

Pagination

\n

Endpoint is paginated and by default will return first page if nothing else is specified

\n

Response Body

\n

The request returns an object with data array and some meta fields.

\n

Included are, page, how many items per page, total count of records, and the actual data.

\n

Inside the data number of children for current item can be seen, and number of spots in the sub tree.

\n","urlObject":{"path":["api","v3","collections","children"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

Parent UUID, empty value gives roots, while a valid collection ID gives that specific collections children

\n","type":"text/plain"},"key":"parent_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

Pagination page, empty value will default to 1

\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"

Number of items per page

\n","type":"text/plain"},"key":"per_page","value":"100"}],"variable":[]}},"response":[{"id":"cf97ee3e-e095-4a53-8ded-1119bf0f444d","name":"/v3/collections/children","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/children?parent_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&page=1&per_page=100","host":["api","spotilla","fi"],"path":["api","v3","collections","children"],"query":[{"key":"parent_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"Parent UUID, empty value gives roots, while a valid collection ID gives that specific collections children"},{"key":"page","value":"1","description":"Pagination page, empty value will default to 1"},{"key":"per_page","value":"100","description":"Number of items per page"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"page\": 1,\n \"per_page\": 100,\n \"total_count\": 1,\n \"total_pages\": 1,\n \"data\": [\n {\n \"id\": \"3457595a-cfcf-4395-a3f7-c47680b2ba6a\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Some folder\",\n \"description\": \"A folder for many folders.\",\n \"children_count\": 5,\n \"num_of_spots\": 17\n }\n ]\n}"}],"_postman_id":"f5b01f78-5391-415b-a0a8-95bb6888735f"},{"name":"/v3/collections/search","id":"6e5b7c1a-d529-4888-9d09-66ef14cbe639","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/collections/search?search=Folder&limit=10","description":"

This endpoint is used to retrieve a list of folders based on a used search term.

\n

Exact search can be done using a parameter, but when not wanting strict search results the parameter should not be used.

\n

Results

\n

A maximum of 100 results will be given, but limit can be changed to be less with parameters.

\n

Request Body

\n

This request does not require a request body.

\n

Response Body

\n

The request returns an array of results.

\n","urlObject":{"path":["api","v3","collections","search"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

Search term to use for finding a folder

\n","type":"text/plain"},"key":"search","value":"Folder"},{"description":{"content":"

A limit of search results between 1-100

\n","type":"text/plain"},"key":"limit","value":"10"},{"disabled":true,"description":{"content":"

Include only when you want to match the search term exactly

\n","type":"text/plain"},"key":"exact","value":"true"}],"variable":[]}},"response":[{"id":"4e206e1f-cba1-4c95-b12a-a378f1220bd9","name":"/v3/collections/search","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/search?search=Folder&limit=10","host":["api","spotilla","fi"],"path":["api","v3","collections","search"],"query":[{"key":"search","value":"Folder","description":"Search term to use for finding a folder"},{"key":"limit","value":"10","description":"A limit of search results between 1-100"},{"key":"exact","value":"true","description":"Include only when you want to match the search term exactly","type":"text","disabled":true}]}},"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Some Folder In Tree\",\n \"description\": \"A folder inside a tree\",\n \"leaf\": false,\n \"children_count\": 5,\n \"num_of_spots\": 17,\n \"depth\": 1,\n \"collection_extra_fields\": [],\n \"locked_attributes\": [],\n \"upload_items\": [],\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"cost_permissions\": {\n \"read\": false,\n \"create\": false\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"spot_ids\": [],\n \"children_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Some Folder In Tree Copy\",\n \"description\": \"Copy of a folder\",\n \"leaf\": false,\n \"children_count\": 2,\n \"num_of_spots\": 0,\n \"depth\": 3,\n \"collection_extra_fields\": [],\n \"locked_attributes\": [],\n \"upload_items\": [],\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"cost_permissions\": {\n \"read\": false,\n \"create\": false\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"spot_ids\": [],\n \"children_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ]\n }\n]"}],"_postman_id":"6e5b7c1a-d529-4888-9d09-66ef14cbe639"},{"name":"/v3/collections/:id/lite","id":"59dee77d-975a-4c0a-9044-728571860716","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/collections/:collection_id/lite","description":"

This endpoint is used to retrieve folder details.

\n

Request Body

\n

This request does not require a request body.

\n","urlObject":{"path":["api","v3","collections",":collection_id","lite"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

A valid UUID of a collection

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"collection_id"}]}},"response":[{"id":"1dc24192-14b2-4b55-b125-91fe1f5b6053","name":"/v3/collections/:id/lite","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/:collection_id/lite","host":["api","spotilla","fi"],"path":["api","v3","collections",":collection_id","lite"],"variable":[{"key":"collection_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"A valid UUID of a collection"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Some Folder\",\n \"description\": \"A folder containing folders.\",\n \"leaf\": false,\n \"children_count\": 5,\n \"num_of_spots\": 17,\n \"collection_extra_fields\": [],\n \"locked_attributes\": [],\n \"upload_items\": [],\n \"spot_ids\": [],\n \"children_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"collection_permissions\": [\n \"read\",\n \"update\"\n ],\n \"message_permissions\": [\n \"read\",\n \"create\"\n ],\n \"cost_permissions\": [],\n \"attachment_permissions\": [\n \"read\",\n \"create\"\n ]\n}"}],"_postman_id":"59dee77d-975a-4c0a-9044-728571860716"},{"name":"/v3/collections/:id/single_collection","id":"90a3ac7a-ecd0-4dd5-806a-34fea5039eb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/collections/:id/single_collection","description":"

This endpoint is the same as the old endpoint: /api/v1/collections/:id

\n

This endpoint is used to return details about a single collection, including its parent folder ID, spot IDs, subfolder IDs, and other related information.

\n","urlObject":{"path":["api","v3","collections",":id","single_collection"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

collection UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"dd58d2ec-2d62-4266-8932-f0e44b0d22ef","name":"/v3/collections/:id/single_collection","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/:id/single_collection","host":["api","spotilla","fi"],"path":["api","v3","collections",":id","single_collection"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"collection UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Small Tools and Equipment\",\n \"description\": \"\",\n \"spot_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"children_ids\": [],\n \"num_of_spots\": 2,\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"depth\": 3,\n \"collection_extra_fields\": [],\n \"upload_items\": [],\n \"locked_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Device Class\",\n \"input_type\": \"select\",\n \"created_at\": \"2021-02-06T11:05:25.735+02:00\",\n \"updated_at\": \"2021-02-06T11:05:25.735+02:00\",\n \"type_dependent_data\": \"Class 1,\\nClass 2,\\nClass 3,\\nClass 4,\\nClass 5,\\nClass 6\",\n \"is_default_attribute\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Item Health Grading\",\n \"input_type\": \"text\",\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"type_dependent_data\": \"\",\n \"is_default_attribute\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Purchase date\",\n \"input_type\": \"text\",\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"type_dependent_data\": \"\",\n \"is_default_attribute\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Purchase price\",\n \"input_type\": \"text\",\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"type_dependent_data\": \"\",\n \"is_default_attribute\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Voltage (V)\",\n \"input_type\": \"text\",\n \"created_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"updated_at\": \"2020-10-30T13:23:44.952+02:00\",\n \"type_dependent_data\": \"\",\n \"is_default_attribute\": false\n }\n ]\n}"}],"_postman_id":"90a3ac7a-ecd0-4dd5-806a-34fea5039eb2"},{"name":"/v3/collections/:id","id":"8881ea25-39be-4657-98d8-b5799bb7e4f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/collections/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

Get details about a single collection, including its parent folder ID, spot IDs, subfolder IDs, and other related information.

\n","urlObject":{"path":["api","v3","collections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[{"id":"771a908c-4020-4ec4-b7d6-c1291b110f0e","name":"/v3/collections/:id","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/collections/:id","host":["api","spotilla","fi"],"path":["api","v3","collections",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hakunila\",\r\n \"description\": \"Kaikki alueen paikat\",\r\n \"spot_ids\": [\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n ],\r\n \"children_ids\": [],\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"device_card_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"log_machine_hours\": true,\r\n \"service_request_category_id\": null,\r\n \"message_type_id\": null,\r\n \"device_card_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Akku mV\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2022-01-08T15:17:56.640+02:00\",\r\n \"updated_at\": \"2022-01-08T20:48:35.230+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"CO2 ppm\",\r\n \"input_type\": \"number\",\r\n \"created_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"updated_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n }\r\n ],\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", \r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n}"}],"_postman_id":"8881ea25-39be-4657-98d8-b5799bb7e4f1"},{"name":"/v3/collections/:id/files","id":"a46409ea-5d3d-47bf-a5e3-3a039e02d987","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/collections/:id/files","urlObject":{"path":["api","v3","collections",":id","files"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

collection UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"1542a4c0-e2d1-4dc2-a12a-926409c3c07b","name":"/v3/collections/:id/files","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/:id/files","host":["api","spotilla","fi"],"path":["api","v3","collections",":id","files"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"collection UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2024-06-25T06:10:45.469Z\",\n \"header\": \"application_thumb.png\",\n \"uploaded_by\": \"{{rand_name}}\",\n \"thumbnail_url\": \"http://api.mahtavadeveloper.com/assets/application_thumb.png\",\n \"url\": \"http://api.mahtavadeveloper.com/api/v3/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_type\": \"Collection\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n]"}],"_postman_id":"a46409ea-5d3d-47bf-a5e3-3a039e02d987"},{"name":"/v3/collections","id":"30e63442-d94a-4298-ad9b-7a292f6ce54f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"collection\": {\r\n \"name\": \"Uusi kansio\", // required\r\n \"description\": \"\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // parent folder id\r\n \"message_type_id\": \"\",\r\n \"device_card_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_category_id\": null,\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"log_machine_hours\": true,\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", // consumer or company\r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/collections","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

Required fields:

\n\n

Others fields are optional

\n

Note: if the parent_id field is left as empty, then the new folder will become a root folder

\n

Options for delivery_customer_type: consumer or company

\n\n","urlObject":{"path":["api","v3","collections"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"4119b8ae-e0d6-4a7e-86c0-d2de76e196c6","name":"/v3/collections","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"collection\": {\r\n \"name\": \"Uusi kansio\",\r\n \"description\": \"\",\r\n \"parent_id\": \"53430f2-4416-47c8-a432-894469663c0a\", // parent folder id\r\n \"message_type_id\": \"\",\r\n \"device_card_id\": \"f2222-73df-4a2f-98c4-7f874c2642\",\r\n \"service_request_category_id\": null,\r\n \"customer_id\": \"c0434dc-41d1-973d-1424334aa4\",\r\n \"log_machine_hours\": true,\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", \r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/collections"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Uusi kansio\",\r\n \"description\": \"\",\r\n \"spot_ids\": [],\r\n \"children_ids\": [],\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"device_card_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"log_machine_hours\": true,\r\n \"service_request_category_id\": null,\r\n \"message_type_id\": null,\r\n \"device_card_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Akku mV\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2022-01-08T15:17:56.640+02:00\",\r\n \"updated_at\": \"2022-01-08T20:48:35.230+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"CO2 ppm\",\r\n \"input_type\": \"number\",\r\n \"created_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"updated_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n }\r\n ],\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", \r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n}"}],"_postman_id":"30e63442-d94a-4298-ad9b-7a292f6ce54f"},{"name":"/v3/collections/:id","id":"3ef66a04-3234-468d-8a30-90e27ce7f7a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

integration user id

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"collection\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Vantaan toimipaikat\",\r\n \"description\": \"Koko Vantaa\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"device_card_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"log_machine_hours\": true,\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\", \r\n \"delivery_customer_type\": \"consumer\", // consumer or company\r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/collections/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

When PATCHing, you can leave out unchanged fields.

\n

Options for delivery_customer_type: consumer or company.

\n\n","urlObject":{"path":["api","v3","collections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

collection UUID

\n","type":"text/plain"},"type":"any","value":"659c3541-293d-4d51-acac-e538d1267db3","key":"id"}]}},"response":[{"id":"06041264-444c-49ed-92a9-4b6479a26679","name":"/v3/collections/:id","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"collection\": {\r\n \"id\": \"659c3541-293d-4d51-acac-e538d1267db3\",\r\n \"name\": \"Vantaan toimipaikat\",\r\n \"description\": \"Koko Vantaa\",\r\n \"parent_id\": \"23332-4416-47c8-a432-8944433c0a\",\r\n \"message_type_id\": \"32232-4416-47c8-a432-8943330a\",\r\n \"device_card_id\": \"ffe80d47-73df-4a2f-98c4-7f8783c26ce8\",\r\n \"service_request_category_id\": \"11132-4416-47c8-a432-894411a\",\r\n \"customer_id\": \"c0478344-ecdc-41d1-973d-181118165aa4\",\r\n \"log_machine_hours\": true,\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", \r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/collections/:id","host":["api","spotilla","fi"],"path":["api","v3","collections",":id"],"variable":[{"key":"id","value":""}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Vantaan toimipaikat\",\r\n \"description\": \"Koko Vantaa\",\r\n \"spot_ids\": [\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n ],\r\n \"children_ids\": [],\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"device_card_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"log_machine_hours\": true,\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"device_card_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Akku mV\",\r\n \"input_type\": \"text\",\r\n \"created_at\": \"2022-01-08T15:17:56.640+02:00\",\r\n \"updated_at\": \"2022-01-08T20:48:35.230+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"CO2 ppm\",\r\n \"input_type\": \"number\",\r\n \"created_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"updated_at\": \"2022-01-08T20:47:55.387+02:00\",\r\n \"type_dependent_data\": null,\r\n \"is_default_attribute\": false\r\n }\r\n ],\r\n \"is_delivery_customer\": true, \r\n \"delivery_customer_number\": \"424242\", \r\n \"delivery_company_id\": \"842942\",\r\n \"delivery_vat\": \"49493\",\r\n \"delivery_customer_type\": \"consumer\", \r\n \"delivery_phone\": \"09 838292\",\r\n \"delivery_mobile\": \"050 32545223\",\r\n \"delivery_email\": \"info@example.fi\", \r\n \"delivery_address\": \"Mallikastie 43 B\", \r\n \"delivery_postcode\": \"349322\", \r\n \"delivery_city\": \"Oulu\",\r\n \"delivery_country\": \"FI\", \r\n \"delivery_inv_address\": \"Laskutie 43\", \r\n \"delivery_inv_postcode\": \"94389\",\r\n \"delivery_inv_city\": \"Oulu\", \r\n \"delivery_inv_country\": \"FI\", \r\n \"delivery_invoicing_email\": \"laskut@example.fi\",\r\n \"delivery_e_invoice_address\": \"232244254\", \r\n \"delivery_operator\": \"OKOYFIHH\"\r\n}"}],"_postman_id":"3ef66a04-3234-468d-8a30-90e27ce7f7a8"}],"id":"ab2e084a-6ef6-4b63-869b-0c1472b75d22","_postman_id":"ab2e084a-6ef6-4b63-869b-0c1472b75d22","description":""},{"name":"Spots","item":[{"name":"Spot Contacts","item":[{"name":"/v3/spot_contacts?spot_id=:spot_id","id":"82b3fa78-30f9-45da-9d1c-b2ffa0fe2c5f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_contacts?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[page]=1&search_term=example","description":"

GET /api/v3/spot_contacts

\n

This endpoint is used to retrieve contacts for a specific spot.

\n

Request

\n\n

Response

\n

The response for this request is a JSON object with the following schema:

\n
{\n  \"type\": \"object\",\n  \"properties\": {\n    \"error\": {\n      \"type\": \"string\"\n    }\n  }\n}\n\n
\n

The last execution of this request returned a status code of 401 and a JSON response with an \"error\" property.

\n","urlObject":{"path":["api","v3","spot_contacts"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"key":"q[page]","value":"1"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"search_term","value":"example"}],"variable":[]}},"response":[{"id":"8162906d-aa81-4dc1-adf7-4b721227fb02","name":"/v3/spot_contacts?spot_id=:spot_id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/spot_contacts?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[page]&search_term","host":["api","dev","spotilla","fi"],"path":["api","v3","spot_contacts"],"query":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"},{"key":"q[page]","value":null,"type":"text"},{"key":"search_term","value":null,"description":"optional params","type":"text"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"first_name\": \"Heikki\",\n \"last_name\": \"Happonen\",\n \"company\": \"\",\n \"title\": \"\",\n \"email\": \"heikki@hap.fi\",\n \"phone_num\": \"03994949444\",\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Chicago import 2\",\n \"created_at\": \"2021-05-11T16:46:28.977+03:00\",\n \"updated_at\": \"2021-08-02T12:45:17.102+03:00\"\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"first_name\": \"Marja\",\n \"last_name\": \"Kortelainen\",\n \"company\": \"Firma OY\",\n \"title\": \"Account Manager\",\n \"email\": \"marja@firma.fi\",\n \"phone_num\": \"0200002324\",\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n }\n ]\n }\n]"}],"_postman_id":"82b3fa78-30f9-45da-9d1c-b2ffa0fe2c5f"},{"name":"/v3/spot_contacts (duplicate)","id":"fc56a80c-5ea9-440e-a98c-437b5dc94f67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_contacts?q[page]=1","description":"

Get all contacts.

\n

You can combine the search parameter also:

\n

api.spotilla.fi/api/v3/spot_contacts?q[page]=1&search_term=marja

\n","urlObject":{"path":["api","v3","spot_contacts"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"17613beb-4ec7-47f1-91b7-232a2761c393","name":"/v3/spot_contacts?spot_id=:spot_id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/spot_contacts?q[page]=1","host":["api","dev","spotilla","fi"],"path":["api","v3","spot_contacts"],"query":[{"key":"q[page]","value":"1"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ab497151-361c-47f2-b371-c8b30b6ce6f7\",\n \"first_name\": \"Heikki\",\n \"last_name\": \"Happonen\",\n \"company\": \"\",\n \"title\": \"\",\n \"email\": \"heikki@hap.fi\",\n \"phone_num\": \"03994949444\",\n \"spots\": [\n {\n \"id\": \"d9ce4634-ad55-4eb4-b9c1-0c54be885eb6\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n },\n {\n \"id\": \"557ea417-23e2-4105-aa8d-8303c329f37e\",\n \"name\": \"Chicago import 2\",\n \"created_at\": \"2021-05-11T16:46:28.977+03:00\",\n \"updated_at\": \"2021-08-02T12:45:17.102+03:00\"\n }\n ]\n },\n {\n \"id\": \"bcf556de-c57a-4a6f-8dc1-cbba94e0f390\",\n \"first_name\": \"Marja\",\n \"last_name\": \"Kortelainen\",\n \"company\": \"Firma OY\",\n \"title\": \"Account Manager\",\n \"email\": \"marja@firma.fi\",\n \"phone_num\": \"0200002324\",\n \"spots\": [\n {\n \"id\": \"d9ce4634-ad55-4eb4-b9c1-0c54be885eb6\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n }\n ]\n }\n]"}],"_postman_id":"fc56a80c-5ea9-440e-a98c-437b5dc94f67"},{"name":"/v3/spot_contacts?spot_id=:spot_id&search_term=:search_term (duplicate)","id":"efffd798-7908-43b7-9b0d-99442cd388bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"W8FEs--Jzo4AcqXiv86Y","type":"text"},{"key":"X-User-Id","value":"8627f602-65be-4d67-8831-d617c4c3237b","type":"text"},{"key":"X-User-Subdomain","value":"kpdemo","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_contacts?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&search_term=miller","description":"

Get contacts for a spot where some field matches (fully or partially) a field in contact.

\n","urlObject":{"path":["api","v3","spot_contacts"],"host":["api","spotilla","fi"],"query":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"key":"search_term","value":"miller"}],"variable":[]}},"response":[{"id":"d9b63ed1-720c-4ad4-939f-18cc703135b5","name":"/v3/spot_contacts?spot_id=:spot_id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"W8FEs--Jzo4AcqXiv86Y","type":"text"},{"key":"X-User-Id","value":"8627f602-65be-4d67-8831-d617c4c3237b","type":"text"},{"key":"X-User-Subdomain","value":"kpdemo","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"url":{"raw":"api.dev.spotilla.fi/api/v3/spot_contacts?spot_id=d9ce4634-ad55-4eb4-b9c1-0c54be885eb6&search_term=marja","host":["api","dev","spotilla","fi"],"path":["api","v3","spot_contacts"],"query":[{"key":"spot_id","value":"d9ce4634-ad55-4eb4-b9c1-0c54be885eb6"},{"key":"search_term","value":"marja"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"bcf556de-c57a-4a6f-8dc1-cbba94e0f390\",\r\n \"first_name\": \"Marja\",\r\n \"last_name\": \"Kortelainen\",\r\n \"company\": \"Firma OY\",\r\n \"title\": \"Account Manager\",\r\n \"email\": \"marja@firma.fi\",\r\n \"phone_num\": \"0200002324\",\r\n \"spots\": [\r\n {\r\n \"id\": \"d9ce4634-ad55-4eb4-b9c1-0c54be885eb6\",\r\n \"name\": \"Compressiom machine 3\",\r\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\r\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\r\n }\r\n ]\r\n }\r\n]"}],"_postman_id":"efffd798-7908-43b7-9b0d-99442cd388bc"},{"name":"/v3/spot_contacts/:id","id":"d75eee42-8f0a-4e11-921d-fd617cb6d1a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_contacts/:id","description":"

This endpoint retrieves a specific contact.

\n

Request

\n

No request body is required for this endpoint.

\n","urlObject":{"path":["api","v3","spot_contacts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot contact UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"8172b13b-f77a-45be-88b0-2541876c3682","name":"/v3/spot_contacts/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/spot_contacts/:id","host":["api","dev","spotilla","fi"],"path":["api","v3","spot_contacts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot contact UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"first_name\": \"Marjatta\",\n \"last_name\": \"Mallikas\",\n \"company\": \"Company OY\",\n \"title\": \"Account Manager\",\n \"email\": \"marjatta@company.fi\",\n \"phone_num\": \"0200002324\",\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n }\n ]\n}"}],"_postman_id":"d75eee42-8f0a-4e11-921d-fd617cb6d1a5"},{"name":"/v3/spot_contacts","id":"8ad1f936-7850-4aba-9773-e5449d55a37b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot_contact\": {\r\n \"first_name\": \"Mikko\",\r\n \"last_name\": \"Virtanen\",\r\n \"email\": \"mikko@mallikkaat.fi\",\r\n \"phone_num\": \"0444206969\",\r\n \"title\": \"Huoltomies\", // optional params\r\n \"company\": \"Mallikkaat Oy\", // optional params\r\n \"spot_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // pass spot uuid here\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spot_contacts","description":"

Create a contact for spot/spots.

\n

Required params:

\n\n","urlObject":{"path":["api","v3","spot_contacts"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"169d993a-25b0-4ce0-b594-f58d5d8f9dc9","name":"/v3/spot_contacts","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot_contact\": {\r\n \"first_name\": \"Mobiili\",\r\n \"last_name\": \"Tyyppi\",\r\n \"email\": \"tyyppi@mobiili.fi\",\r\n \"phone_num\": \"0444206969\",\r\n \"title\": \"Duunari\",\r\n \"company\": \"Hemmo Oy\",\r\n \"spot_ids\": [\"d9ce4634-ad55-4eb4-b9c1-0c54be885eb6\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.dev.spotilla.fi/api/v3/spot_contacts"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"first_name\": \"Mikko\",\n \"last_name\": \"Virtanen\",\n \"company\": \"Mallikkaat Oy\",\n \"title\": \"Huoltomies\",\n \"email\": \"mikko@mallikkaat.fi\",\n \"phone_num\": \"0444206969\",\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Compressiom machine 3\",\n \"created_at\": \"2020-10-30T13:32:06.213+02:00\",\n \"updated_at\": \"2021-08-02T09:29:22.615+03:00\"\n }\n ]\n}"}],"_postman_id":"8ad1f936-7850-4aba-9773-e5449d55a37b"},{"name":"/v3/spot_contacts/:id","id":"9a158572-ed74-4a2a-98b7-c645c6bd509a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot_contact\": {\r\n \"first_name\": \"Spider\",\r\n \"last_name\": \"Man\",\r\n \"email\": \"spider.man@marvel.com\",\r\n \"phone_num\": \"0444206969\",\r\n \"title\": \"Huoltomies\",\r\n \"company\": \"Marvel Studio\",\r\n \"spot_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // pass spot uuid here\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spot_contacts/:id","description":"

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n

Update a contact with any of the following params:

\n
{\n  \"spot_contact\": {\n    \"first_name\": \"Spider\",\n    \"last_name\": \"Man\",\n    \"email\": \"spider.man@marvel.com\",\n    \"phone_num\": \"0444206969\",\n    \"title\": \"Huoltomies\",\n    \"company\": \"Marvel Studio\",\n    \"spot_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // pass spot uuid here\n  }\n}\n\n
\n","urlObject":{"path":["api","v3","spot_contacts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot contact UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"c11f074d-3589-46b5-bb21-975a305bc873","name":"/v3/spot_contacts/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot_contact\": {\r\n \"first_name\": \"Spider\",\r\n \"last_name\": \"Man\",\r\n \"email\": \"spider.man@marvel.com\",\r\n \"phone_num\": \"0444206969\",\r\n \"title\": \"Huoltomies\",\r\n \"company\": \"Marvel Studio\",\r\n \"spot_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // pass spot uuid here\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.dev.spotilla.fi/api/v3/spot_contacts/:id","host":["api","dev","spotilla","fi"],"path":["api","v3","spot_contacts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot contact UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"first_name\": \"Spider\",\n \"last_name\": \"Man\",\n \"company\": \"Marvel Studio\",\n \"title\": \"Huoltomies\",\n \"email\": \"spider.man@marvel.com\",\n \"phone_num\": \"0444206969\",\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hydraulic Press 202\",\n \"created_at\": \"2023-04-04T13:45:11.801Z\",\n \"updated_at\": \"2023-04-04T13:46:18.916Z\"\n }\n ]\n}"}],"_postman_id":"9a158572-ed74-4a2a-98b7-c645c6bd509a"}],"id":"8b0d56b4-9fa1-487d-859e-f57671a76fb5","_postman_id":"8b0d56b4-9fa1-487d-859e-f57671a76fb5","description":""},{"name":"/v3/spots","id":"72d032c7-c710-400d-b826-a2dd93be19e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/spots/?q[search]=&q[status]=[\"active\", \"inactive\", \"faulty\"]&q[page]=1","description":"

Get Spots List

\n

This endpoint retrieves a paginated list of all spots based on the provided search and status criteria.

\n

Request

\n\n

Query params:

\n\n

Response

\n

The response will include an array of objects, where each object contains the following keys:

\n\n","urlObject":{"path":["api","v3","spots",""],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[search]","value":""},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[status]","value":"[\"active\", \"inactive\", \"faulty\"]"},{"description":{"content":"

page number

\n","type":"text/plain"},"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"78b9ca02-7ebd-4a18-b498-b222c228d879","name":"/v3/spots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/spots/?q[search]=Abloy&q[status]=\"active\"&q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","spots",""],"query":[{"key":"q[search]","value":"Abloy"},{"key":"q[status]","value":"\"active\""},{"key":"q[page]","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"","value":"","description":"","type":"text"},{"key":"","value":"","description":"","type":"text"},{"key":"","value":"","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\r\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\r\n \"surface_number\": null,\r\n \"status\": \"active\",\r\n \"read_events\": [],\r\n \"location\": {\r\n \"type\": \"fixed\",\r\n \"latitude\": \"60.21185111764446\",\r\n \"longitude\": \"24.66636657714844\"\r\n },\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"log_machine_hours\": false,\r\n \"running_machine_hours\": null,\r\n \"active_notifications\": 2\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA Ohjauspääte\",\r\n \"description\": \"SAFEA ohjauspääte\",\r\n \"surface_number\": null,\r\n \"status\": \"active\",\r\n \"read_events\": [],\r\n \"location\": null,\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"log_machine_hours\": true,\r\n \"running_machine_hours\": null,\r\n \"active_notifications\": 0\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA Turvaverkkopääte\",\r\n \"description\": \"SAFEA kulunvalvonnan tiedonsiirtolaitedsads\",\r\n \"surface_number\": null,\r\n \"status\": \"active\",\r\n \"read_events\": [],\r\n \"location\": null,\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"log_machine_hours\": true,\r\n \"running_machine_hours\": 124.5,\r\n \"active_notifications\": 0\r\n }\r\n]"}],"_postman_id":"72d032c7-c710-400d-b826-a2dd93be19e3"},{"name":"/v3/search_matching_spots","id":"bf746712-e9f2-49c0-84ab-289d257897aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/search_matching_spots?q[spot]=exampleSpotName&q[folder]=exampleFolderName&q[attribute]=exampleAttributeValue","description":"

Get Paginated List of Matching Spots

\n

This endpoint returns spots that matching spots name, folder name, or spot attributes.

\n

Query params:

\n\n","urlObject":{"path":["api","v3","search_matching_spots"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

filter by spot name

\n","type":"text/plain"},"key":"q[spot]","value":"exampleSpotName"},{"description":{"content":"

filter by folder name

\n","type":"text/plain"},"key":"q[folder]","value":"exampleFolderName"},{"description":{"content":"

filter by spot attribute

\n","type":"text/plain"},"key":"q[attribute]","value":"exampleAttributeValue"}],"variable":[]}},"response":[{"id":"26e5d7dd-2081-40d5-9e4e-b62c96cd1dc3","name":"/v3/search_matching_spots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/search_matching_spots?q[spot]=Abloy&q[folder]=exampleFolder&q[attribute]=exampleAttribute","host":["api","spotilla","fi"],"path":["api","v3","search_matching_spots"],"query":[{"key":"q[spot]","value":"Abloy","description":"filter by spot name"},{"key":"q[folder]","value":"exampleFolder","description":"filter by folder name"},{"key":"q[attribute]","value":"exampleAttribute","description":"filter by spot attribute"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\n \"surface_number\": null,\n \"status\": \"active\",\n \"read_events\": [],\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"spot_image\": {\n \"thumbnail_url\": \"\",\n \"url\": \"\"\n },\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Phone_Production_Line\",\n \"description\": \"\",\n \"created_at\": \"2023-08-25T13:50:37.536Z\",\n \"updated_at\": \"2023-08-25T14:53:12.092Z\"\n },\n \"collection_path\": \"Phone_Production_Line → Location_Plant_1 → Location_Factory_A → Phone Producer Oy\",\n \"spot_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asennuspäivä\",\n \"value\": \"\",\n \"input_type\": \"date\",\n \"definition\": \"\",\n \"value_selections\": [\n \"esimerkki 1\",\n \"esimerkki 2\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asentaja\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asentanut yritys\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Huoltoyhteyshenkilö\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n }\n\n ]\n }\n]"}],"_postman_id":"bf746712-e9f2-49c0-84ab-289d257897aa"},{"name":"/v3/spots/:id","id":"9b034c59-9caa-4180-8aba-0c8cc4b2d262","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/spots/:id","description":"

Get details about a single Spot.\nYou will get spot details, it's device card (attributes) field details, location detail.

\n","urlObject":{"path":["api","v3","spots",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"62debf4c-eef4-4f65-b6cf-eda2021f1351","name":"/v3/spots/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:id","host":["api","spotilla","fi"],"path":["api","v3","spots",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"status\": \"active\",\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parents\": [\n \"Testikansio 620\"\n ],\n \"parent_hierarchies\": [\n \"Testikansio 620 → Laitteet\"\n ],\n \"spot_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asennuspäivä\",\n \"value\": \"\",\n \"input_type\": \"date\",\n \"definition\": \"\",\n \"value_selections\": [\n \"esimerkki 1\",\n \"esimerkki 2\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asentaja\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Asentanut yritys\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Huoltoyhteyshenkilö\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Huoltoyhteyshenkilön numero\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Huoltoyhteyshenkilön sähköp.\",\n \"value\": \"\",\n \"input_type\": \"email\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Sijaintikerros\",\n \"value\": \"\",\n \"input_type\": \"number\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Huoltoyritys\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Laitetyyppi\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"surface_number\": null,\n \"read_events\": [],\n \"reservations\": [],\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"spot_image\": {\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/b019aa57-dd86-4592-9ec9-77383ec5fec6\",\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/b019aa57-dd86-4592-9ec9-77383ec5fec6\"\n },\n \"spare_parts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 20\",\n \"code\": \"A20\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"amount\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"amount\": 20\n }\n ]\n },\n \"created_at\": \"2021-06-17T16:56:02.397+03:00\",\n \"updated_at\": \"2021-06-17T16:56:02.397+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 101\",\n \"code\": \"A10\",\n \"manufacturer\": \"\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": []\n },\n \"created_at\": \"2021-06-17T16:56:02.398+03:00\",\n \"updated_at\": \"2021-06-17T16:56:02.398+03:00\"\n }\n ],\n \"log_machine_hours\": true,\n \"running_machine_hours\": 123,\n \"active_notifications\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"notification_heading\": \"Suodatin vaihdettava ensi kerralla\",\n \"notification_description\": \"Suodattimet olivat loppuneet tukusta. Nyt vain pesty, mutta vaihdetaan ensi kerralla\",\n \"due_date\": \"2023-04-17T00:00:00.000+03:00\",\n \"start_date\": \"2023-04-17T00:00:00.000+03:00\",\n \"stop_date\": \"2023-06-06T00:00:00.000+03:00\"\n }\n ]\n}"}],"_postman_id":"9b034c59-9caa-4180-8aba-0c8cc4b2d262"},{"name":"/v3/collections/:id/spots","id":"ff0735c9-4ca8-40f9-86aa-538f3a605a3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/collections/:collection_id/spots","description":"

Get a list of all spots within a specified folder that the user has permission to access.

\n","urlObject":{"path":["api","v3","collections",":collection_id","spots"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

collection UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"collection_id"}]}},"response":[{"id":"db50ed2e-4ecd-4f4c-895f-818f6623943c","name":"/v3/collection/:id/spots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/collections/:id/spots","host":["api","spotilla","fi"],"path":["api","v3","collections",":id","spots"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"collection UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Aatrox\",\r\n \"description\": \"\",\r\n \"surface_number\": null,\r\n \"read_events\": [],\r\n \"location\": null,\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"collection\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"created_at\": \"2020-10-30T11:05:20.156Z\",\r\n \"updated_at\": \"2023-09-07T07:50:39.680Z\"\r\n },\r\n \"collection_path\": \"Small Tools and Equipment → Phone_Production_Site → Factory B → Phone Producer Oy.\",\r\n \"log_machine_hours\": true,\r\n \"running_machine_hours\": 123\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\r\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\r\n \"surface_number\": null,\r\n \"read_events\": [],\r\n \"location\": {\r\n \"type\": \"fixed\",\r\n \"latitude\": \"60.21185111764446\",\r\n \"longitude\": \"24.66636657714844\"\r\n },\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"collection\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"created_at\": \"2020-10-30T11:05:20.156Z\",\r\n \"updated_at\": \"2023-09-07T07:50:39.680Z\"\r\n },\r\n \"collection_path\": \"Small Tools and Equipment → Phone_Production_Site → Factory B → Phone Producer Oy.\",\r\n \"log_machine_hours\": false,\r\n \"running_machine_hours\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA Ohjauspääte\",\r\n \"description\": \"SAFEA ohjauspääte\",\r\n \"surface_number\": null,\r\n \"read_events\": [],\r\n \"location\": null,\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"collection\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"created_at\": \"2020-10-30T11:05:20.156Z\",\r\n \"updated_at\": \"2023-09-07T07:50:39.680Z\"\r\n },\r\n \"collection_path\": \"Small Tools and Equipment → Phone_Production_Site → Factory B → Phone Producer Oy.\",\r\n \"log_machine_hours\": true,\r\n \"running_machine_hours\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Abloy SAFEA Turvaverkkopääte\",\r\n \"description\": \"SAFEA kulunvalvonnan tiedonsiirtolaitedsads\",\r\n \"surface_number\": null,\r\n \"read_events\": [],\r\n \"location\": null,\r\n \"spot_image\": {\r\n \"thumbnail_url\": \"\",\r\n \"url\": \"\"\r\n },\r\n \"collection\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Small Tools and Equipment\",\r\n \"description\": \"\",\r\n \"created_at\": \"2020-10-30T11:05:20.156Z\",\r\n \"updated_at\": \"2023-09-07T07:50:39.680Z\"\r\n },\r\n \"collection_path\": \"Small Tools and Equipment → Phone_Production_Site → Factory B → Phone Producer Oy.\",\r\n \"log_machine_hours\": true,\r\n \"running_machine_hours\": 14.6\r\n }\r\n]"}],"_postman_id":"ff0735c9-4ca8-40f9-86aa-538f3a605a3c"},{"name":"/v3/spots","id":"680455e0-829c-42d1-bb25-328837b4cfb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Spot ABC\", // required\r\n \"status\": \"active\", // optional\r\n \"description\": \"Describe the Spot.\", // optional\r\n \"tag_id\": \"239230-4923g-492j49e-39djur874hf\", // optional\r\n \"collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required collection UUID\r\n \"spot_attributes_attributes\": [ // optional\r\n {\r\n \"attribute_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // attribute UUID\r\n \"value\": \"3\",\r\n \"definition\": \"Number of faults\"\r\n },\r\n {\r\n \"attribute_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Good\",\r\n \"definition\": \"Condition\"\r\n }\r\n ],\r\n \"spare_parts_attributes\": [ // optional \r\n {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // product UUID\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots","description":"

create spot under a folder.

\n

required params:

\n\n

optional params:

\n\n","urlObject":{"path":["api","v3","spots"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"bf1f8aa0-5d45-40d3-8002-b9f082f57712","name":"/v3/spots","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Spot ABC\", \r\n \"status\": \"active\", \r\n \"description\": \"Describe the Spot.\", \r\n \"tag_id\": \"239230-4923g-492j49e-39djur874hf\", \r\n \"collection_id\": \"1806b784-c758-4ed2-adef-0a2db512b1234\", \r\n \"spot_attributes_attributes\": [ \r\n {\r\n \"attribute_key_id\": \"99667aa0-79f2-4887-bbee-b65b8b139865\",\r\n \"value\": \"MX263542\",\r\n \"definition\": \"\"\r\n }\r\n ],\r\n \"spare_parts_attributes\": [ \r\n {\r\n \"product_id\": \"o08rnfkvk9-dk39-dkdo-ck93-dkwoeifbds\"\r\n }\r\n ]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"status\": \"faulty\",\n \"name\": \"Shining Spot\",\n \"description\": \"This is a shining spot\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parents\": [\n \"Air Conditioning Systems\"\n ],\n \"parent_hierarchies\": [\n \"Air Conditioning Systems → Warehouse Building → Production Site Helsinki → Our Company Ltd\"\n ],\n \"spot_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Serial Number\",\n \"value\": \"MX263542\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"surface_number\": null,\n \"read_events\": [],\n \"reservations\": [],\n \"location\": null,\n \"spot_image\": {\n \"thumbnail_url\": \"\",\n \"url\": \"\"\n },\n \"log_machine_hours\": false,\n \"running_machine_hours\": 0.0,\n \"spare_parts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Motor air filter 66252\",\n \"code\": \"66252\",\n \"manufacturer\": \"Mann\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Power Plant spareparts\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"amount\": 21.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"amount\": 10.0\n }\n ]\n },\n \"created_at\": \"2024-06-12T08:04:56.421Z\",\n \"updated_at\": \"2024-06-12T08:04:56.421Z\"\n }\n ],\n \"active_notifications\": 0\n}"}],"_postman_id":"680455e0-829c-42d1-bb25-328837b4cfb2"},{"name":"/v3/new_file_badges","id":"d2d2ac0c-21f6-4077-9ad6-678e7582aa59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"file_badge\": {\r\n \"name\": \"New Folder Name\", // required field\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // required spot UUID\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/new_file_badges","description":"

POST /api/v3/new_file_badges

\n

This endpoint is used to create a new file badge under a spot.

\n

Required Parameters

\n\n","urlObject":{"path":["api","v3","new_file_badges"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"c195bed6-1106-483f-8c2e-4eb571e80826","name":"/v3/new_file_badges","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"file_badge\": {\r\n \"name\": \"New Folder Name\", // required field\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // required spot UUID\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/new_file_badges"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"New Folder Name\",\n \"color\": null,\n \"created_at\": \"2025-05-12T08:28:49.904+03:00\",\n \"updated_at\": \"2025-05-12T08:28:49.904+03:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // spot UUID\n}"}],"_postman_id":"d2d2ac0c-21f6-4077-9ad6-678e7582aa59"},{"name":"/v3/edit_file_badge/:id","id":"cbfa610f-8c0e-482c-b1d2-7b6f2b7bbcd0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

file badge UUID

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"file_badge\": {\r\n \"name\": \"Updated Folder Name\" // required field\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/edit_file_badge/:id","description":"

PATCH /api/v3/edit_file_badge/:id

\n

This endpoint is used to update an existing file badge with the specified UUID.

\n

Required Parameters

\n\n

Response

\n

The response for this request is a JSON object with the following schema:

\n\n","urlObject":{"path":["api","v3","edit_file_badge",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"4ee39937-6fdd-476b-885a-ae0c528a175d","name":"/v3/edit_file_badge/:id","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"},{"key":"Content-Type","value":"application/json","type":"text","disabled":true},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"file badge UUID","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"file_badge\": {\r\n \"name\": \"New Folder Name\" // required field\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/edit_file_badge/:id","host":["api","spotilla","fi"],"path":["api","v3","edit_file_badge",":id"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"{{uuid}}\", // uuid of the updated file badge\n \"name\": \"Updated Folder Name\",\n \"color\": null,\n \"created_at\": \"2025-05-12T08:33:21.967+03:00\",\n \"updated_at\": \"2025-05-12T08:35:13.143+03:00\",\n \"spot_id\": \"{{uuid}}\" // uuid of the spot that the file badge belongs to\n}"}],"_postman_id":"cbfa610f-8c0e-482c-b1d2-7b6f2b7bbcd0"},{"name":"/v3/spots/:id","id":"119a6427-799c-41e9-a58a-e39b1d9689a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","description":"

token received in login request

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

user id received in login request

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot\": {\r\n \"status\": \"active\",\r\n \"reason\": \"Reason for Spot Status Change\", // Optional field: Users can provide a reason for the spot status change.\r\n \"tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"running_machine_hours\": 54.5,\r\n \"latitude\": \"60.21185111764446\",\r\n \"longitude\": \"24.66636657714844\",\r\n \"spot_attributes_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // spot attribute UUID\r\n \"value\": \"Type 2\",\r\n \"definition\": \"Attribuutin kuvaus\"\r\n }\r\n ],\r\n \"tag_attributes\": [\r\n {\r\n \"surface_number\": \"A1234\"\r\n } \r\n ],\r\n \"spare_parts_attributes\": [\r\n { // example params when deleting a sparepart\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of SparePart, required when _destroy is set to true\r\n \"_destroy\": true // set to true will delete the current spare_part from \r\n },\r\n { // example params when adding a product as spare parts for the spot\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // required when adding new products as spare parts for the spot\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:id","description":"

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n

Note:

\n

in the nested objects of \"spare_parts_attributes\":

\n
    \n
  1. if the \"_destroy\" field is set as \"true\", then the \"id\" field is required (spare_part with the id will be destroyed)
    2. \n
  2. otherwise, only the \"product_id\" is required (a new spare_part will be added)
    3. \n
\n","urlObject":{"path":["api","v3","spots",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"ac1a3652-fb4c-4a39-9219-9448ac7696e8","name":"/v3/spots/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","description":"token received in login request","type":"text"},{"key":"X-User-Id","value":"","description":"user id received in login request","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same tenancy as is used in login request","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spot\": {\r\n \"status\": \"active\",\r\n \"reason\": \"Reason for Spot Status Change\", // Optional field: Users can provide a reason for the spot status change.\r\n \"tag_id\": \"180we784-c7er-4edwe-adefer-w2db5126ead\",\r\n \"running_machine_hours\": 54.5,\r\n \"latitude\": \"60.21185111764446\",\r\n \"longitude\": \"24.66636657714844\",\r\n \"spot_attributes_attributes\": [\r\n {\r\n \"id\": \"20b938a4-a0c9-4285-836c-44c647ff4540\",\r\n \"value\": \"Type 2\",\r\n \"definition\": \"Attribuutin kuvaus\"\r\n }\r\n ],\r\n \"tag_attributes\": [\r\n {\r\n \"surface_number\": \"A1234\"\r\n } \r\n ],\r\n \"spare_parts_attributes\": [\r\n {\r\n \"id\": \"20b9348a4-a649-4232-834c-44c644w34540\", // uuid for SparePart, required when _destroy is set to true\r\n \"product_id\": \"48065t84-c758-4ed2-adef-0a2db51264rd\", // optional when _destroy is set to true\r\n \"_destroy\": true // set to true will delete the current spare_part from \r\n },\r\n {\r\n \"product_id\": \"404f96a1-3840-4545-bdfr-5166cde4ge20\" // required when adding new products as spare parts for the spot\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/spots/:id","host":["api","spotilla","fi"],"path":["api","v3","spots",":id"],"variable":[{"key":"id","value":"","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"status\": \"active\",\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\n \"parents\": [\n \"Testikansio 620\"\n ],\n \"parent_hierarchies\": [\n \"Testikansio 620 → Laitteet\"\n ],\n \"spot_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Machine Type\",\n \"value\": \"Type 2\",\n \"input_type\": \"select\",\n \"definition\": \"Attribuutin kuvaus\",\n \"value_selections\": [\n \"Type 1\",\n \"Type 2\",\n \"Type 3\"\n ]\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"surface_number\": \"A1234\",\n \"read_events\": [],\n \"reservations\": [],\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"spot_image\": {\n \"thumbnail_url\": \"\",\n \"url\": \"\"\n },\n \"log_machine_hours\": true,\n \"running_machine_hours\": 54.5,\n \"spare_parts\": [],\n \"active_notifications\": 0\n}"}],"_postman_id":"119a6427-799c-41e9-a58a-e39b1d9689a8"},{"name":"/v3/spots/:id/move_spot","id":"eff34c94-7bf4-42e1-b1e2-36f9b0b6debe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"body":{"mode":"raw","raw":"{\r\n \"collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // Provide the UUID of the collection where you want to move the spot.\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:spot_id/move_spot","description":"

In request body have the collection_id you want to move the spot to.

\n
\n

Note that you should have edit perms to both source and target collections

\n
\n","urlObject":{"path":["api","v3","spots",":spot_id","move_spot"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"b7a0b9f6-1c41-4702-8559-0ecca68b5666","name":"/v3/spots/:id/move_spot","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"collection_id\": \"ba37725a-4efc-4986-8d4a-f23515fee2d9\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/spots/:id/move_spot","host":["api","spotilla","fi"],"path":["api","v3","spots",":id","move_spot"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"status\": \"active\",\n \"name\": \"Chicago import 2\",\n \"description\": \"Vauhdilla Chicagoon\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parents\": [\n \"Feeding System\"\n ],\n \"parent_hierarchies\": [\n \"Feeding System → Production Machines → Chicago Site → USA → SpotillaWorxor Ltd.\"\n ],\n \"spot_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Viimeisin huolto tehty\",\n \"value\": \"2000-11-19T00:00:00.000+00:00\",\n \"input_type\": \"date\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Jäähdyttimen kunto\",\n \"value\": \"\",\n \"input_type\": \"select\",\n \"definition\": \"\",\n \"value_selections\": [\n \"Hyvä\",\n \"Huono\",\n \"Rikki\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Palaute-linkki\",\n \"value\": \"\",\n \"input_type\": \"url\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"valinnat\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Vapaa tekstikenttä\",\n \"value\": \"\",\n \"input_type\": \"text\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Volume of container\",\n \"value\": \"\",\n \"input_type\": \"number\",\n \"definition\": \"\",\n \"value_selections\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"key\": \"Yhteyshenkilön linkki\",\n \"value\": \"\",\n \"input_type\": \"url\",\n \"definition\": \"\",\n \"value_selections\": []\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"surface_number\": \"B08041\",\n \"read_events\": [],\n \"reservations\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"reservation for tennis\",\n \"explanation\": \"this reservation is made for tennis\",\n \"start_time\": \"2021-06-23T00:00:00.000+03:00\",\n \"end_time\": \"2021-06-24T00:00:00.000+03:00\",\n \"user\": {},\n \"contact_name\": \"{{rand_name}}\",\n \"contact_phone\": \"{{rand_name}}\",\n \"contact_email\": \"{{rand_email}}\",\n \"status\": \"active\",\n \"reservation_site\": {},\n \"fullday\": false\n }\n ],\n \"location\": null,\n \"spot_image\": {\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/b019aa57-dd86-4592-9ec9-77383ec5fec6\",\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/b019aa57-dd86-4592-9ec9-77383ec5fec6\"\n },\n \"log_machine_hours\": false,\n \"running_machine_hours\": 0.0,\n \"spare_parts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 20\",\n \"code\": \"A20\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vantaa Warehouse\",\n \"amount\": 1.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"amount\": 0.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Delhi Warehouse\",\n \"amount\": 1.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"amount\": 23.0\n }\n ]\n },\n \"created_at\": \"2021-06-17T16:56:02.397+03:00\",\n \"updated_at\": \"2021-06-17T16:56:02.397+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 101\",\n \"code\": \"A10\",\n \"manufacturer\": \"\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": []\n },\n \"created_at\": \"2021-06-17T16:56:02.398+03:00\",\n \"updated_at\": \"2021-06-17T16:56:02.398+03:00\"\n }\n ],\n \"active_notifications\": 0\n}"}],"_postman_id":"eff34c94-7bf4-42e1-b1e2-36f9b0b6debe"},{"name":"/v3/spots/:id/permissions","id":"7b21c839-cb29-45c3-9dd8-25f65839c54f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/spots/:id/permissions","description":"

get the permissions for the selected spot, such as read, update, and other actions

\n","urlObject":{"path":["api","v3","spots",":id","permissions"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"52a6ea01-cfe4-4d80-ab8b-b35de137c16d","name":"/v3/spots/:id/permissions","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:id/permissions","host":["api","spotilla","fi"],"path":["api","v3","spots",":id","permissions"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"update\": true,\n \"read\": true,\n \"messages\": {\n \"read\": true,\n \"create\": true\n },\n \"files\": {\n \"read\": true,\n \"create\": true\n }\n}"}],"_postman_id":"7b21c839-cb29-45c3-9dd8-25f65839c54f"},{"name":"/v3/spots/:id/files_by_dir","id":"ede368fa-fa9a-42ce-ba63-cbf8a6fd704c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/spots/:spot_id/files_by_dir","description":"

Get all files for spot grouped by directories.

\n

Files outside of any directory will be under a pseudo directory with id: _outside_dir_

\n","urlObject":{"path":["api","v3","spots",":spot_id","files_by_dir"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"ba7241b3-83f8-42ce-98e1-9ac33731dbf8","name":"/v3/spots/:id/files_by_dir","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:spot_id/files_by_dir","host":["api","spotilla","fi"],"path":["api","v3","spots",":spot_id","files_by_dir"],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"_outside_dir_\",\r\n \"name\": \"\",\r\n \"file_count\": 1,\r\n \"files\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"image/png\",\r\n \"created_at\": \"2021-07-02T14:01:56.385+03:00\",\r\n \"header\": \"iB75RRKcwuwZ-RP5aCVkoA.png\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Empty\",\r\n \"file_count\": 0,\r\n \"files\": []\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Misc\",\r\n \"file_count\": 4,\r\n \"files\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"image/jpeg\",\r\n \"created_at\": \"2023-03-20T07:54:55.728+02:00\",\r\n \"header\": \"IMG_0638.jpeg\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"image/png\",\r\n \"created_at\": \"2023-03-20T07:55:47.401+02:00\",\r\n \"header\": \"IMG_0637.png\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"video/mp4\",\r\n \"created_at\": \"2023-03-20T07:55:47.626+02:00\",\r\n \"header\": \"RPReplay_Final1675677930.mp4\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/assets/video_thumb.png\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"image/jpeg\",\r\n \"created_at\": \"2023-03-20T07:56:03.426+02:00\",\r\n \"header\": \"IMG_0638.jpeg\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ]\r\n }\r\n]"}],"_postman_id":"ede368fa-fa9a-42ce-ba63-cbf8a6fd704c"},{"name":"/v3/spots/:id/files","id":"e00d9cf9-5d3c-4987-8ced-a1e41fd3fa06","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/spots/:id/files","description":"

Get Spot Files

\n

This endpoint returns the files associated with a specific spot.

\n

Request

\n\n

Response

\n

The response for this request can be documented as a JSON schema. It will include the details of the files associated with the specified spot.

\n","urlObject":{"path":["api","v3","spots",":id","files"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"3f9c1f7d-a862-4851-943f-7f6421c9626e","name":"/v3/spots/:id/files","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:id/files","host":["api","spotilla","fi"],"path":["api","v3","spots",":id","files"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2024-06-25T06:10:45.469Z\",\n \"header\": \"application_thumb.png\",\n \"uploaded_by\": \"{{rand_name}}\",\n \"thumbnail_url\": \"http://api.mahtavadeveloper.com/assets/application_thumb.png\",\n \"url\": \"http://api.mahtavadeveloper.com/api/v3/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_type\": \"Spot\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n]"}],"_postman_id":"e00d9cf9-5d3c-4987-8ced-a1e41fd3fa06"},{"name":"/v3/spots/:id/files [deprecated]","id":"0bb11132-6863-4de0-8472-9e2126c71325","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"body":{"mode":"raw","raw":"{\r\n \"upload_item\": {\r\n \"file_description\": \"This is a file.\",\r\n \"content_type\": \"image/png\",\r\n \"file_base\": \"BASE64 encoded file\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:id/files","description":"

Deprecated, use \"UploadItems\" instead, either omni_upload or chunks.

\n

This API endpoint allows the user to upload a file to a specific spot by providing the spot UUID. The request should be sent as an HTTP POST to api.spotilla.fi/api/v3/spots/:id/files. The request body should contain the upload_item object with the properties file_description, content_type, and file_base to specify the file to be uploaded.

\n","urlObject":{"path":["api","v3","spots",":id","files"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"8acf01fa-5663-4cf2-a5a3-75fe37ab1948","name":"/v3/spots/:id/files","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"upload_item\": {\r\n \"file_description\": \"This is a file.\",\r\n \"content_type\": \"image/png\",\r\n \"file_base\": \"BASE64 encoded file\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/1806b784-c758-4ed2-adef-0a2db5126ead/files"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2024-06-25T06:10:45.469Z\",\n \"header\": \"application_thumb.png\",\n \"uploaded_by\": \"{{rand_name}}\",\n \"thumbnail_url\": \"http://api.mahtavadeveloper.com/assets/application_thumb.png\",\n \"url\": \"http://api.mahtavadeveloper.com/api/v3/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_type\": \"Spot\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n}\n"}],"_postman_id":"0bb11132-6863-4de0-8472-9e2126c71325"},{"name":"v3/spots/:id/machine_hour_histories","id":"bd51b321-ee3a-415e-bd70-b210f12a0522","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"

The API endpoint GET /spots/{spotId}/machine_hour_histories retrieves the machine hour histories for a specific spot identified by the spotId.

\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[{"id":"71fc0a7b-b5b3-42ae-84fd-1c5f7409d69a","name":"v3/spots/:id/machine_hour_histories","originalRequest":{"method":"GET","header":[],"url":"api.spotilla.fi/api/v3/spots/728bd281-5440-4b8b-8ce7-d0d5ff71e1ba/machine_hour_histories"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"f7d8125a-e7a2-4413-8388-4f3bcaae2083\",\r\n \"logged_value\": 2.03,\r\n \"spot_id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\r\n \"task_id\": null,\r\n \"created_at\": \"2024-10-09T09:57:57.722Z\",\r\n \"updated_at\": \"2024-10-09T09:57:57.722Z\"\r\n },\r\n {\r\n \"id\": \"1d97c597-821f-4e78-9432-1f5894e7fa45\",\r\n \"logged_value\": 2.0,\r\n \"spot_id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\r\n \"task_id\": null,\r\n \"created_at\": \"2024-10-08T13:15:18.803Z\",\r\n \"updated_at\": \"2024-10-08T13:15:18.803Z\"\r\n }\r\n]"}],"_postman_id":"bd51b321-ee3a-415e-bd70-b210f12a0522"}],"id":"df3b7df3-f24e-4a5d-be0b-3353ef9ebdff","description":"

Spot endpoints. With these you GET/POST/PATCH data related to \"spot\"-items inside Spotilla. Spot items typically represent devices, tools, vehicles, sites, assets etc.

\n","_postman_id":"df3b7df3-f24e-4a5d-be0b-3353ef9ebdff"},{"name":"Tags","item":[{"name":"/v3/tags/:id","id":"557e3d63-b2ae-42c3-b26f-c88e01ff07c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tags/:id?latitude=60.1661516741198878&longitude=24.903161753968433","description":"

This endpoint retrieves details of a specific tag based on the provided tag ID.

\n

Request

\n\n","urlObject":{"path":["api","v3","tags",":id"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

only for spot tag; for create read event data

\n","type":"text/plain"},"key":"latitude","value":"60.1661516741198878"},{"description":{"content":"

only for spot tag; for create read event data

\n","type":"text/plain"},"key":"longitude","value":"24.903161753968433"}],"variable":[{"description":{"content":"

tag internal id (not tag UUID)

\n","type":"text/plain"},"type":"any","value":"1337193677219968","key":"id"}]}},"response":[{"id":"dc9ead0f-dd27-42d2-857c-655397ccaa61","name":"/v2/tags/:id","originalRequest":{"method":"GET","header":[],"url":{"raw":"api.spotilla.fi/api/v2/tags/:id?latitude=60.16615167411988&longitude=24.903161753968433","host":["api","spotilla","fi"],"path":["api","v2","tags",":id"],"query":[{"key":"latitude","value":"60.16615167411988","type":"text"},{"key":"longitude","value":"24.903161753968433","type":"text"}],"variable":[{"key":"id","value":"1123034230342303"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"surface_number\": \"P04269\",\n \"created_at\": \"2021-09-14T16:08:09.140+03:00\",\n \"updated_at\": \"2021-09-16T15:12:53.183+03:00\",\n \"internal_id\": \"1123034230342303\",\n \"taggable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"taggable_type\": \"Spot\",\n \"read_event_id\": 16027\n}"}],"_postman_id":"557e3d63-b2ae-42c3-b26f-c88e01ff07c3"},{"name":"/v3/tags/available","id":"3aaff4b7-0a46-4a3a-9ba2-48d9d156330f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tags/available","description":"

GET /api/v3/tags/available

\n

This endpoint retrieves the available tags from the Spotilla API.

\n

Request

\n

No request body is required for this request.

\n","urlObject":{"path":["api","v3","tags","available"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"8246ae08-0ddc-4fff-88ea-53571480d1ca","name":"/v3/tags/available","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/tags/available"},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"surface_number\": \"P05415\",\r\n \"taggable_id\": null,\r\n \"taggable_type\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"surface_number\": \"P05416\",\r\n \"taggable_id\": null,\r\n \"taggable_type\": null\r\n }\r\n]"}],"_postman_id":"3aaff4b7-0a46-4a3a-9ba2-48d9d156330f"},{"name":"/v3/read_tag","id":"c369ec2e-34f2-43db-a711-cbe3f1590eaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"body":{"mode":"raw","raw":"{\n \"tag_read_body\": {\n \"internal_id\": \"1166296928456128\", // internal_id field of the tag\n \"latitude\": \"60.16615167411988\",\n \"longitude\": \"24.903161753968433\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/read_tag","description":"

Read a tag and generate a read event in the system.

\n","urlObject":{"path":["api","v3","read_tag"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"8ed0b012-edfa-463a-896f-3d018466a06f","name":"/v3/read_tag","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"tag_read_body\": {\n \"internal_id\": \"www.some.url/QR/774505902903\",\n \"latitude\": \"60.16615167411988\",\n \"longitude\": \"24.903161753968433\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/read_tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"created_at\": \"2022-02-11T14:30:34.037+02:00\",\n \"updated_at\": \"2022-09-14T15:44:52.268+03:00\",\n \"internal_id\": \"1122244428512128\",\n \"surface_number\": \"A0001\",\n \"taggable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"taggable_type\": \"Spot\",\n \"read_event_id\": 1\n}"},{"id":"41230bd8-1fb1-4cc2-b613-5102a56782f7","name":"/v3/read_tag (url encoded)","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"tag_read_body\": {\n \"internal_id\": \"www.some.url/QR/\\\"774505902903\\\"\",\n \"latitude\": \"60.16615167411988\",\n \"longitude\": \"24.903161753968433\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/read_tag"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"created_at\": \"2022-02-11T14:30:34.037+02:00\",\n \"updated_at\": \"2022-09-14T15:44:52.268+03:00\",\n \"internal_id\": \"www.some.url/QR/\\\"774505902903\\\"\",\n \"surface_number\": \"A0001\",\n \"taggable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"taggable_type\": \"Spot\",\n \"read_event_id\": 1\n}"}],"_postman_id":"c369ec2e-34f2-43db-a711-cbe3f1590eaa"}],"id":"7191117f-5f56-4f89-8fb6-160439d66368","_postman_id":"7191117f-5f56-4f89-8fb6-160439d66368","description":""},{"name":"Customers","item":[{"name":"Customers","item":[{"name":"/v3/customers","id":"217a037a-3c5e-470b-b0ce-c21118059ea7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"text"}],"url":"api.spotilla.fi/api/v3/customers?q[page]=1&q[name]=customer_name","description":"

Get a list of paginated customers.

\n","urlObject":{"path":["api","v3","customers"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":"1"},{"description":{"content":"

filter results by customer name; optional param

\n","type":"text/plain"},"key":"q[name]","value":"customer_name"}],"variable":[]}},"response":[{"id":"8ea8b9c8-b086-4572-b659-a2c3dac53dc9","name":"/v3/customers","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers?q[page]=1&q[name]=at","host":["api","spotilla","fi"],"path":["api","v3","customers"],"query":[{"key":"q[page]","value":"1"},{"key":"q[name]","value":"at","description":"optional params"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Spotilla\",\n \"customer_type\": \"company\",\n \"legal_name\": \"Spotilla Oy\",\n \"company_id\": \"123456-6\",\n \"vat\": \"24\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"example@email.com\",\n \"customer_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"value\": \"Suomi\",\n \"description\": \"Konttori\",\n \"attr_header\": \"Country\",\n \"attr_type\": \"text\",\n \"select_options\": \"\"\n }\n ],\n \"created_at\": \"2022-09-01T11:38:30.902+03:00\",\n \"updated_at\": \"2022-09-01T12:20:50.749+03:00\",\n \"address\": \"Vantaankoskentie 14 G\",\n \"postcode\": \"01670 \",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Vantaankoskentie 14 G\",\n \"inv_postcode\": \"01670 \",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"invoicing@email.fi\",\n \"e_invoice_address\": \"99894515\",\n \"operator\": \"BAWCFI22\",\n \"customer_number\": \"32323222\",\n \"work_orders\": [],\n \"customer_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n },\n \"customer_cost_center\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"100\"\n },\n \"additional_details\": \"Any text you need\"\n }\n]"}],"_postman_id":"217a037a-3c5e-470b-b0ce-c21118059ea7"},{"name":"/v3/customers/:id","id":"304d42ef-21d7-40ef-8c66-0569b1bddd85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customers/:id","description":"

Get details about a single customer.

\n","urlObject":{"path":["api","v3","customers",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"17fe694c-f592-44df-8493-7bf2c83cd928","name":"/v3/customers/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers/:id","host":["api","spotilla","fi"],"path":["api","v3","customers",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics\",\n \"customer_type\": \"company\",\n \"legal_name\": \"Atmotics Oy\",\n \"company_id\": \"3276157-6\",\n \"vat\": \"24\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"contact@email.com\",\n \"customer_attributes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"value\": \"Suomi\",\n \"description\": \"Konttori\",\n \"attr_header\": \"Country\",\n \"attr_type\": \"text\",\n \"select_options\": \"\"\n }\n ],\n \"created_at\": \"2022-09-01T11:38:30.902+03:00\",\n \"updated_at\": \"2022-09-01T12:20:50.749+03:00\",\n \"address\": \"Vantaankoskentie 14 G\",\n \"postcode\": \"01670 \",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Vantaankoskentie 14 G\",\n \"inv_postcode\": \"01670 \",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"invoicing@email.fi\",\n \"e_invoice_address\": \"99894515\",\n \"operator\": \"BAWCFI22\",\n \"customer_number\": \"32323222\",\n \"work_orders\": [],\n \"customer_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n },\n \"customer_cost_center\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"100\"\n },\n \"additional_details\": \"Any text you need\"\n}"}],"_postman_id":"304d42ef-21d7-40ef-8c66-0569b1bddd85"},{"name":"/v3/customers","id":"83dffef4-d6d9-4010-a432-d6398602370c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer\": {\n \"name\": \"John Doe\", // required field\n \"customer_type\": \"consumer\", // required field \n \"legal_name\": \"Johnathan Doe\",\n \"company_id\": \"12345\",\n \"vat\": \"123456789\",\n \"customer_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_cost_center_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"phone\": \"123-456-7890\",\n \"mobile\": \"098-765-4321\",\n \"email\": \"john.doe@example.com\",\n \"address\": \"123 Main St\",\n \"postcode\": \"12345\",\n \"city\": \"Anytown\",\n \"country\": \"US\",\n \"inv_address\": \"456 Secondary St\",\n \"inv_postcode\": \"67890\",\n \"inv_city\": \"Othertown\",\n \"inv_country\": \"US\",\n \"invoicing_email\": \"invoice@example.com\",\n \"e_invoice_address\": \"e-invoice-address\",\n \"operator\": \"Operator Name\",\n \"customer_number\": \"98765\",\n \"additional_details\": \"Any text you need\",\n \"customer_contacts_attributes\": [\n {\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass contact UUID here\n }\n ],\n \"collections_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass collection UUID here\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customers","description":"

This endpoint allows you to add a new customer.

\n

Request Body

\n\n

Other fields are optional.

\n\n","urlObject":{"path":["api","v3","customers"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"9bab11ec-171f-4338-a781-15f2d01f6a9d","name":"/v3/customers","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer\": {\r\n \"name\": \"New Customer\",\r\n \"legal_name\": \"Customer Oy\",\r\n \"company_id\": \"39922-33\",\r\n \"customer_type\": \"company\",\r\n \"customer_number\": \"3232332111\",\r\n \"customer_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_cost_center_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"vat\": \"24\",\r\n \"phone\": \"09 8566111\",\r\n \"mobile\": \"040-54894561\",\r\n \"email\": \"info@new_customer.fi\",\r\n \"address\": \"Nelikkotie 3\",\r\n \"postcode\": \"02230\",\r\n \"city\": \"Espoo\",\r\n \"country\": \"FI\",\r\n \"invoicing_email\": \"laskutus@new_customer.fi\",\r\n \"inv_address\": \"Laskutustie 3\",\r\n \"inv_postcode\": \"00100\",\r\n \"inv_city\": \"Helsinki\",\r\n \"inv_country\": \"FI\",\r\n \"e_invoice_address\": \"132431222\",\r\n \"operator\": \"003714377140\",\r\n \"additional_details\": \"Any text you need\",\r\n \"customer_contacts_attributes\": [\r\n {\r\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"collections_ids\": [\r\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customers"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"New Customer\",\n \"customer_type\": \"company\",\n \"legal_name\": \"Customer Oy\",\n \"company_id\": \"39922-33\",\n \"vat\": \"24\",\n \"phone\": \"09 8566111\",\n \"mobile\": \"040-54894561\",\n \"email\": \"info@new_customer.fi\",\n \"customer_attributes\": [],\n \"created_at\": \"2022-09-01T12:42:53.695+03:00\",\n \"updated_at\": \"2022-09-01T12:42:53.695+03:00\",\n \"address\": \"Nelikkotie 3\",\n \"postcode\": \"02230\",\n \"city\": \"Espoo\",\n \"country\": \"FI\",\n \"inv_address\": \"Laskutustie 3\",\n \"inv_postcode\": \"00100\",\n \"inv_city\": \"Helsinki\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"laskutus@new_customer.fi\",\n \"e_invoice_address\": \"132431222\",\n \"operator\": \"003714377140\",\n \"customer_number\": \"3232332111\",\n \"work_orders\": [],\n \"customer_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n },\n \"customer_cost_center\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"100\"\n },\n \"additional_details\": \"Any text you need\"\n}"}],"_postman_id":"83dffef4-d6d9-4010-a432-d6398602370c"},{"name":"/v3/customers/:id","id":"2a9128a8-1dfc-4e5d-b265-94ea7f3b3677","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer\": {\n \"name\": \"John Doe\",\n \"customer_type\": \"company\", // enum type: [\"company\", \"consumer\"]\n \"legal_name\": \"John Doe Legal\",\n \"company_id\": \"123456789\",\n \"vat\": \"VAT123456\",\n \"customer_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_cost_center_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"phone\": \"+1234567890\",\n \"mobile\": \"+0987654321\",\n \"email\": \"johndoe@example.com\",\n \"address\": \"123 Main St\",\n \"postcode\": \"12345\",\n \"city\": \"Sample City\",\n \"country\": \"US\",\n \"inv_address\": \"456 Invoice St\",\n \"inv_postcode\": \"54321\",\n \"inv_city\": \"Invoice City\",\n \"inv_country\": \"US\",\n \"invoicing_email\": \"invoice@example.com\",\n \"e_invoice_address\": \"EINV123456\",\n \"operator\": \"Operator Name\",\n \"customer_number\": \"CUST123456\",\n \"additional_details\": \"Any text you need\",\n \"collections_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"], // Do not send this key at all unless you know what you are doing\n \"customer_attributes_attributes\": [\n {\n \"id\": \"1d464bb9-1234-8765-8d5f-ec00c1840c36\", // UUID of the nested object within the customer_attributes array.\n \"value\": \"Attribute Value 1\", // value to be updated\n \"description\": \"Attribute Description 1\" // description to be updated\n }\n ],\n \"customer_contacts_attributes\": [\n { // params when removing exsisting contact from the customer.\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of the nested object within the customer_contacts_attributes array\n \"_destroy\": true\n },\n { // params when adding new contact to the customer.\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // CustomerContact UUID\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customers/:id","description":"

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n\n","urlObject":{"path":["api","v3","customers",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"6d46c1cc-b965-464c-8128-943b9e1a6948","name":"/v3/customers/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer\": {\r\n \"name\": \"Updated Customer\",\r\n \"legal_name\": \"Customer Oy\",\r\n \"company_id\": \"39922-33\",\r\n \"customer_type\": \"company\",\r\n \"customer_number\": \"3232332111\",\r\n \"vat\": \"24\",\r\n \"customer_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_cost_center_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"phone\": \"09 8566111\",\r\n \"mobile\": \"040-54894561\",\r\n \"email\": \"info@new_customer.fi\",\r\n \"address\": \"Nelikkotie 3\",\r\n \"postcode\": \"02230\",\r\n \"city\": \"Espoo\",\r\n \"country\": \"FI\",\r\n \"invoicing_email\": \"laskutus@new_customer.fi\",\r\n \"inv_address\": \"Laskutustie 3\",\r\n \"inv_postcode\": \"00100\",\r\n \"inv_city\": \"Helsinki\",\r\n \"inv_country\": \"FI\",\r\n \"e_invoice_address\": \"132431222\",\r\n \"operator\": \"003714377140\",\r\n \"additional_details\": \"Any text you need\",\r\n \"customer_contacts_attributes\": [\r\n {\r\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" \r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"_destroy\": true\r\n }\r\n ],\r\n \"collections_ids\": [], // Do not send this key at all unless you know what you are doing\r\n \"customer_attributes_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Value for attribute\",\r\n \"description\": \"Updated value\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/customers/:id","host":["api","spotilla","fi"],"path":["api","v3","customers",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Updated Customer\",\r\n \"customer_type\": \"company\",\r\n \"legal_name\": \"Customer Oy\",\r\n \"company_id\": \"39922-33\",\r\n \"vat\": \"24\",\r\n \"phone\": \"09 8566111\",\r\n \"mobile\": \"040-54894561\",\r\n \"email\": \"info@new_customer.fi\",\r\n \"customer_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Value for attribute\",\r\n \"description\": \"Updated value\",\r\n \"attr_header\": \"Customer Text Attribute\",\r\n \"attr_type\": \"text\",\r\n \"select_options\": null\r\n }\r\n ],\r\n \"created_at\": \"2022-09-01T12:42:53.695+03:00\",\r\n \"updated_at\": \"2022-09-01T12:42:53.695+03:00\",\r\n \"address\": \"Nelikkotie 3\",\r\n \"postcode\": \"02230\",\r\n \"city\": \"Espoo\",\r\n \"country\": \"FI\",\r\n \"inv_address\": \"Laskutustie 3\",\r\n \"inv_postcode\": \"00100\",\r\n \"inv_city\": \"Helsinki\",\r\n \"inv_country\": \"FI\",\r\n \"invoicing_email\": \"laskutus@new_customer.fi\",\r\n \"e_invoice_address\": \"132431222\",\r\n \"operator\": \"003714377140\",\r\n \"customer_number\": \"3232332111\",\r\n \"work_orders\": [],\r\n \"customer_group\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"1. Teollisuus\"\r\n },\r\n \"customer_sales_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Yleinen myyntitili\",\r\n \"account_number\": \"3100\"\r\n },\r\n \"customer_cost_center\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Helsinki\",\r\n \"cost_center_number\": \"100\"\r\n },\r\n \"additional_details\": \"Any text you need\",\r\n}"}],"_postman_id":"2a9128a8-1dfc-4e5d-b265-94ea7f3b3677"},{"name":"/v3/customers/:id","id":"4f6bb42b-7bfe-45c5-a326-5b851f9362b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customers/:id","description":"

Delete a customer by UUID that the user has permission

\n","urlObject":{"path":["api","v3","customers",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"3f23e5c2-9120-4f34-b323-6c4a57734e83","name":"/v3/customers/:id","originalRequest":{"method":"DELETE","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers/:id","host":["api","spotilla","fi"],"path":["api","v3","customers",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"msg\": \"Destroy successful\"\n}"}],"_postman_id":"4f6bb42b-7bfe-45c5-a326-5b851f9362b1"},{"name":"/v3/customers/:id/contacts","id":"ef8d0c80-712a-44fb-8369-f95d8acd6a8a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customers/:id/contacts?q[page]=1&q[name]=contact_name","description":"

Get contact list for the current customer. Reesults can be filtered by the following optional query params:

\n\n","urlObject":{"path":["api","v3","customers",":id","contacts"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":"1"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[name]","value":"contact_name"}],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"c2dab3a8-f3cf-486e-83db-dac3e546b8e1","name":"/v3/customers/:id/contacts","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers/:id/contacts?q[page]=1&q[name]=mak","host":["api","spotilla","fi"],"path":["api","v3","customers",":id","contacts"],"query":[{"key":"q[page]","value":"1"},{"key":"q[name]","value":"mak"}],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"firstname\": \"Make\",\n \"lastname\": \"Mallikas\",\n \"email\": \"make@mallikas.com\",\n \"phone\": \"0504186465\",\n \"title\": \"Customer Service Specialist\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Atmotics\",\n \"status\": \"active\",\n \"customer_number\": \"32323222\",\n \"legal_name\": \"Atmotics Oy\",\n \"company_id\": \"3276157-6\",\n \"vat\": \"24\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"contact@email.com\",\n \"created_at\": \"2022-09-01T11:38:30.902+03:00\",\n \"updated_at\": \"2022-09-01T12:20:50.749+03:00\",\n \"address\": \"Example street 14 G\",\n \"postcode\": \"01670 \",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Example street 14 G\",\n \"inv_postcode\": \"01670 \",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"invoicing@email.fi\",\n \"e_invoice_address\": \"99894515\",\n \"operator\": \"BAWCFI22\"\n }\n ],\n \"customer_contacts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ]\n }\n]"}],"_postman_id":"ef8d0c80-712a-44fb-8369-f95d8acd6a8a"},{"name":"/v3/customers/:id/collections","id":"b7a580d6-715c-4b96-bec3-1c776193b281","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"text"}],"url":"api.spotilla.fi/api/v3/customers/:id/collections","description":"

Get a list of collections associated with a specified customer that the current user has permissions to access

\n","urlObject":{"path":["api","v3","customers",":id","collections"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"413ea20d-fb43-43c8-a441-1ccb6f8f5ae0","name":"/v3/customers/:id/collections","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers/:id/collections","host":["api","spotilla","fi"],"path":["api","v3","customers",":id","collections"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Norja\",\n \"description\": \"\",\n \"spot_ids\": [],\n \"children_ids\": [],\n \"num_of_spots\": 0,\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"depth\": 1,\n \"collection_extra_fields\": [],\n \"upload_items\": [],\n \"locked_attributes\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tukholma\",\n \"description\": \"\",\n \"spot_ids\": [],\n \"children_ids\": [],\n \"num_of_spots\": 0,\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"depth\": 2,\n \"collection_extra_fields\": [],\n \"upload_items\": [],\n \"locked_attributes\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ruotsi\",\n \"description\": \"\",\n \"spot_ids\": [],\n \"children_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"num_of_spots\": 0,\n \"collection_permissions\": {\n \"read\": true,\n \"update\": true\n },\n \"message_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"attachment_permissions\": {\n \"read\": true,\n \"create\": true\n },\n \"depth\": 1,\n \"collection_extra_fields\": [],\n \"upload_items\": [],\n \"locked_attributes\": []\n }\n]"}],"_postman_id":"b7a580d6-715c-4b96-bec3-1c776193b281"},{"name":"/v3/customers/:id/spots","id":"ee63e6ae-8319-45d5-b18d-0de8b8a5b3bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"text"}],"url":"api.spotilla.fi/api/v3/customers/:id/spots?q[page]=1","description":"

Get a list of spots associated with a specified customer that the current user has permissions to access.

\n

Use as=all parameter to return all spots without pagination.

\n

Use q[page] param to return only one page at a time. Use name parameter to filter results by spot name.

\n","urlObject":{"path":["api","v3","customers",":id","spots"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"},{"disabled":true,"key":"as","value":"all"},{"disabled":true,"key":"name","value":"huolto"}],"variable":[{"description":{"content":"

customer UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"94ebc71a-6ea6-47e1-93db-d20514e0045a","name":"/v3/customers/:id/spots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customers/:id/spots?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","customers",":id","spots"],"query":[{"key":"q[page]","value":"1"}],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": ae68c14f-9512-490c-8d6a-a43e3ed290d2,\n \"name\": \"Abloy SAFEA ASP-Palvelin\",\n \"description\": \"ASP-Palvelin palveluntuottajalla!asdasd\",\n \"surface_number\": null,\n \"status\": \"active\",\n \"read_events\": [\n {\n \"id\": 16303433436,\n \"latitude\": \"60.254601\",\n \"longitude\": \"24.0810446\",\n \"created_at\": \"2022-11-11T10:07:00.565+02:00\",\n \"updated_at\": \"2022-11-11T10:07:00.565+02:00\",\n \"user\": {\n \"id\": ae68c14f-9512-490c-8d6a-a43e3ed290d2,\n \"name\": \"System Admin\"\n }\n }\n ],\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"spot_image\": {\n \"thumbnail_url\": \"\", // url\n \"url\": \"\" // url\n },\n \"collection\": {\n \"id\": ae68c14f-9512-490c-8d6a-a43e3ed290d2,\n \"name\": \"Huoltoautot\",\n \"description\": \"\",\n \"created_at\": \"2025-09-30T16:14:21.893+03:00\",\n \"updated_at\": \"2025-10-06T15:18:02.754+03:00\"\n },\n \"collection_path\": \"Huoltoautot → Tuotantolaitos Kalliola → Oy Kunnossapitodemo AB\",\n \"log_machine_hours\": false,\n \"running_machine_hours\": 0.0\n }\n]"}],"_postman_id":"ee63e6ae-8319-45d5-b18d-0de8b8a5b3bd"}],"id":"7382f0f8-0864-4bc2-96c6-5d5efe504342","_postman_id":"7382f0f8-0864-4bc2-96c6-5d5efe504342","description":""},{"name":"Customer Contacts","item":[{"name":"/v3/contacts/:id","id":"9ab380e7-f520-449a-b284-0c93d639da16","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/contacts/:id","description":"

This endpoint retrieves the details of a specific contact identified by the unique UUID in the URL.

\n","urlObject":{"path":["api","v3","contacts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"ca09e7e0-0058-459b-9344-61908fa59b02","name":"/v3/contacts/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/contacts/:id","host":["api","spotilla","fi"],"path":["api","v3","contacts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"contact UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"firstname\": \"Maikko\",\n \"lastname\": \"Mallikas\",\n \"email\": \"{{rand_email}}\",\n \"phone\": \"0501234567\",\n \"title\": \"Customer Service Specialist\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Atmotics\",\n \"status\": \"active\",\n \"customer_number\": \"32323222\",\n \"legal_name\": \"Atmotics Oy\",\n \"company_id\": \"3276157-6\",\n \"vat\": \"24\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"contact@email.com\",\n \"created_at\": \"2022-09-01T11:38:30.902+03:00\",\n \"updated_at\": \"2022-09-01T12:20:50.749+03:00\",\n \"address\": \"Example street 14 G\",\n \"postcode\": \"01670 \",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Example street 14 G\",\n \"inv_postcode\": \"01670 \",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"invoicing@email.fi\",\n \"e_invoice_address\": \"99894515\",\n \"operator\": \"BAWCFI22\"\n }\n ],\n \"customer_contacts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ]\n}"}],"_postman_id":"9ab380e7-f520-449a-b284-0c93d639da16"},{"name":"/v3/contacts","id":"3f33b8fd-4419-464b-aaa8-7194809d62ee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"contact\": {\n \"firstname\": \"John\", // required\n \"lastname\": \"Doe\", // required\n \"email\": \"john.doe@example.com\", // required\n \"phone\": \"123-456-7890\",\n \"title\": \"Manager\",\n \"customer_contacts_attributes\": [\n {\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ]\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/contacts","description":"

This endpoint allows you to create a new contact in the Spotilla system.

\n\n

Request Body

\n\n","urlObject":{"path":["api","v3","contacts"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"3d4c7c6f-7ce6-4c80-bb66-83f5aee3abf8","name":"/v3/contacts","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"contact\": {\r\n \"firstname\": \"Markku\",\r\n \"lastname\": \"Mallikkainen\",\r\n \"email\": \"markku@mallikas.com\",\r\n \"phone\": \"0503335581\",\r\n \"title\": \"Account Manager\",\r\n \"customer_contacts_attributes\": [\r\n { \r\n \"customer_id\": \"af6b71f4-716d-481c-9552-e1a485ed39bf\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/contacts"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"firstname\": \"John\",\n \"lastname\": \"Doe\",\n \"email\": \"john.doe@example.com\",\n \"phone\": \"123-456-7890\",\n \"title\": \"Manager\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"consumer\",\n \"name\": \"John Doe\",\n \"status\": \"active\",\n \"customer_number\": \"98765\",\n \"legal_name\": \"Johnathan Doe\",\n \"company_id\": \"12345\",\n \"vat\": \"123456789\",\n \"phone\": \"123-456-7890\",\n \"mobile\": \"098-765-4321\",\n \"email\": \"john.doe@example.com\",\n \"created_at\": \"2024-06-28T07:46:10.913Z\",\n \"updated_at\": \"2024-06-28T07:46:10.913Z\",\n \"address\": \"123 Main St\",\n \"postcode\": \"12345\",\n \"city\": \"Anytown\",\n \"country\": \"USA\",\n \"inv_address\": \"456 Secondary St\",\n \"inv_postcode\": \"67890\",\n \"inv_city\": \"Othertown\",\n \"inv_country\": \"USA\",\n \"invoicing_email\": \"invoice@example.com\",\n \"e_invoice_address\": \"e-invoice-address\",\n \"operator\": \"Operator Name\"\n }\n ],\n \"customer_contacts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ]\n}"}],"_postman_id":"3f33b8fd-4419-464b-aaa8-7194809d62ee"},{"name":"/v3/contacts/:id","id":"35e1b6a3-3925-45a1-83b3-634e563ba51c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"contact\": {\n \"firstname\": \"Markku\",\n \"lastname\": \"Mallikkainen\",\n \"email\": \"markku@mallikas.com\",\n \"phone\": \"0503335581\",\n \"title\": \"Account Manager\",\n \"customer_contacts_attributes\": [\n { // example params for adding customer \n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass customer uuid here\n },\n { // example params for removing customer \n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass UUID of nested object within customer_contacts_attributes\n \"_destroy\": 1\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/contacts/:id","description":"

This endpoint is used to update the contact information for a specific contact identified by the provided :id.

\n

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n","urlObject":{"path":["api","v3","contacts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

contact UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"24516a85-04ee-45f8-b491-5a7532182a5e","name":"/v3/contacts/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"contact\": {\r\n \"firstname\": \"Markku\",\r\n \"lastname\": \"Mallikkainen\",\r\n \"email\": \"markku@mallikas.com\",\r\n \"phone\": \"0503335581\",\r\n \"title\": \"Account Manager\",\r\n \"customer_contacts_attributes\": [\r\n { // example params for adding customer \r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass customer uuid here\r\n },\r\n { // example params for removing customer \r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass UUID of nested object within customer_contacts_attributes\r\n \"_destroy\": 1\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/contacts/:id","host":["api","spotilla","fi"],"path":["api","v3","contacts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"contact UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"firstname\": \"Markku\",\n \"lastname\": \"Mallikkainen\",\n \"email\": \"{{rand_email}}\",\n \"phone\": \"0503335581\",\n \"title\": \"Account Manager\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Atmotics\",\n \"status\": \"active\",\n \"customer_number\": null,\n \"legal_name\": \"Atmotics Oy\",\n \"company_id\": \"4564566-5\",\n \"vat\": \"FI25871195\",\n \"phone\": \"0408092872\",\n \"mobile\": \"\",\n \"email\": \"{{rand_email}}\",\n \"created_at\": \"2020-12-18T09:04:01.659+02:00\",\n \"updated_at\": \"2021-02-03T11:57:11.311+02:00\",\n \"address\": null,\n \"postcode\": null,\n \"city\": null,\n \"country\": null,\n \"inv_address\": null,\n \"inv_postcode\": null,\n \"inv_city\": null,\n \"inv_country\": null,\n \"invoicing_email\": null,\n \"e_invoice_address\": null,\n \"operator\": null\n }\n ],\n \"customer_contacts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contact_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ]\n}"}],"_postman_id":"35e1b6a3-3925-45a1-83b3-634e563ba51c"}],"id":"420c5f9f-54d6-4acd-99ed-fe702a3d4910","_postman_id":"420c5f9f-54d6-4acd-99ed-fe702a3d4910","description":""},{"name":"Customer Groups","item":[{"name":"/v3/customer_groups","id":"37fd133e-36c1-4692-b49d-c0220e6fb969","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_groups?as=select&name=teollisuus","description":"

Get a list of all customer groups.

\n

Send without as=select parameter to return also linked customers in the response.

\n

Use name parameter to return only matching records by name. All records are returned if this parameter is not used.

\n","urlObject":{"path":["api","v3","customer_groups"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"select"},{"key":"name","value":"teollisuus"}],"variable":[]}},"response":[{"id":"6c05b97e-3d77-4a4d-90e6-fb000031bc4a","name":"/v3/customer_groups","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_groups?as=select","host":["api","spotilla","fi"],"path":["api","v3","customer_groups"],"query":[{"key":"as","value":"select"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [ // send without select parameter to load customers\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n }\n]"}],"_postman_id":"37fd133e-36c1-4692-b49d-c0220e6fb969"},{"name":"/v3/customer_groups/:id","id":"e72de70e-1982-4ed9-aea6-f92678ec8d12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_groups/:id","description":"

Get details about a single customer group.

\n","urlObject":{"path":["api","v3","customer_groups",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer group UUID

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"3a0d0b0f-10da-48e1-af58-0bd2f8f03418","name":"/v3/customer_groups/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_groups/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_groups",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n}\n"}],"_postman_id":"e72de70e-1982-4ed9-aea6-f92678ec8d12"},{"name":"/v3/customer_groups","id":"1ff0245c-3bb7-4b25-8ace-5f61de05d326","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_group\": {\n \"name\": \"1. Teollisuus\", // required\n \"description\": \"\",\n \"customer_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_groups","description":"

This endpoint allows you to add a new customer group.

\n

Only accessible for integration users.

\n

Request Body

\n\n

Other fields are optional.

\n","urlObject":{"path":["api","v3","customer_groups"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"593dc3de-0eec-4996-a41a-40aa873b5973","name":"/v3/customer_groups","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_group\": {\r\n \"name\": \"1. Teollisuus\",\r\n \"description\": \"\",\r\n \"customer_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_groups"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":" {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n },"}],"_postman_id":"1ff0245c-3bb7-4b25-8ace-5f61de05d326"}],"id":"8e42bb9b-eb27-4933-aa19-61335d240e23","_postman_id":"8e42bb9b-eb27-4933-aa19-61335d240e23","description":""},{"name":"Customer Sales Accounts","item":[{"name":"/v3/customer_sales_accounts","id":"ebabb2bf-9bc2-40dc-baf5-fe035dc4fb5e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_sales_accounts?as=select&name=tili&account_number=3100","description":"

Only accessible for integration users.

\n

Get a list of all customer sales accounts.

\n

Send without as=select parameter to return also linked customers in the response.

\n

Use name parameter to return only matching records by name. Use account_number parameter to return only matching records by account number.

\n

All records are returned if name and account_number parameters are not used.

\n","urlObject":{"path":["api","v3","customer_sales_accounts"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"select"},{"key":"name","value":"tili"},{"key":"account_number","value":"3100"}],"variable":[]}},"response":[{"id":"832a24ee-2ae8-43dc-bc08-c908bb856667","name":"/v3/customer_groups","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_sales_accounts","host":["api","spotilla","fi"],"path":["api","v3","customer_sales_accounts"],"query":[{"key":"as","value":"select","disabled":true}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tili 1\",\n \"account_number\": \"3100\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [ // send without select parameter to load customers\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n }\n]"}],"_postman_id":"ebabb2bf-9bc2-40dc-baf5-fe035dc4fb5e"},{"name":"/v3/customer_sales_accounts/:id","id":"53bd036e-cacc-453b-96d7-3bb8b32af256","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_sales_accounts/:id","description":"

Only accessible for integration users.

\n

Get details about a single customer sales account.

\n","urlObject":{"path":["api","v3","customer_sales_accounts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer sales account id

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"b42e024b-6f86-4a42-aac8-777a416ad85d","name":"/v3/customer_sales_accounts/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_sales_accounts/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_sales_accounts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tili 1\",\n \"account_number\": \"3100\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n}\n"}],"_postman_id":"53bd036e-cacc-453b-96d7-3bb8b32af256"},{"name":"/v3/customer_sales_accounts","id":"71fc0ca7-cb7d-4387-8821-5e0ff3cc7f8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_sales_account\": {\n \"name\": \"Myyntitili\", // required\n \"account_number\": \"3100\", // required and unique\n \"description\": \"\",\n \"customer_ids\": [\"7215-b4ad-45c0-a949-7f01147c002\"] // can be empty, link to customers\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_sales_accounts","description":"

This endpoint allows you to add a new customer sales account.

\n

Only accessible for integration users.

\n

Request Body

\n\n

Other fields are optional. Use customer_ids key to link sales account to customers while creating new sales account.

\n","urlObject":{"path":["api","v3","customer_sales_accounts"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"a6f55099-de9d-4eb4-ac2a-73695973d2f4","name":"/v3/customer_sales_accounts","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_sales_account\": {\r\n \"name\": \"Yleinen myyntitili\",\r\n \"description\": \"Myyntitili\",\r\n \"account_number\": \"3100\",\r\n \"customer_ids\": [\"74232395-b4ad-45c0-a949-7f22002\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_sales_accounts"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":" {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"description\": \"Myyntitili\",\n \"account_number\": \"3100\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n },"}],"_postman_id":"71fc0ca7-cb7d-4387-8821-5e0ff3cc7f8e"}],"id":"71817a75-02f7-4398-b83f-230f39cc5299","_postman_id":"71817a75-02f7-4398-b83f-230f39cc5299","description":""},{"name":"Customer Cost Centers","item":[{"name":"/v3/customer_cost_centers","id":"ef6246d6-cc14-4f01-bcd9-e58d8a729dcc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_cost_centers?as=select&name=Helsinki&cost_center_number=100","description":"

Only accessible for integration users.

\n

Get a list of all customer cost centers.

\n

Send without as=select parameter to return also linked customers in the response.

\n

Use name parameter to return only matching records by name. Use cost_center_number parameter to return only matching records by cost center number.

\n

All records are returned if name and cost_center_number parameters are not used.

\n","urlObject":{"path":["api","v3","customer_cost_centers"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"select"},{"key":"name","value":"Helsinki"},{"key":"cost_center_number","value":"100"}],"variable":[]}},"response":[{"id":"ef49609e-4cce-4c11-9043-c7145ad51c39","name":"/v3/customer_cost_centers","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_cost_centers","host":["api","spotilla","fi"],"path":["api","v3","customer_cost_centers"],"query":[{"key":"as","value":"select","disabled":true}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"180\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [ // send without select parameter to load customers\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n }\n]"}],"_postman_id":"ef6246d6-cc14-4f01-bcd9-e58d8a729dcc"},{"name":"/v3/customer_cost_centers/:id","id":"c36158d3-e74a-44e4-9ff7-c64952e532fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_cost_centers/:id","description":"

Get details about a single customer cost center.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_cost_centers",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"9b364546-fdff-4c93-88e5-401b09060f04","name":"/v3/customer_cost_centers/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_cost_centers/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_cost_centers",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"180\",\n \"description\": \"\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n}\n"}],"_postman_id":"c36158d3-e74a-44e4-9ff7-c64952e532fd"},{"name":"/v3/customer_cost_centers","id":"2cbe71c9-fc51-4121-ae0e-20e6227d714a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_cost_center\": {\n \"name\": \"Helsinki\", // required\n \"cost_center_number\": \"180\", // required and unique\n \"description\": \"\",\n \"customer_ids\": [\"7215-b4ad-45c0-a949-7f01147c002\"] // can be empty, link to customers\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_cost_centers","description":"

This endpoint allows you to add a new customer cost center.

\n

Only accessible for integration users.

\n

Request Body

\n\n

Other fields are optional. Use customer_ids key to link sales account to customers while creating new cost center.

\n","urlObject":{"path":["api","v3","customer_cost_centers"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"d5409239-fcd9-47d9-b3d3-9918d8dac551","name":"/v3/customer_cost_centers","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_cost_center\": {\r\n \"name\": \"Helsinki\",\r\n \"description\": \"Keskusta\",\r\n \"cost_center_number\": \"180\",\r\n \"customer_ids\": [\"72231b4ad-45c0-a949-7f0b221242234\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_cost_centers"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":" {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki\",\n \"cost_center_number\": \"180\",\n \"description\": \"Keskusta\",\n \"created_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"updated_at\": \"2025-09-19T14:23:40.421+03:00\",\n \"customers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Atmotics Oy\"\n }\n ]\n },"}],"_postman_id":"2cbe71c9-fc51-4121-ae0e-20e6227d714a"}],"id":"f3dbab39-4109-41b6-b64c-4e16c5208d1c","_postman_id":"f3dbab39-4109-41b6-b64c-4e16c5208d1c","description":""},{"name":"Customer Contract Types","item":[{"name":"/v3/customer_contract_types","id":"e0785a87-6ba6-477b-8e03-2c496b875b87","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_types?as=select&name=sopimus&external_id=8932","description":"

Get a list of all customer contract types (Sopimustyyppi).

\n

Send without as=select parameter to return also linked contracts in the response.

\n

Use name and external_id parameters to return only matching records. All records are returned if these parameters are not used.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contract_types"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"select"},{"key":"name","value":"sopimus"},{"key":"external_id","value":"8932"}],"variable":[]}},"response":[{"id":"bd5da3fa-4576-4abd-84bb-deb54734e2cc","name":"/v3/customer_contract_types","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_types"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\",\n \"description\": \"\",\n \"external_id\": \"645-464-46446-454\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n }\n]"}],"_postman_id":"e0785a87-6ba6-477b-8e03-2c496b875b87"},{"name":"/v3/customer_contract_types/:id","id":"0f6f1420-3c84-4978-9353-cb03213818c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_types/:id","description":"

Get details about a single customer contract type.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contract_types",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract type UUID

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"593c675e-2e22-4947-8843-95da34916113","name":"/v3/customer_contract_types/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_contract_types/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_contract_types",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\",\n \"description\": \"\",\n \"external_id\": \"645-464-46446-454\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n}"}],"_postman_id":"0f6f1420-3c84-4978-9353-cb03213818c6"},{"name":"/v3/customer_contract_types","id":"37f7933c-53b0-462a-843d-50f6b3b03b82","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_contract_type\": {\n \"name\": \"Huoltokohde\", // required\n \"description\": \"\",\n \"external_id\": \"993933-4334-334-333222\",\n \"customer_contract_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_types","description":"

This endpoint allows you to add a new customer contract type.

\n

Only accessible for integration users.

\n

Request Body

\n\n

Other fields are optional.

\n","urlObject":{"path":["api","v3","customer_contract_types"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"e8af8d90-961c-42f6-9705-b8adadef46e1","name":"/v3/customer_contract_types","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_contract_type\": {\r\n \"name\": \"Huoltokohde\",\r\n \"description\": \"\",\r\n \"external_id\": \"993933-4334-334-333222\",\r\n \"customer_contract_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_types"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Huoltokohde\",\n \"description\": \"\",\n \"external_id\": \"993933-4334-334-333222\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n}"}],"_postman_id":"37f7933c-53b0-462a-843d-50f6b3b03b82"}],"id":"ee6d079c-ae07-4474-8476-1c3f9f4a059f","description":"

All endpoints are only available for integration users.

\n","_postman_id":"ee6d079c-ae07-4474-8476-1c3f9f4a059f"},{"name":"Customer Contract Groups","item":[{"name":"/v3/customer_contract_groups","id":"88b0c250-f15c-47e1-b924-e2acec967b30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_groups?as=select&name=sopimus&external_id=8932","description":"

Get a list of all customer contract groups (Sopimusryhmä).

\n

Send without as=select parameter to return also linked contracts in the response.

\n

Use name and external_id parameters to return only matching records. All records are returned if these parameters are not used.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contract_groups"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"select"},{"key":"name","value":"sopimus"},{"key":"external_id","value":"8932"}],"variable":[]}},"response":[{"id":"8eaccd94-4d96-4785-9bd4-524e3f469e49","name":"/v3/customer_contract_groups","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_groups"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ajankohtaiset sopimukset\",\n \"description\": \"\",\n \"external_id\": \"645-464-46446-454\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n }\n]"}],"_postman_id":"88b0c250-f15c-47e1-b924-e2acec967b30"},{"name":"/v3/customer_contract_groups/:id","id":"2a62d211-15aa-47a4-b7e7-cac2d25e9c6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_groups/:id","description":"

Get details about a single customer contract group.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contract_groups",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract type UUID

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"f85cc058-c81d-445d-b316-20a81f2a1524","name":"/v3/customer_groups/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_contract_groups/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_contract_groups",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ajankohtaiset sopimukset\",\n \"description\": \"\",\n \"external_id\": \"645-464-46446-454\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n}"}],"_postman_id":"2a62d211-15aa-47a4-b7e7-cac2d25e9c6b"},{"name":"/v3/customer_contract_groups","id":"5670b927-d13c-4038-835c-365e43a04943","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_contract_group\": {\n \"name\": \"Tulevat sopimukset\", // required\n \"description\": \"\",\n \"external_id\": \"993933-4334-334-333222\",\n \"customer_contract_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_groups","description":"

This endpoint allows you to add a new customer contract group.

\n

Only accessible for integration users.

\n

Request Body

\n\n

Other fields are optional.

\n","urlObject":{"path":["api","v3","customer_contract_groups"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"5e7a202a-4860-45f2-b124-366ab74b4f10","name":"/v3/customer_contract_groups","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_contract_group\": {\r\n \"name\": \"Tulevat sopimukset\",\r\n \"description\": \"\",\r\n \"external_id\": \"993933-4334-334-333222\",\r\n \"customer_contract_ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_groups"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tulevat sopimukset\",\n \"description\": \"\",\n \"external_id\": \"993933-4334-334-333222\",\n \"created_at\": \"2025-10-02T14:13:41.471+03:00\",\n \"updated_at\": \"2025-10-02T16:12:01.276+03:00\",\n \"customer_contracts\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"438942932\"\n }\n ]\n}"}],"_postman_id":"5670b927-d13c-4038-835c-365e43a04943"}],"id":"9953843f-6fdb-4636-8deb-07cda755c58a","description":"

All endpoints are only available for integration users.

\n","_postman_id":"9953843f-6fdb-4636-8deb-07cda755c58a"},{"name":"Customer Contracts","item":[{"name":"/v3/billing_row_interval_units","id":"af384bff-aeeb-40d1-b6cd-06014a2eacc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/billing_row_interval_units","description":"

Get a list of all options for customer contract billing row row_item_unit_type fields.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","billing_row_interval_units"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"5f3150f7-ade6-44e0-93e1-3aa9cb872af7","name":"/v3/billing_row_interval_units","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/billing_row_interval_units"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n \"hour\",\n \"day\",\n \"week\",\n \"month\",\n \"year\",\n \"pcs\",\n \"unit\",\n \"visit\",\n \"km\",\n \"m\",\n \"device\"\n]"}],"_postman_id":"af384bff-aeeb-40d1-b6cd-06014a2eacc6"},{"name":"/v3/service_settings/default_vat_settings","id":"0b1f9208-937f-4bf3-9aa6-8b8c9254c6ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/service_settings/default_vat_settings","description":"

Returns the global default vat setting value.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","service_settings","default_vat_settings"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"f006b41e-6bd7-469b-bc82-70c0f0ede706","name":"/v3/service_settings/default_vat_settings","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/service_settings/default_vat_settings"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"default_vat\": 25.5\n}"}],"_postman_id":"0b1f9208-937f-4bf3-9aa6-8b8c9254c6ca"},{"name":"/v3/customer_contracts","id":"68773a3e-25f2-4b37-b0eb-3ece170925a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contracts?customer_id=customer_uuid&as=select","description":"

Get a list of all customer contracts.

\n

Send with as=select parameter to return all contracts with only basic fields.

\n

Use customer_id=uuid parameter to return only contracts that belong to the selected customer.

\n

Use q[page]=page_number parameter to return only one page at a time. Without this, all contracts are returned.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contracts"],"host":["api","spotilla","fi"],"query":[{"key":"customer_id","value":"customer_uuid"},{"key":"as","value":"select"},{"disabled":true,"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"23dbbd4c-bb2d-4bcb-b8c3-b3bc626f38d8","name":"/v3/customer_contracts","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contracts"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"contract_number\": \"482389429\",\n \"status\": \"waiting_to_active\",\n \"customer_contract_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_contract_type\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\"\n },\n \"contract_start_date\": \"2026-01-01\",\n \"contract_end_date\": \"2026-12-31\",\n \"create_invoices\": true,\n \"billing_start_date\": \"2026-01-01\",\n \"billing_lead_days\": 0,\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\",\n \"billing_reference\": \"Viitteemme\",\n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_order_number\": \"2932490242\",\n \"billing_notes\": \"Sovittu 2025 Mikon kanssa\",\n \"created_at\": \"2025-12-04T15:26:42.062+02:00\",\n \"updated_at\": \"2025-12-04T15:44:53.004+02:00\",\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Integration user\"\n },\n \"next_invoice_created\": \"2026-01-01\",\n \"create_tasks\": false,\n \"next_task_created\": null,\n \"price_guarantee_until\": \"2026-12-31\",\n \"vendor\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Puutavaratalo\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Tuote 120 (TTR120)\",\n \"additional_details\": \"Vaihdetaan vuosittain\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"55.89\",\n \"number_of_row_items\": 2.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": {\n \"id\": \"9fed4849-2f9d-4a92-868f-dff31c687865\",\n \"name\": \"Tuote 120\",\n \"code\": \"TTR120\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": 10.0,\n \"price_per_row_item\": \"1555.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 7\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"120.0\",\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"10\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 7\",\n \"hierarchy_path\": \"Erityistilat → Tuotantolaitos Siikajärvi → Oy Kunnossapitodemo AB\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n }\n]"}],"_postman_id":"68773a3e-25f2-4b37-b0eb-3ece170925a8"},{"name":"/v3/customer_contracts/:id","id":"a0572c85-367f-4315-aadd-200e268ab050","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contracts/:id","description":"

Get details about a single customer contract.

\n

You can send the contracts uuid or contract_number as id parameter.

\n

Only accessible for integration users.

\n","urlObject":{"path":["api","v3","customer_contracts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract UUID

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"f055dc76-261d-46ec-856d-842aed4e2cfb","name":"/v3/customer_contracts/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_contracts/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_contracts",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer contract UUID OR contract_number"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"contract_number\": \"482389429\",\n \"status\": \"waiting_to_active\",\n \"customer_contract_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_contract_type\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\"\n },\n \"contract_start_date\": \"2026-01-01\",\n \"contract_end_date\": \"2026-12-31\",\n \"create_invoices\": true,\n \"billing_start_date\": \"2026-01-01\",\n \"billing_lead_days\": 0,\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\",\n \"billing_reference\": \"Viitteemme\",\n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_order_number\": \"2932490242\",\n \"billing_notes\": \"Sovittu 2025 Mikon kanssa\",\n \"created_at\": \"2025-12-04T15:26:42.062+02:00\",\n \"updated_at\": \"2025-12-04T15:44:53.004+02:00\",\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Integration user\"\n },\n \"next_invoice_created\": \"2026-01-01\",\n \"create_tasks\": false,\n \"next_task_created\": null,\n \"price_guarantee_until\": \"2026-12-31\",\n \"vendor\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Puutavaratalo\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Tuote 120 (TTR120)\",\n \"additional_details\": \"Vaihdetaan vuosittain\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"55.89\",\n \"number_of_row_items\": 2.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"10\",\n \"spot\": null,\n \"product\": {\n \"id\": \"9fed4849-2f9d-4a92-868f-dff31c687865\",\n \"name\": \"Tuote 120\",\n \"code\": \"TTR120\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": 10.0,\n \"price_per_row_item\": \"1555.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 7\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"120.0\",\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 7\",\n \"hierarchy_path\": \"Erityistilat → Tuotantolaitos Siikajärvi → Oy Kunnossapitodemo AB\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n }"}],"_postman_id":"a0572c85-367f-4315-aadd-200e268ab050"},{"name":"/v3/customer_contracts","id":"69605e6f-8430-40b3-ada2-ab70ccd58ad1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_contract\": {\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"contract_number\": \"482389429\", \n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_contract_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_contract_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contract_start_date\": \"01.01.2026\", \n \"contract_end_date\": \"\",\n \"create_invoices\": true, \n \"billing_start_date\": \"01.01.2026\", \n \"billing_lead_days\": 0, \n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\", \n \"billing_reference\": \"Viitteemme\", \n \"billing_order_number\": \"2932490242\", \n \"billing_notes\": \"Sovittu 2024 Mikon kanssa\",\n \"vendor_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"price_guarantee_until\": \"01.06.2026\",\n \"customer_contract_billing_rows_attributes\": [\n {\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": 120,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Laite 2\",\n \"discount_percentage\": 10,\n \"price_per_row_item\": 1000,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"customer_sales_account_id\": \"\"\n },\n {\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Vaihto vuosittain\",\n \"discount_percentage\": \"\",\n \"price_per_row_item\": 55.89,\n \"number_of_row_items\": 2,\n \"row_item_interval\": 1,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"0\",\n \"customer_sales_account_id\": \"\"\n },\n {\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"price_per_row_item\": 150,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 1,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"10\",\n \"customer_sales_account_id\": \"\"\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contracts ","description":"

This endpoint allows you to add a new customer contract.

\n

Only accessible for integration users.

\n

Request Body

\n\n

If you want to create CustomerContractInvoices automatically, fill all these fields, otherwise don't send them at all or send them as null values:

\n\n

If you want to set alternate_billing_info to true, all these string fields needs to be filled:

\n\n

Other fields are optional.

\n","urlObject":{"path":["api","v3","customer_contracts "],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"6cc3e6c0-eef7-4fd5-ba70-ffa716248e8b","name":"/v3/customer_contracts","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_contract\": {\r\n \"name\": \"Sopimus 2026\",\r\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\r\n \"contract_number\": \"482389429\", \r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_contract_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_contract_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"contract_start_date\": \"01.01.2026\", \r\n \"contract_end_date\": \"\",\r\n \"create_invoices\": true, \r\n \"billing_start_date\": \"01.01.2026\", \r\n \"billing_lead_days\": 0, \r\n \"billing_lead_interval_block\": \"months\",\r\n \"exact_billing_create_day\": \"31\",\r\n \"billing_interval_number\": 6,\r\n \"billing_interval_block\": \"months\", \r\n \"billing_reference\": \"Viitteemme\", \r\n \"billing_order_number\": \"2932490242\", \r\n \"billing_notes\": \"Sovittu 2024 Mikon kanssa\",\r\n \"vendor_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"price_guarantee_until\": \"01.06.2026\",\r\n \"customer_contract_billing_rows_attributes\": [\r\n {\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Laite 1\",\r\n \"discount_percentage\": null,\r\n \"price_per_row_item\": 120,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 6,\r\n \"row_item_unit_type\": \"device\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Laite 2\",\r\n \"discount_percentage\": 10,\r\n \"price_per_row_item\": 1000,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 6,\r\n \"row_item_unit_type\": \"device\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"\"\r\n },\r\n {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Vaihto vuosittain\",\r\n \"discount_percentage\": \"\",\r\n \"price_per_row_item\": 55.89,\r\n \"number_of_row_items\": 2,\r\n \"row_item_interval\": 1,\r\n \"row_item_unit_type\": \"pcs\",\r\n \"vat_percentage\": \"10\",\r\n \"customer_sales_account_id\": \"\"\r\n },\r\n {\r\n \"row_item_label\": \"Lisätyö\",\r\n \"additional_details\": \"Sovittu Mikon kanssa\",\r\n \"price_per_row_item\": 150,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 1,\r\n \"row_item_unit_type\": \"hour\",\r\n \"customer_sales_account_id\": \"\"\r\n }\r\n ],\r\n \"alternate_billing_info\": true,\r\n \"billing_address\": \"Example road 342\",\r\n \"billing_postcode\": \"02320\",\r\n \"billing_city\": \"Espoo\",\r\n \"billing_country\": \"FI\",\r\n \"billing_invoicing_email\": \"info@email.fi\",\r\n \"billing_e_invoice_address\": \"382904298\",\r\n \"billing_operator\": \"003721291126\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contracts"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"contract_number\": \"482389429\",\n \"status\": \"waiting_to_active\",\n \"customer_contract_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_contract_type\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\"\n },\n \"contract_start_date\": \"2026-01-01\",\n \"contract_end_date\": \"2026-12-31\",\n \"create_invoices\": true,\n \"billing_start_date\": \"2026-01-01\",\n \"billing_lead_days\": 0,\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\",\n \"billing_reference\": \"Viitteemme\",\n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_order_number\": \"2932490242\",\n \"billing_notes\": \"Sovittu 2025 Mikon kanssa\",\n \"created_at\": \"2025-12-04T15:26:42.062+02:00\",\n \"updated_at\": \"2025-12-04T15:44:53.004+02:00\",\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Integration user\"\n },\n \"next_invoice_created\": \"2026-01-01\",\n \"create_tasks\": false,\n \"next_task_created\": null,\n \"price_guarantee_until\": \"2026-12-31\",\n \"vendor\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Puutavaratalo\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Tuote 120 (TTR120)\",\n \"additional_details\": \"Vaihdetaan vuosittain\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"55.89\",\n \"number_of_row_items\": 2.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"10\",\n \"spot\": null,\n \"product\": {\n \"id\": \"9fed4849-2f9d-4a92-868f-dff31c687865\",\n \"name\": \"Tuote 120\",\n \"code\": \"TTR120\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": 10.0,\n \"price_per_row_item\": \"1555.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 7\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"120.0\",\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 7\",\n \"hierarchy_path\": \"Erityistilat → Tuotantolaitos Siikajärvi → Oy Kunnossapitodemo AB\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n }"}],"_postman_id":"69605e6f-8430-40b3-ada2-ab70ccd58ad1"},{"name":"/v3/customer_contracts/:id","id":"88669349-413f-4312-9e39-1410fa82cb8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_contract\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"contract_number\": \"482389429\", \n \"customer_contract_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_contract_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"contract_start_date\": \"01.01.2026\", \n \"contract_end_date\": \"\",\n \"create_invoices\": true, \n \"billing_start_date\": \"01.01.2026\", \n \"billing_lead_days\": 0, \n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\", \n \"billing_reference\": \"Viitteemme\", \n \"billing_order_number\": \"2932490242\", \n \"billing_notes\": \"Sovittu 2024 Mikon kanssa\",\n \"vendor_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"price_guarantee_until\": \"01.06.2026\",\n \"customer_contract_billing_rows_attributes\": [\n // examples for deleting or updating row\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"_destroy\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"price_per_row_item\": 1000,\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": 10,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n // examples for adding new row\n {\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": 120,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Laite 2\",\n \"discount_percentage\": 10,\n \"price_per_row_item\": 1000,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"0\",\n \"customer_sales_account_id\": \"\"\n },\n {\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"additional_details\": \"Vaihto vuosittain\",\n \"discount_percentage\": \"\",\n \"price_per_row_item\": 55.89,\n \"number_of_row_items\": 2,\n \"row_item_interval\": 1,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"10\",\n \"customer_sales_account_id\": \"\"\n },\n {\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"price_per_row_item\": 150,\n \"number_of_row_items\": 1,\n \"row_item_interval\": 1,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"10\",\n \"customer_sales_account_id\": \"\"\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contracts/:id","description":"

This endpoint allows you to update customer contract.

\n

Only accessible for integration users.

\n

You can send the uuid or contract_number as id parameter.

\n

Request Body

\n\n

If you want to create CustomerContractInvoices automatically, fill all these fields:

\n\n

If you want to set alternate_billing_info to true, all these string fields needs to be filled:

\n\n

Other fields are optional.

\n","urlObject":{"path":["api","v3","customer_contracts",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract id or contract_number

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[{"id":"9c1ef9ac-1dce-4827-ad76-9914f9984ac8","name":"/v3/customer_contracts","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_contract\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Sopimus 2026\",\r\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\r\n \"contract_number\": \"482389429\", \r\n \"customer_contract_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_contract_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"contract_start_date\": \"01.01.2026\", \r\n \"contract_end_date\": \"\",\r\n \"create_invoices\": true, \r\n \"billing_start_date\": \"01.01.2026\", \r\n \"billing_lead_days\": 0, \r\n \"billing_lead_interval_block\": \"months\",\r\n \"exact_billing_create_day\": \"31\",\r\n \"billing_interval_number\": 6,\r\n \"billing_interval_block\": \"months\", \r\n \"billing_reference\": \"Viitteemme\", \r\n \"billing_order_number\": \"2932490242\", \r\n \"billing_notes\": \"Sovittu 2024 Mikon kanssa\",\r\n \"vendor_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"price_guarantee_until\": \"01.06.2026\",\r\n \"customer_contract_billing_rows_attributes\": [\r\n // examples for deleting or updating row\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"_destroy\": 1\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"price_per_row_item\": 1000,\r\n \"additional_details\": \"Laite 1\",\r\n \"discount_percentage\": 10,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 6,\r\n \"row_item_unit_type\": \"device\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n // examples for adding new row\r\n {\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Laite 1\",\r\n \"discount_percentage\": null,\r\n \"price_per_row_item\": 120,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 6,\r\n \"row_item_unit_type\": \"device\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Laite 2\",\r\n \"discount_percentage\": 10,\r\n \"price_per_row_item\": 1000,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 6,\r\n \"row_item_unit_type\": \"device\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"\"\r\n },\r\n {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_details\": \"Vaihto vuosittain\",\r\n \"discount_percentage\": \"\",\r\n \"price_per_row_item\": 55.89,\r\n \"number_of_row_items\": 2,\r\n \"row_item_interval\": 1,\r\n \"row_item_unit_type\": \"pcs\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"\"\r\n },\r\n {\r\n \"row_item_label\": \"Lisätyö\",\r\n \"additional_details\": \"Sovittu Mikon kanssa\",\r\n \"price_per_row_item\": 150,\r\n \"number_of_row_items\": 1,\r\n \"row_item_interval\": 1,\r\n \"row_item_unit_type\": \"hour\",\r\n \"vat_percentage\": \"25.5\",\r\n \"customer_sales_account_id\": \"\"\r\n }\r\n ],\r\n \"alternate_billing_info\": true,\r\n \"billing_address\": \"Example road 342\",\r\n \"billing_postcode\": \"02320\",\r\n \"billing_city\": \"Espoo\",\r\n \"billing_country\": \"FI\",\r\n \"billing_invoicing_email\": \"info@email.fi\",\r\n \"billing_e_invoice_address\": \"382904298\",\r\n \"billing_operator\": \"003721291126\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/customer_contracts/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_contracts",":id"],"variable":[{"key":"id","value":""}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"contract_number\": \"482389429\",\n \"status\": \"waiting_to_active\",\n \"customer_contract_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_contract_type\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\"\n },\n \"contract_start_date\": \"2026-01-01\",\n \"contract_end_date\": \"2026-12-31\",\n \"create_invoices\": true,\n \"billing_start_date\": \"2026-01-01\",\n \"billing_lead_days\": 0,\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\",\n \"billing_reference\": \"Viitteemme\",\n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_order_number\": \"2932490242\",\n \"billing_notes\": \"Sovittu 2025 Mikon kanssa\",\n \"created_at\": \"2025-12-04T15:26:42.062+02:00\",\n \"updated_at\": \"2025-12-04T15:44:53.004+02:00\",\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Integration user\"\n },\n \"next_invoice_created\": \"2026-01-01\",\n \"create_tasks\": false,\n \"next_task_created\": null,\n \"price_guarantee_until\": \"2026-12-31\",\n \"vendor\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Puutavaratalo\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Tuote 120 (TTR120)\",\n \"additional_details\": \"Vaihdetaan vuosittain\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"55.89\",\n \"number_of_row_items\": 2.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": {\n \"id\": \"9fed4849-2f9d-4a92-868f-dff31c687865\",\n \"name\": \"Tuote 120\",\n \"code\": \"TTR120\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": 10.0,\n \"price_per_row_item\": \"1555.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"vat_percentage\": \"25.5\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 7\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"120.0\",\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"vat_percentage\": \"25.5\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 7\",\n \"hierarchy_path\": \"Erityistilat → Tuotantolaitos Siikajärvi → Oy Kunnossapitodemo AB\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n}"}],"_postman_id":"88669349-413f-4312-9e39-1410fa82cb8b"},{"name":"/v3/archive_customer_contract/:id","id":"585c85ed-630b-4c2b-854f-0fcaa26fdf24","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/archive_customer_contract/:id","description":"

This endpoint allows you to set customer contract status to be archived.

\n

Only accessible for integration users.

\n

You can send the uuid or contract_number as id parameter.

\n

Request Body

\n

No body needed. Status is only updated to be archived.

\n

Note that after contract status has been switched to be 'archived', you cannot update it anymore.

\n","urlObject":{"path":["api","v3","archive_customer_contract",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract id or contract_number

\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[{"id":"88f328ae-eebf-4db4-ac43-d8e809a9ea5a","name":"/v3/archive_customer_contract/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/archive_customer_contract/:id","host":["api","spotilla","fi"],"path":["api","v3","archive_customer_contract",":id"],"variable":[{"key":"id","value":"","description":"customer contract id or contract_number"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2026\",\n \"description\": \"Vuoden soppari, jatkosta sovitaan myöhemmin\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"contract_number\": \"482389429\",\n \"status\": \"archived\",\n \"customer_contract_group\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"1. Teollisuus\"\n },\n \"customer_contract_type\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimuslaskutus\"\n },\n \"contract_start_date\": \"2026-01-01\",\n \"contract_end_date\": \"2026-12-31\",\n \"create_invoices\": true,\n \"billing_start_date\": \"2026-01-01\",\n \"billing_lead_days\": 0,\n \"billing_interval_number\": 6,\n \"billing_interval_block\": \"months\",\n \"billing_reference\": \"Viitteemme\",\n \"billing_lead_interval_block\": \"months\",\n \"exact_billing_create_day\": \"31\",\n \"billing_order_number\": \"2932490242\",\n \"billing_notes\": \"Sovittu 2025 Mikon kanssa\",\n \"created_at\": \"2025-12-04T15:26:42.062+02:00\",\n \"updated_at\": \"2025-12-04T15:44:53.004+02:00\",\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Integration user\"\n },\n \"next_invoice_created\": \"2026-01-01\",\n \"create_tasks\": false,\n \"next_task_created\": null,\n \"price_guarantee_until\": \"2026-12-31\",\n \"vendor\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Puutavaratalo\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Tuote 120 (TTR120)\",\n \"additional_details\": \"Vaihdetaan vuosittain\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"55.89\",\n \"number_of_row_items\": 2.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"spot\": null,\n \"product\": {\n \"id\": \"9fed4849-2f9d-4a92-868f-dff31c687865\",\n \"name\": \"Tuote 120\",\n \"code\": \"TTR120\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": 10.0,\n \"price_per_row_item\": \"1555.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 7\",\n \"additional_details\": \"Laite 1\",\n \"discount_percentage\": null,\n \"price_per_row_item\": \"120.0\",\n \"number_of_row_items\": 1,\n \"row_item_interval\": 6,\n \"row_item_unit_type\": \"device\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 7\",\n \"hierarchy_path\": \"Erityistilat → Tuotantolaitos Siikajärvi → Oy Kunnossapitodemo AB\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ],\n \"alternate_billing_info\": true,\n \"billing_address\": \"Example road 342\",\n \"billing_postcode\": \"02320\",\n \"billing_city\": \"Espoo\",\n \"billing_country\": \"FI\",\n \"billing_invoicing_email\": \"info@email.fi\",\n \"billing_e_invoice_address\": \"382904298\",\n \"billing_operator\": \"003721291126\"\n}"}],"_postman_id":"585c85ed-630b-4c2b-854f-0fcaa26fdf24"}],"id":"bfa2c3fb-b58d-49b3-a7ce-368744a6f1cc","description":"

All endpoints are only available for integration users.

\n","_postman_id":"bfa2c3fb-b58d-49b3-a7ce-368744a6f1cc"},{"name":"Customer Contract Invoices","item":[{"name":"/v3/customer_contract_invoices","id":"4e032ea1-df7b-4dc5-a788-cc035b86ed61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_invoices?as=with_all_relations&with_status=waiting_to_process&begin_date=26.11.2025&end_date=31.12.2025&without_invoice_number=true","description":"

Get a list of all customer contract invoices (Sopimuslaskut).

\n

Only accessible for integration users.

\n

Parameters that can be used:

\n

as=
Possible options: 'with_basic_relations' (billing rows are not returned but customer and contract are returned). If you use 'with_all_relations', you will also see billing rows. Remove param if you don't want to see any relations.

\n

with_status=

\n

Possible options: 'waiting_to_process' or 'processed'. Remove parameter to get all results no matter what the status is.

\n

begin_date=

\n

Invoice has been created after or on this date

\n

end_date=

\n

Invoice has been created before or on this date

\n

If you don't send begin_date and end_date values, by default, endpoint will return invoices that have been created in the past 15 minutes.

\n

without_invoice_number=

\n

value should be true, if you want to see only invoices that don't have invoice_number. Otherwise all items are returned

\n","urlObject":{"path":["api","v3","customer_contract_invoices"],"host":["api","spotilla","fi"],"query":[{"key":"as","value":"with_all_relations"},{"key":"with_status","value":"waiting_to_process"},{"key":"begin_date","value":"26.11.2025"},{"key":"end_date","value":"31.12.2025"},{"key":"without_invoice_number","value":"true"}],"variable":[]}},"response":[{"id":"c8d390d8-9a52-4d95-9d2f-23dd9d149171","name":"/v3/customer_contract_invoices","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_contract_invoices?as=with_all_relations","host":["api","spotilla","fi"],"path":["api","v3","customer_contract_invoices"],"query":[{"key":"as","value":"with_all_relations"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"invoice_number\": \"1324543\",\n \"status\": \"processed\",\n \"created_at\": \"2025-11-27T12:21:51.114+02:00\",\n \"updated_at\": \"2025-11-27T16:18:04.950+02:00\",\n \"total_value\": \"1108.5\",\n \"discounted_total_value\": \"1104.6\",\n \"payment_term\": \"14 pv netto\",\n \"invoice_due_date\": \"2026-01-01\",\n \"contract_billing_reference\": \"34234232\",\n \"contract_billing_order_number\": \"434242\",\n \"contract_billing_notes\": \"Sovittu vuonna 2024\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"customer_contract\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"2025 Sopimus\",\n \"contract_number\": \"7546466\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": \"20.0\",\n \"price_per_row_item\": \"13.0\",\n \"number_of_row_items\": 1.5,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Kaakeli vihreä\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"45.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"spot\": null,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kaakeli vihreä\",\n \"code\": \"42425\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 3\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"1000.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"device\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 3\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ]\n }\n]"}],"_postman_id":"4e032ea1-df7b-4dc5-a788-cc035b86ed61"},{"name":"/v3/customer_contract_invoices/:id","id":"73da358c-f960-4295-9302-94dd23f6c74f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/customer_contract_invoices/:id","description":"

Get details about a single customer contract invoice.

\n

Only accessible for integration users.

\n

You can send the uuid or invoice_number as id parameter.

\n","urlObject":{"path":["api","v3","customer_contract_invoices",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

customer contract invoice UUID or invoice_number

\n","type":"text/plain"},"type":"any","value":"548s5s-3792-1234-b1fe-ebef8a611a2f","key":"id"}]}},"response":[{"id":"d7fbffa4-6df1-4def-90e1-acb165efa7fc","name":"/v3/customer_contract_invoices/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/customer_contract_invoices/:id","host":["api","spotilla","fi"],"path":["api","v3","customer_contract_invoices",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"customer UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"invoice_number\": \"1324543\",\n \"status\": \"processed\",\n \"created_at\": \"2025-11-27T12:21:51.114+02:00\",\n \"updated_at\": \"2025-11-27T16:18:04.950+02:00\",\n \"total_value\": \"1108.5\",\n \"discounted_total_value\": \"1104.6\",\n \"payment_term\": \"14 pv netto\",\n \"invoice_due_date\": \"2026-01-01\",\n \"contract_billing_reference\": \"34234232\",\n \"contract_billing_order_number\": \"434242\",\n \"contract_billing_notes\": \"Sovittu vuonna 2024\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"customer_contract\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"2025 Sopimus\",\n \"contract_number\": \"7546466\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": \"20.0\",\n \"price_per_row_item\": \"13.0\",\n \"number_of_row_items\": 1.5,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Kaakeli vihreä\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"45.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"spot\": null,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kaakeli vihreä\",\n \"code\": \"42425\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 3\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"1000.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"device\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 3\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ]\n}"}],"_postman_id":"73da358c-f960-4295-9302-94dd23f6c74f"},{"name":"/v3/customer_contract_invoices/:id","id":"4aae852f-4319-4b87-80ee-27851d0e9c40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"customer_contract_invoice\": {\n \"status\": \"processed\",\n \"payment_term\": \"Sopimuksen mukaan\",\n \"invoice_number\": \"232343223\",\n \"invoice_due_date\": \"31.12.2025\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_invoices/:id","description":"

This endpoint allows you to update customer contract invoice.

\n

Only accessible for integration users.

\n

You can send the uuid or invoice_number as id parameter.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","customer_contract_invoices",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"481ddafe-044f-4824-9e4f-0a919517f94c","name":"/v3/customer_contract_invoices/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"customer_contract_invoice\": {\r\n \"status\": \"processed\",\r\n \"payment_term\": \"Sopimuksen mukaan\",\r\n \"invoice_number\": \"232343223\",\r\n \"invoice_due_date\": \"31.12.2025\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/customer_contract_invoices/3468c14f-9512-490c-8d6a-a43e3ed290d2"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"invoice_number\": \"1324543\",\n \"status\": \"processed\",\n \"created_at\": \"2025-11-27T12:21:51.114+02:00\",\n \"updated_at\": \"2025-11-27T16:18:04.950+02:00\",\n \"total_value\": \"1108.5\",\n \"discounted_total_value\": \"1104.6\",\n \"payment_term\": \"14 pv netto\",\n \"invoice_due_date\": \"2026-01-01\",\n \"contract_billing_reference\": \"34234232\",\n \"contract_billing_order_number\": \"434242\",\n \"contract_billing_notes\": \"Sovittu vuonna 2024\",\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven tuotantolaitos Ab\",\n \"customer_number\": \"9988554444\"\n },\n \"customer_contract\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"2025 Sopimus\",\n \"contract_number\": \"7546466\"\n },\n \"customer_contract_billing_rows\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"general_row\",\n \"row_item_label\": \"Lisätyö\",\n \"additional_details\": \"Sovittu Mikon kanssa\",\n \"discount_percentage\": \"20.0\",\n \"price_per_row_item\": \"13.0\",\n \"number_of_row_items\": 1.5,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"hour\",\n \"spot\": null,\n \"product\": null,\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"product_row\",\n \"row_item_label\": \"Kaakeli vihreä\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"45.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"pcs\",\n \"spot\": null,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kaakeli vihreä\",\n \"code\": \"42425\"\n },\n \"customer_sales_account\": null\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"row_type\": \"spot_row\",\n \"row_item_label\": \"Erityistila 3\",\n \"additional_details\": null,\n \"discount_percentage\": null,\n \"price_per_row_item\": \"1000.0\",\n \"number_of_row_items\": 1.0,\n \"row_item_interval\": 1.0,\n \"row_item_unit_type\": \"device\",\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistila 3\",\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erityistilat\"\n }\n },\n \"product\": null,\n \"customer_sales_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yleinen myyntitili\",\n \"account_number\": \"3100\"\n }\n }\n ]\n}"}],"_postman_id":"4aae852f-4319-4b87-80ee-27851d0e9c40"}],"id":"08475a6b-8584-4503-b855-89280fce0e11","description":"

All endpoints are only available for integration users.

\n","_postman_id":"08475a6b-8584-4503-b855-89280fce0e11"}],"id":"a14d18b3-28d3-4232-afc3-7803f6648dd2","_postman_id":"a14d18b3-28d3-4232-afc3-7803f6648dd2","description":""},{"name":"Work Orders","item":[{"name":"/v3/work_orders","id":"c2aec9c8-7d8a-4db8-94eb-d249d16771bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/work_orders","description":"

Get a list of work orders the user has permission to access.

\n

Data includes:

\n\n","urlObject":{"path":["api","v3","work_orders"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"e95bbfee-fe9a-4cf5-9e7b-f30e0efdb571","name":"/v3/work_orders","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/work_orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"A0\",\r\n \"name\": \"Work Order0\",\r\n \"description\": null,\r\n \"instructions\": \"Instructions for Work Order\",\r\n \"status\": \"open\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_name\": \"Seclion\",\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 1,\r\n \"upload_items\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"video/mp4\",\r\n \"created_at\": \"2023-06-30T11:47:12.177+03:00\",\r\n \"header\": \"forgive_me_father_i_have_sinned.mp420230315-8-18quidx.mp4\",\r\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/assets/video_example.png\",\r\n \"url\": \"https://api.dev.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task\": null\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"A1\",\r\n \"name\": \"Work Order1\",\r\n \"description\": null,\r\n \"instructions\": \"Instructions for Work Order\",\r\n \"status\": \"open\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_name\": \"Atmotics\",\r\n \"open_tasks\": 1,\r\n \"complete_tasks\": 1,\r\n \"upload_items\": []\r\n }\r\n]"}],"_postman_id":"c2aec9c8-7d8a-4db8-94eb-d249d16771bf"},{"name":"/v3/work_orders","id":"82ab7e9e-3395-46b6-b306-3c40fd760913","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","description":"

uuid of the special account

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"work_order\": {\n \"wo_number\": \"20250429\", // Required field, needs to be unique. \n \"name\": \"test create work order x3\", // Required field\n \"description\": \"test creation endpoint\",\n \"begin_date\": \"2024-05-31T07:59:59.999+02:00\",\n \"end_date\": \"2025-05-31T08:59:59.999+02:00\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // customer UUID, optional\n \"status\": \"open\", // options for this field: \"closed\", \"open\"\n \"task_ids\": [ // optional\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // task UUID\n ]\n\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/work_orders","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint allows you to create a new work order.

\n

Request Body

\n

Required fields:

\n\n

Optional fields:

\n\n","urlObject":{"path":["api","v3","work_orders"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"40e2868f-d8f7-470e-a10c-9748f41fff63","name":"/v3/work_orders","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"work_order\": {\n \"wo_number\": \"20250429\",\n \"name\": \"work_order name\",\n \"description\": \"work_order description\",\n \"begin_date\": \"2024-05-31T07:59:59.999+02:00\",\n \"end_date\": \"2025-05-31T08:59:59.999+02:00\",\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"status\": \"open\",\n \"task_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ]\n\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/work_orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"20250429\",\r\n \"name\": \"work_order name\",\r\n \"description\": \"work_order description\",\r\n \"instructions\": \"Instructions for Work Order\",\r\n \"status\": \"open\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_name\": \"VIP customer\",\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"upload_items\": []\r\n}"}],"_postman_id":"82ab7e9e-3395-46b6-b306-3c40fd760913"},{"name":"/v3/work_orders/:id","id":"c15577f1-2e98-4462-9532-8c6f650717de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","description":"

uuid of the special account

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same tenancy as is used in login request

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"work_order\": {\n \"wo_number\": \"20250512\",\n \"name\": \"work order x2\",\n \"description\": \"test creation endpoint\",\n \"begin_date\": \"2024-05-31T07:59:59.999+02:00\",\n \"end_date\": \"2025-05-31T08:59:59.999+02:00\",\n \"customer_id\": ae68c14f-9512-490c-8d6a-a43e3ed290d2,\n \"status\": \"closed\",\n \"task_ids\": [ // Do not send this key at all unless you know what you are doing\n \"51b4c46c-338d-46a6-bab7-18ad5e27baa2\"\n ]\n\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/work_orders/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

The API endpoint sends a PATCH request to update a specific work order by its UUID.

\n

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n\n","urlObject":{"path":["api","v3","work_orders",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"02ec0ca1-1f05-4894-b425-803553c9bfb1","name":"/v3/work_orders","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"UUID of the target work order","type":"text"}],"body":{"mode":"raw","raw":"{\n \"work_order\": {\n \"wo_number\": \"20250512\",\n \"name\": \"work order x2\",\n \"description\": \"test creation endpoint\",\n \"begin_date\": \"2024-05-31T07:59:59.999+02:00\",\n \"end_date\": \"2025-05-31T08:59:59.999+02:00\",\n \"customer_id\": ae68c14f-9512-490c-8d6a-a43e3ed290d2,\n \"status\": \"closed\",\n \"task_ids\": [ // Do not send this key at all unless you know what you are doing\n \"51b4c46c-338d-46a6-bab7-18ad5e27baa2\"\n ]\n\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/work_orders/:id","host":["api","spotilla","fi"],"path":["api","v3","work_orders",":id"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"20250512\",\r\n \"name\": \"work order x2\",\r\n \"description\": \"test creation endpoint\",\r\n \"instructions\": \"Instructions for Work Order\",\r\n \"status\": \"closed\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_name\": \"VIP customer\",\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"upload_items\": []\r\n}"}],"_postman_id":"c15577f1-2e98-4462-9532-8c6f650717de"},{"name":"/v3/work_orders/:id","id":"607157d2-4447-4cd1-a6ab-29f8ff4f5583","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/work_orders/:id","description":"

This endpoint retrieves the details of a single work order.

\n

Details include:

\n\n","urlObject":{"path":["api","v3","work_orders",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

work order UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"931c17c0-4af5-436f-86cc-65176e1a1179","name":"/v3/work_orders/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/work_orders/:id","host":["api","spotilla","fi"],"path":["api","v3","work_orders",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"work order UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"A0\",\r\n \"name\": \"Work Order0\",\r\n \"description\": null,\r\n \"instructions\": \"Instructions for Work Order\",\r\n \"status\": \"open\",\r\n \"customer_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"customer_name\": \"Seclion\",\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 1,\r\n \"upload_items\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"video/mp4\",\r\n \"created_at\": \"2023-06-30T11:47:12.177+03:00\",\r\n \"header\": \"forgive_me_father_i_have_sinned.mp420230315-8-18quidx.mp4\",\r\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/assets/video_example.png\",\r\n \"url\": \"https://api.dev.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task\": null\r\n }\r\n ]\r\n}"}],"_postman_id":"607157d2-4447-4cd1-a6ab-29f8ff4f5583"}],"id":"024f408f-dfd3-4edd-bf4f-13e896f3f50f","_postman_id":"024f408f-dfd3-4edd-bf4f-13e896f3f50f","description":""},{"name":"Tasks","item":[{"name":"Tasks","item":[{"name":"/v3/tasks/:id","id":"25c15612-e768-4f54-a7ea-884d23c10fc7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tasks/:id","description":"

Get Task Details

\n

This endpoint retrieves details of a single task including basic information, task workers, and task comments.

\n

Request Body

\n

This is a GET request and does not require a request body.

\n","urlObject":{"path":["api","v3","tasks",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"2a31c7ac-5125-4287-93be-91d68894fdb4","name":"/v3/tasks/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2023-08-23T01:00:00.000+03:00\",\n \"task_heading\": \"a-Limited permission test\",\n \"task_description\": \"a-Limited permission test\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"late\",\n \"updated_by\": \"david.test@domain.dom\",\n \"updated_by_name\": \"David Tester\",\n \"completion_remarks\": null,\n \"completion_date\": null,\n \"created_at\": \"2023-08-22T12:53:31.131+03:00\",\n \"updated_at\": \"2023-10-22T13:15:14.968+03:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"apuaaaa\",\n \"spot_parent_hierarchies\": [\n \"rootti\"\n ],\n \"surface_number\": null,\n \"responsible_type\": \"MobileUserRole\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"A Mobile-test permission\",\n \"original_task_id\": null,\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"in_progress_at\": null,\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [],\n \"customer\": null,\n \"order_num\": \"\",\n \"internal_reference\": \"\",\n \"external_reference\": \"\",\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserRole\",\n \"role_type\": \"MobileUserRole\",\n \"worker_name\": \"A Mobile-test permission\",\n \"task_resources\": []\n }\n ],\n \"role_id_for_workers\": null,\n \"worker_responsible_type\": \"UserRole\",\n \"work_order\": null,\n \"task_template\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"a-Limited permission test\",\n \"description\": \"a-Limited permission test\"\n },\n \"task_resource_settings\": {\n \"edit_due_date\": true,\n \"manage_resourcing\": true,\n \"manage_workers\": true,\n \"edit_own_resourcing\": true\n },\n \"read_only\": false,\n \"comments\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"hello from postman\",\n \"created_at\": \"2023-10-19T13:04:18.092+03:00\",\n \"authorizable\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"test manager\"\n },\n \"can_edit\": true\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"comment from admin user\",\n \"created_at\": \"2023-10-19T10:34:45.615+03:00\",\n \"authorizable\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"test admin\"\n },\n \"can_edit\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"mobile user can update its own comment\",\n \"created_at\": \"2023-10-18T14:37:02.221+03:00\",\n \"authorizable\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"test manager\"\n },\n \"can_edit\": true\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"comment's can_edit is true && permission to the task's spot && responsible worker of the task\",\n \"created_at\": \"2023-10-18T13:55:53.584+03:00\",\n \"authorizable\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"test manager\"\n },\n \"can_edit\": true\n }\n ],\n \"log_entries\": [],\n \"in_progress_by\": null,\n \"in_progress_by_current_user\": false,\n \"service_request\": null,\n \"sales_order_number\": \"3940-30d932\",\n \"route_task\": false,\n \"route_counts\": null,\n \"all_routes_ready\": true,\n \"require_machine_hours\": false,\n \"current_machine_hours\": null,\n \"task_category_tags\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"tagi-tagi\",\n \"default_locale\": \"fi\",\n \"icon\": \"icons/Automatic.svg\",\n \"category_tag_languages\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"se\",\n \"name\": \"taggar-1 api\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"fi\",\n \"name\": \"tagi-tagi\"\n }\n ]\n }\n ],\n \"billable_task\": false,\n \"all_ongoing_logs\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"begin_time\": \"2023-03-14T10:57:27.514+02:00\",\n \"end_time\": null,\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Esimerkki Mallikas\"\n }\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"begin_time\": \"2023-03-14T10:50:27.514+02:00\",\n \"end_time\": null,\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Erkki Esimerkki\"\n }\n }\n ],\n \"signature_status\": 2, // status code explanation: 0 -> no pending signature; 1 -> all of the inherited signatures are signed; 2 -> all of the direct signatures are signed; 3 -> there are pending signatures\n \"inherited_signature_templates\": false // if true: this task has inherited pending signatures from its task template; if false: this task has no inherited pending signatures from task template\n}"}],"_postman_id":"25c15612-e768-4f54-a7ea-884d23c10fc7"},{"name":"/v3/tasks/:id/complete","id":"6ed0d470-c926-421a-b3c6-ed3065ef9dfb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"status\": \"completed\",\r\n \"completion_remarks\": \"complelte this task\" // optional params\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:id/complete","description":"

Complete a task that user has permission

\n

Optional params:

\n\n

Required params:

\n\n","urlObject":{"path":["api","v3","tasks",":id","complete"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"f40e8b75-a962-48bd-b50e-f354bdb1c64b","name":"/v3/tasks/:id/complete","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"sRFE-pNPCMCy4zV6vAHU","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"status\": \"completed\",\r\n \"completion_remarks\": \"\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id/complete","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id","complete"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}]}},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2022-02-02T01:00:00.000+02:00\",\n \"task_heading\": \"Siilon jälkitarkastus\",\n \"task_description\": \"aistinvarainen tarkastus korjaustoimenpiteiden jälkeen\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"completed\",\n \"updated_by\": \"{{rand_email}}\",\n \"updated_by_name\": \"{{rand_name}}\",\n \"completion_remarks\": null,\n \"completion_date\": \"2022-02-01T14:49:22.598+02:00\",\n \"created_at\": \"2022-02-01T14:09:32.596+02:00\",\n \"updated_at\": \"2022-02-01T14:49:22.614+02:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Betonisiilo 35\",\n \"spot_parent_hierarchies\": [\n \"Kiinteistötekniikka → Betoniasema Lahti → Laitokset → Oy Kunnossapitodemo AB \"\n ],\n \"surface_number\": null,\n \"responsible_type\": \"User\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"{{rand_name}}\",\n \"original_task_id\": null,\n \"completed_by_name\": \"{{rand_name}}\",\n \"task_sections\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_at\": \"2022-02-01T15:39:00.000+02:00\",\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"created_at\": \"2022-02-01T13:34:02.480+02:00\",\n \"updated_at\": \"2022-02-01T13:44:07.042+02:00\"\n }\n ],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": true,\n \"log_entries\": [],\n \"comments\": [],\n \"in_progress_by\": null,\n \"in_progress_at\": null,\n \"in_progress_by_current_user\": false,\n \"task_products\": [],\n \"service_request\": null,\n \"work_order\": null,\n \"order_num\": \"\",\n \"internal_reference\": \"\",\n \"external_reference\": \"\",\n \"billable_task\": false\n}"}],"_postman_id":"6ed0d470-c926-421a-b3c6-ed3065ef9dfb"},{"name":"/v3/tasks/:id","id":"23b7b572-5b31-4f8f-b33e-1f0c54815764","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"due_date\": \"2024-08-03T01:00:00.000+03:00\",\r\n \"status\": \"active\",\r\n \"task_sections\": [],//?\r\n \"spent_hours\": \"3600\", // give as seconds\r\n \"planned_duration\": \"7200\",\r\n \"planned_start\": \"01.01.2024\",\r\n \"planned_end\": \"01.01.2024\",\r\n \"running_machine_hours\": 5000.5,\r\n \"sales_order_number\": \"3940-49283\",\r\n \"billable_task\": true, // optional parameter, default value is false\r\n \"comments_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"comment\": \"This is the comment.\",\r\n \"comment_type\": \"Task\",\r\n \"authorizable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"authorizable_type\": \"User\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"task_products_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": \"4\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"file_base\": \"data:image/png;base64,...\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Description of the file\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"workers_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"workable_type\": \"UserAccount\",\r\n \"_destroy\": \"1\", // or \"true\"; only pass this and id if destroying\r\n \"task_resources_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"start_time\": \"2024-08-03T00:00:00.000+03:00\",\r\n \"end_time\": \"2024-08-03T01:00:00.000+03:00\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n } \r\n ]\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the task template has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from an external user\r\n ],\r\n \"task_category_tags_attributes\": [\r\n {\"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"_destroy\": 1}, // example for removing a category tag from the task\r\n {\"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"} // example for attaching a category tag to the task\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:id","description":"

When PATCHing, you can leave out unchanged fields.

\n","urlObject":{"path":["api","v3","tasks",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"56f9dd33-3bee-419d-bf0d-24893c859dd6","name":"/v3/tasks/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"due_date\": \"2024-08-03T01:00:00.000+03:00\",\r\n \"status\": \"active\",\r\n \"task_sections\": [],//?\r\n \"spent_hours\": \"3600\", // give as seconds\r\n \"planned_duration\": \"7200\",\r\n \"planned_start\": \"01.01.2024\",\r\n \"planned_end\": \"01.01.2024\",\r\n \"running_machine_hours\": 5000.5,\r\n \"sales_order_number\": \"3940-49283\",\r\n \"billable_task\": true, // optional parameter, default value is false\r\n \"comments_attributes\": [\r\n {\r\n \"id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\", // do not pass when creating\r\n \"comment\": \"This is the comment.\",\r\n \"comment_type\": \"Task\",\r\n \"authorizable_id\": \"852e0ff8-51be-49c2-adc9-4bcc48e05036\",\r\n \"authorizable_type\": \"User\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"task_products_attributes\": [\r\n {\r\n \"id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\", // do not pass when creating\r\n \"product_id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\",\r\n \"warehouse_id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\",\r\n \"warehouse_slot_id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\",\r\n \"number_of_products\": \"4\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"id\": \"f829ea33-abcd-hijk-ac97-ece67986f6a9\", // do not pass when creating\r\n \"file_base\": \"data:image/png;base64,...\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Description of the file\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n }\r\n ],\r\n \"workers_attributes\": [\r\n {\r\n \"id\": \"f938f5c2-1234-abcd-b4b7-982f61ff6449\", // do not pass when creating\r\n \"workable_id\": \"6e1083c8-4321-defg-f235260e9a5c\",\r\n \"workable_type\": \"UserAccount\",\r\n \"_destroy\": \"1\", // or \"true\"; only pass this and id if destroying\r\n \"task_resources_attributes\": [\r\n {\r\n \"id\": \"e9b41b26-6543-3210-b421-2e581c70a9e0\", // do not pass when creating\r\n \"start_time\": \"2024-08-03T00:00:00.000+03:00\",\r\n \"end_time\": \"2024-08-03T01:00:00.000+03:00\",\r\n \"_destroy\": \"1\" // or \"true\"; only pass this and id if destroying\r\n } \r\n ]\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the task template has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from a external user\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2020-06-29T22:00:00.000Z\",\n \"task_heading\": \"Testitehtäbä\",\n \"task_description\": \"null end\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"completed\",\n \"updated_by\": \"{{rand_email}}\",\n \"updated_by_name\": \"Mikko Mallikas\",\n \"completion_remarks\": \"\",\n \"completion_date\": \"2020-07-20T22:00:00.000Z\",\n \"created_at\": \"2020-06-30T08:47:29.644Z\",\n \"updated_at\": \"2020-07-21T08:15:38.982Z\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Abloy SAFEA Turvaverkkopääte\",\n \"spot_parent_hierarchies\": [\n \"Stenlundin Rahtiterminaali → Espoo → Kiinteistöt\"\n ],\n \"surface_number\": null,\n \"responsible_type\": \"MobileUserRole\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"Mobile\",\n \"original_task_id\": null,\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": \"2020-06-29T21:00:00.000Z\",\n \"planned_end\": null,\n \"planned_duration\": 120,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"log_entries\": [],\n \"comments\": [],\n \"in_progress_by\": null,\n \"in_progress_by_current_user\": false,\n \"task_products\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"number_of_products\": 2,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tuote\",\n \"code\": \"A12\",\n \"manufacturer\": \"\",\n \"length\": null,\n \"width\": null,\n \"height\": null,\n \"weight\": null,\n \"measure_unit\": null,\n \"price\": null,\n \"selling_price\": null,\n \"reservation_price_euro\": null,\n \"reservation_price_cent\": null,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": null,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Testituotteet\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Varasto A\",\n \"amount\": 15\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kakkosvarasto\",\n \"amount\": 5\n }\n ],\n \"created_at\": \"2021-03-12T12:42:10.218Z\",\n \"updated_at\": \"2021-03-12T12:42:10.218Z\"\n }\n }\n ],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [],\n \"customer\": null,\n \"order_num\": \"\",\n \"internal_reference\": \"\",\n \"external_reference\": \"\",\n \"service_request\": null,\n \"work_order\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärven Toimeksiannot\",\n \"wo_number\": \"AB12342\"\n },\n \"sales_order_number\": \"sales-order-number-example\",\n \"route_task\": false,\n \"route_counts\": null,\n \"all_routes_ready\": true,\n \"require_machine_hours\": true,\n \"current_machine_hours\": 5000.5,\n \"billable_task\": false\n}"}],"_postman_id":"23b7b572-5b31-4f8f-b33e-1f0c54815764"},{"name":"/v3/tasks/:task_id/comments/:id","id":"3b448900-6045-4e02-adb9-e63b91b0f33b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"this is a commment\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:task_id/comments/:id","description":"

Update the content of a task comment that user has permission

\n","urlObject":{"path":["api","v3","tasks",":task_id","comments",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"task_id"},{"description":{"content":"

comment UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"d384662d-d1dd-4c9b-b42b-7a05cb026858","name":"/v3/tasks/:task_id/comments/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"this is a commment\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:task_id/comments/:id","host":["api","spotilla","fi"],"path":["api","v3","tasks",":task_id","comments",":id"],"variable":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"comment UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"this is a commment\",\n \"authorizable_type\": \"User\",\n \"authorizable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"commentable_type\": \"Task\",\n \"commentable_id\": \"ab01-bb65-4011-98da-04f2647e\",\n \"created_at\": \"2023-10-18T15:00:44.035+03:00\",\n \"updated_at\": \"2023-10-18T16:29:27.430+03:00\",\n \"comment_type\": \"Task\"\n}\n \n"}],"_postman_id":"3b448900-6045-4e02-adb9-e63b91b0f33b"},{"name":"/v3/tasks","id":"5a6870d6-b2d3-4791-9c10-d25b12d453a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/tasks?q[page]=1&q[status]=active&q[priority]=medium&work_order_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&service_request_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[route_tasks]=true","description":"

Request Description

\n

This endpoint retrieves a list of paginated tasks that the user has permissions to access. The results can be filtered based on the following parameters:

\n

Query Parameters:

\n\n","urlObject":{"path":["api","v3","tasks"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"},{"description":{"content":"

filter tasks by status. Status value can be one of: 'planning', 'active', 'completed', 'late', 'in_progress'

\n","type":"text/plain"},"key":"q[status]","value":"active"},{"description":{"content":"

high, medium, low

\n","type":"text/plain"},"key":"q[priority]","value":"medium"},{"description":{"content":"

UUID of a work order instance

\n","type":"text/plain"},"key":"work_order_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

UUID of a service request instance

\n","type":"text/plain"},"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

UUID of a spot instance

\n","type":"text/plain"},"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

boolean

\n","type":"text/plain"},"key":"q[route_tasks]","value":"true"}],"variable":[]}},"response":[{"id":"c0f92c07-a18d-4d05-ad85-3c237fb8a016","name":"/v3/tasks","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"url":{"raw":"api.spotilla.fi/api/v3/tasks?q[page]=1&q[status]=active&q[priority]=medium&work_order_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&service_request_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[route_tasks]=true","host":["api","spotilla","fi"],"path":["api","v3","tasks"],"query":[{"key":"q[page]","value":"1"},{"key":"q[status]","value":"active","description":"filter tasks by status. Status value can be one of: 'planning', 'active', 'completed'"},{"key":"q[priority]","value":"medium","description":"high, medium, low"},{"key":"work_order_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"UUID of a work order instance"},{"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"UUID of a service request instance"},{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"UUID of a spot instance"},{"key":"q[route_tasks]","value":"true","description":"boolean"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2022-03-14T01:00:00.000+02:00\",\n \"task_heading\": \"test task\",\n \"task_description\": \"\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"late\", \n \"updated_by\": \"david.tester@domain.com\",\n \"updated_by_name\": \"David Tester\",\n \"completion_remarks\": null,\n \"completion_date\": null,\n \"created_at\": \"2022-03-14T16:43:33.993+02:00\",\n \"updated_at\": \"2024-04-22T20:13:23.012+03:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"A1.1\",\n \"spot_parent_hierarchies\": [\n \"brasilian kansio 9 → Brazil → Tester Company.\"\n ],\n \"surface_number\": \"B08050\",\n \"responsible_type\": \"User\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"David Tester\",\n \"original_task_id\": null,\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"in_progress_at\": \"2023-02-27T10:47:50.000+02:00\",\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2024-05-07T17:41:12.563+03:00\",\n \"header\": \"one\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"test task\",\n \"completed_by\": null,\n \"completion_date\": null\n }\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/jpeg\",\n \"created_at\": \"2024-05-07T17:41:16.927+03:00\",\n \"header\": \"three\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"test task\",\n \"completed_by\": null,\n \"completion_date\": null\n }\n }\n ],\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Smapo Industries\",\n \"status\": \"active\",\n \"customer_number\": \"\",\n \"legal_name\": \"Smapo Industries Oy\",\n \"company_id\": \"\",\n \"vat\": \"\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"\",\n \"created_at\": \"2020-12-18T09:04:01.659+02:00\",\n \"updated_at\": \"2022-12-13T14:43:24.758+02:00\",\n \"address\": \"\",\n \"postcode\": \"\",\n \"city\": \"\",\n \"country\": \"NULL\",\n \"inv_address\": \"\",\n \"inv_postcode\": \"\",\n \"inv_city\": \"\",\n \"inv_country\": \"NULL\",\n \"invoicing_email\": \"\",\n \"e_invoice_address\": \"\",\n \"operator\": \"\"\n },\n \"order_num\": \"9713761\",\n \"internal_reference\": null,\n \"external_reference\": null,\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserAccount\",\n \"role_type\": null,\n \"worker_name\": \"Nilla Nova\",\n \"task_resources\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2022-03-14T08:00:00.000+02:00\",\n \"end_time\": \"2022-03-14T09:00:00.000+02:00\",\n \"duration_minutes\": 60\n }\n ]\n }\n ],\n \"role_id_for_workers\": null,\n \"worker_responsible_type\": \"UserAccount\",\n \"work_order\": null,\n \"task_template\": null,\n \"task_resource_settings\": {\n \"edit_due_date\": true,\n \"manage_resourcing\": true,\n \"manage_workers\": true,\n \"edit_own_resourcing\": true\n },\n \"read_only\": true,\n \"comments\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"3\",\n \"created_at\": \"2023-09-28T17:02:35.666+03:00\",\n \"authorizable\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Nova\"\n },\n \"can_edit\": false\n }\n ],\n \"log_entries\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Nova\"\n },\n \"spent_hours\": 888360,\n \"begin_time\": \"2023-09-18T09:51:49.005+03:00\",\n \"end_time\": \"2023-09-28T16:37:01.806+03:00\",\n \"created_at\": \"2023-09-18T09:51:49.007+03:00\",\n \"updated_at\": \"2023-09-28T16:37:01.809+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"{{rand_name}}\"\n },\n \"spent_hours\": 8806620,\n \"begin_time\": \"2023-09-28T17:02:42.387+03:00\",\n \"end_time\": \"2024-01-08T14:19:25.806+02:00\",\n \"created_at\": \"2023-09-28T17:02:42.390+03:00\",\n \"updated_at\": \"2024-01-08T14:19:25.808+02:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"{{rand_name}}\"\n },\n \"spent_hours\": 763860,\n \"begin_time\": \"2024-01-08T14:19:28.788+02:00\",\n \"end_time\": \"2024-01-17T10:30:17.214+02:00\",\n \"created_at\": \"2024-01-08T14:19:28.790+02:00\",\n \"updated_at\": \"2024-01-17T10:30:17.216+02:00\"\n }\n ],\n \"in_progress_by\": \"Admin Vivid\",\n \"in_progress_by_current_user\": false,\n \"service_request\": null,\n \"sales_order_number\": null,\n \"route_task\": false,\n \"route_counts\": null,\n \"all_routes_ready\": true,\n \"require_machine_hours\": false,\n \"current_machine_hours\": null,\n \"task_category_tags\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"tagi-tagi\",\n \"default_locale\": \"fi\",\n \"icon\": \"icons/Automatic.svg\",\n \"category_tag_languages\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"se\",\n \"name\": \"taggar-1 api\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"fi\",\n \"name\": \"tagi-tagi\"\n }\n ]\n }\n ],\n \"billable_task\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2023-01-21T01:00:00.000+02:00\",\n \"task_heading\": \"bugaako\",\n \"task_description\": \"\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"in_progress\",\n \"updated_by\": \"vivid.tester@domain.com\",\n \"updated_by_name\": \"Admin Vivid\",\n \"completion_remarks\": null,\n \"completion_date\": null,\n \"created_at\": \"2023-01-23T11:39:38.991+02:00\",\n \"updated_at\": \"2024-04-22T20:13:58.204+03:00\",\n \"spot_id\": \"89e78673-1234-4f9a-897e-9a2998e4fa77\",\n \"spot\": \"Android\",\n \"spot_parent_hierarchies\": [\n \"Tester → Production Machines → Buenos Aires Site → Tester company.\"\n ],\n \"surface_number\": null,\n \"responsible_type\": \"User\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"Vivid Tester\",\n \"original_task_id\": null,\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"in_progress_at\": \"2023-04-13T12:31:29.000+03:00\",\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2023-08-01T16:43:30.643+03:00\",\n \"header\": \"sivujalka, 1kpl paksuus 1,25mm.PNG\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"test task 2\",\n \"completed_by\": null,\n \"completion_date\": null\n }\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2023-08-01T16:43:30.718+03:00\",\n \"header\": \"sivujalka 1kpl paksuus 1,25mm.PNG\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/v1/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"url\": \"https://api.dev.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"test task 2\",\n \"completed_by\": null,\n \"completion_date\": null\n }\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2023-08-01T16:43:43.733+03:00\",\n \"header\": \"large_kuva.png\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"test task 2\",\n \"completed_by\": null,\n \"completion_date\": null\n }\n }\n ],\n \"customer\": null,\n \"order_num\": \"9713933\",\n \"internal_reference\": \"\",\n \"external_reference\": \"\",\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserAccount\",\n \"role_type\": null,\n \"worker_name\": \"John Doe\",\n \"task_resources\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2023-01-21T08:00:00.000+02:00\",\n \"end_time\": \"2023-01-21T09:00:00.000+02:00\",\n \"duration_minutes\": 60\n }\n ]\n }\n ],\n \"role_id_for_workers\": null,\n \"worker_responsible_type\": \"UserAccount\",\n \"work_order\": null,\n \"task_template\": null,\n \"task_resource_settings\": {\n \"edit_due_date\": true,\n \"manage_resourcing\": true,\n \"manage_workers\": true,\n \"edit_own_resourcing\": true\n },\n \"read_only\": true,\n \"comments\": [],\n \"log_entries\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Doe\"\n },\n \"spent_hours\": 6240,\n \"begin_time\": \"2023-04-13T12:30:00.000+03:00\",\n \"end_time\": \"2023-04-13T14:14:00.000+03:00\",\n \"created_at\": \"2023-04-13T12:30:16.578+03:00\",\n \"updated_at\": \"2023-04-13T12:36:48.123+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Doe\"\n },\n \"spent_hours\": 7200,\n \"begin_time\": \"2023-03-17T13:00:00.000+02:00\",\n \"end_time\": \"2023-03-17T15:00:00.000+02:00\",\n \"created_at\": \"2023-03-17T08:00:03.080+02:00\",\n \"updated_at\": \"2023-04-12T16:01:09.155+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Doe\"\n },\n \"spent_hours\": 3600,\n \"begin_time\": \"2023-03-17T17:10:00.000+02:00\",\n \"end_time\": \"2023-03-17T18:10:00.000+02:00\",\n \"created_at\": \"2023-03-17T17:10:15.305+02:00\",\n \"updated_at\": \"2023-04-12T16:01:17.362+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Doe\"\n },\n \"spent_hours\": 6900,\n \"begin_time\": \"2023-03-17T19:20:00.000+02:00\",\n \"end_time\": \"2023-03-17T21:15:00.000+02:00\",\n \"created_at\": \"2023-03-17T17:15:19.950+02:00\",\n \"updated_at\": \"2023-04-12T16:01:17.559+03:00\"\n }\n ],\n \"in_progress_by\": \"John Doe\",\n \"in_progress_by_current_user\": false,\n \"service_request\": null,\n \"sales_order_number\": null,\n \"route_task\": true,\n \"route_counts\": {\n \"routes_not_added\": false,\n \"completed\": 0,\n \"not_completed\": 1\n },\n \"all_routes_ready\": false,\n \"require_machine_hours\": false,\n \"current_machine_hours\": null,\n \"task_category_tags\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"tagi-tagi\",\n \"default_locale\": \"fi\",\n \"icon\": \"icons/Automatic.svg\",\n \"category_tag_languages\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"se\",\n \"name\": \"taggar-1 api\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"locale\": \"fi\",\n \"name\": \"tagi-tagi\"\n }\n ]\n }\n ],\n \"billable_task\": false\n }\n]"}],"_postman_id":"5a6870d6-b2d3-4791-9c10-d25b12d453a1"},{"name":"/v3/calendar_tasks","id":"a881458c-078d-4121-b304-b9bb1e26c7d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/calendar_tasks?start_date=2022-08-01&end_date=2022-09-01","description":"

Get list of tasks whose due date is within the time range: start_date ≤ due_date ≤end_date.

\n

If either start_date or end_date is not provided (blank), the code sets start_date to the first day of the current month and end_date to the last day of the current month.

\n","urlObject":{"path":["api","v3","calendar_tasks"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"start_date","value":"2022-08-01"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"end_date","value":"2022-09-01"}],"variable":[]}},"response":[{"id":"1adc10ca-ddf3-4938-b496-25dd96f05cfe","name":"/v3/calendar_tasks","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/calendar_tasks?start_date=2022-08-01&end_date=2022-09-01","host":["api","spotilla","fi"],"path":["api","v3","calendar_tasks"],"query":[{"key":"start_date","value":"2022-08-01"},{"key":"end_date","value":"2022-09-01"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2022-08-31T00:00:00.000+02:00\",\n \"task_heading\": \"Yearly inspection\",\n \"task_description\": \"yearly inspection\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"completed\",\n \"updated_by\": null,\n \"updated_by_name\": \"\",\n \"completion_remarks\": null,\n \"completion_date\": \"2022-08-30T00:00:00.000+02:00\",\n \"created_at\": \"2022-01-04T14:05:41.072+02:00\",\n \"updated_at\": \"2022-04-22T20:14:19.887+03:00\",\n \"spot_id\": \"055b8573-1b81-4e03-b424-67d2cf80bfdd\",\n \"spot\": \"Compression machine 10\",\n \"spot_parent_hierarchies\": [\n \"Small Tools and Equipment → Helsinki Site → Finland → MahtavaYritys Oy.\"\n ],\n \"surface_number\": \"D1072\",\n \"responsible_type\": \"User\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"Nilla Nova\",\n \"original_task_id\": null,\n \"completed_by_name\": \"Nilla Novva\",\n \"task_sections\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_at\": \"2020-11-09T16:15:00.000+02:00\",\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"created_at\": \"2020-11-09T16:15:10.686+02:00\",\n \"updated_at\": \"2020-11-09T16:15:10.686+02:00\"\n }\n ],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"in_progress_at\": null,\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"application/pdf\",\n \"created_at\": \"2022-04-22T20:14:19.887+03:00\",\n \"header\": \"PDF-report for task ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/assets/pdf_thumb.png\",\n \"url\": \"https://api.dev.spotilla.fi/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"Yearly inspection\",\n \"completed_by\": \"Nilla Noheva\",\n \"completion_date\": \"2022-08-30T00:00:00.000+02:00\"\n }\n }\n ],\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Example\",\n \"status\": \"active\",\n \"customer_number\": \"32323222\",\n \"legal_name\": \"Example Oy\",\n \"company_id\": \"3276157-6\",\n \"vat\": \"24\",\n \"phone\": \"\",\n \"mobile\": \"\",\n \"email\": \"contact@email.com\",\n \"created_at\": \"2021-09-01T11:38:30.902+03:00\",\n \"updated_at\": \"2021-09-01T12:20:50.749+03:00\",\n \"address\": \"Esimerkkikatu 14 G\",\n \"postcode\": \"01670 \",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Esimerkkikatu 14 G\",\n \"inv_postcode\": \"01670 \",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"invoicing@email.fi\",\n \"e_invoice_address\": \"99894515\",\n \"operator\": \"BAWCFI22\"\n },\n \"order_num\": \"100855\",\n \"internal_reference\": null,\n \"external_reference\": null,\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserAccount\",\n \"role_type\": null,\n \"worker_name\": \"Nilla Nova\",\n \"task_resources\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2022-08-29T23:00:00.000+02:00\",\n \"end_time\": \"2022-08-30T00:00:00.000+02:00\",\n \"duration_minutes\": 60\n }\n ]\n }\n ],\n \"role_id_for_workers\": null,\n \"worker_responsible_type\": \"UserAccount\",\n \"work_order\": null,\n \"task_template\": null,\n \"task_resource_settings\": {\n \"edit_due_date\": true,\n \"manage_resourcing\": true,\n \"manage_workers\": true,\n \"edit_own_resourcing\": true\n },\n \"read_only\": true,\n \"comments\": [],\n \"log_entries\": [],\n \"in_progress_by\": null,\n \"in_progress_by_current_user\": false,\n \"service_request\": null,\n \"sales_order_number\": null,\n \"route_task\": false,\n \"route_counts\": null,\n \"all_routes_ready\": true,\n \"require_machine_hours\": false,\n \"current_machine_hours\": null,\n \"billable_task\": false\n }\n]"}],"_postman_id":"a881458c-078d-4121-b304-b9bb1e26c7d6"},{"name":"/v3/tasks_by_count","id":"4df2e44d-c471-4db6-8ee2-290e4976bab2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"

token received in login request

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

user id received in login request

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same tenancy as is used in login request

\n"}],"url":"api.spotilla.fi/api/v3/tasks_by_count","description":"

Get the count of tasks with status in \"open,\" \"in progress,\" and \"late\" that the user has permission to access.

\n","urlObject":{"path":["api","v3","tasks_by_count"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"44eb9491-34ae-4217-8057-f2d075708696","name":"/v3/tasks_by_count","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"","description":"token received in login request"},{"key":"X-User-Id","type":"text","value":"","description":"user id received in login request"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same tenancy as is used in login request"}],"url":"api.spotilla.fi/api/v3/tasks_by_count"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"is_open_count\": 0,\n \"is_in_progress_count\": 0,\n \"is_late_count\": 2\n}"}],"_postman_id":"4df2e44d-c471-4db6-8ee2-290e4976bab2"},{"name":"/v3/spots/:id/tasks","id":"1b727043-81be-494b-aa9c-7d7b21121645","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"due_date\": \"20.07.2024\", // required field\r\n\t \"task_heading\": \"task heading\", // required field\r\n \"default_resourcing\": true, // pass this field as true, if you want to use default resourcing setting\r\n \"role_id_for_workers_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass this field (UUID of a UserRole), if you want to assign all the users in the role as workers. Do not pass workers_attributes at the same time\r\n \"workers_attributes\": [ \r\n {\r\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a userAccount\r\n \"workable_type\": \"UserAccount\",\r\n \"task_resources_attributes\": [ // pass task_resources_attributes field, if default_resourcing is false/missing;\r\n\t\t {\"start_time\": \"2024-07-06 11:20\", \"end_time\": \"2024-07-06 19:12\"}, \r\n {\"start_time\": \"2024-07-13 12:00\", \"end_time\": \"2024-07-13 13:54\"}\r\n\t\t ]\r\n },\r\n {\r\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a userAccount\r\n \"workable_type\": \"UserAccount\",\r\n \"task_resources_attributes\": [\r\n\t\t {\"start_time\": \"2024-07-06 11:20\", \"end_time\": \"2024-07-07 19:12\"},\r\n {\"start_time\": \"2024-07-13 12:00\", \"end_time\": \"2024-07-13 13:54\"}\r\n\t\t ]\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the task template has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from an external user\r\n ],\r\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a UserRole or a User; task will be created with default resourcing for a User; or A task will be created without resourcing for a UserRole;\r\n // If workers_attributes present, then responsible_id is not needed\r\n \"billable_task\": false // optional parameter, default value is false\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:id/tasks","description":"

The ID is the ID of the Spot, to which the task is created for.

\n

You can create three types of tasks:

\n
    \n

  1. Role-Based Tasks:

    \n
      \n
    1. If the role_id_for_workers is provided, all users in the role will be assigned to the task with default resourcing ('default_resourcing' must be set to true).
      2. \n
    \n
    2. \n

  2. Individual User Tasks:

    \n\n
    3. \n
\n

Note: The responsible_id field is superseded. Avoid using this field unless absolutely necessary.

\n","urlObject":{"path":["api","v3","spots",":id","tasks"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"45675d47-81a3-4d7f-8507-559cc448e106","name":"/v3/spots/:id/tasks","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task\": {\r\n \"due_date\": \"20.07.2024\", // required field\r\n\t \"task_heading\": \"task heading\", // required field\r\n \"default_resourcing\": true, // pass this field as true, if you want to use default resourcing setting\r\n \"role_id_for_workers_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass this field (UUID of a UserRole), if you want to assign all the users in the role as workers. Do not pass workers_attributes at the same time\r\n \"workers_attributes\": [ \r\n {\r\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a userAccount\r\n \"workable_type\": \"UserAccount\",\r\n \"task_resources_attributes\": [ // pass task_resources_attributes field, if default_resourcing is false/missing;\r\n\t\t {\"start_time\": \"2024-07-06 11:20\", \"end_time\": \"2024-07-06 19:12\"}, \r\n {\"start_time\": \"2024-07-13 12:00\", \"end_time\": \"2024-07-13 13:54\"}\r\n\t\t ]\r\n },\r\n {\r\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a userAccount\r\n \"workable_type\": \"UserAccount\",\r\n \"task_resources_attributes\": [\r\n\t\t {\"start_time\": \"2024-07-06 11:20\", \"end_time\": \"2024-07-07 19:12\"},\r\n {\"start_time\": \"2024-07-13 12:00\", \"end_time\": \"2024-07-13 13:54\"}\r\n\t\t ]\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the task template has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from a external user\r\n ],\r\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of a UserRole or a User; task will be created with default resourcing for a User; or A task will be created without resourcing for a UserRole;\r\n // If workers_attributes present, then responsible_id is not needed\r\n \"billable_task\": false // optional parameter, default value is false\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/spots/:id/tasks","host":["api","spotilla","fi"],"path":["api","v3","spots",":id","tasks"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2024-07-20T01:00:00.000+03:00\",\n \"task_heading\": \"task heading\",\n \"task_description\": null,\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"status\": \"active\",\n \"updated_by\": \"david.tester@domain.fi\",\n \"updated_by_name\": \"test manager account\",\n \"completion_remarks\": null,\n \"completion_date\": null,\n \"created_at\": \"2024-06-13T17:18:57.608+03:00\",\n \"updated_at\": \"2024-06-13T17:18:57.737+03:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Phone_Assembly_Machine_\",\n \"spot_parent_hierarchies\": [\n \"Phone_Production_Line → Example Company\"\n ],\n \"surface_number\": \"A0139\",\n \"responsible_type\": null,\n \"responsible_id\": null,\n \"responsible_name\": \"\",\n \"original_task_id\": null,\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": null,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"in_progress_at\": null,\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [],\n \"customer\": null,\n \"order_num\": \"100676\",\n \"internal_reference\": null,\n \"external_reference\": null,\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserAccount\",\n \"role_type\": null,\n \"worker_name\": \"test manager account\",\n \"task_resources\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2024-07-06T11:20:00.000+03:00\",\n \"end_time\": \"2024-07-07T19:12:00.000+03:00\",\n \"duration_minutes\": 1912\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2024-07-13T12:00:00.000+03:00\",\n \"end_time\": \"2024-07-13T13:54:00.000+03:00\",\n \"duration_minutes\": 114\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserAccount\",\n \"role_type\": null,\n \"worker_name\": \"testMobileUser\",\n \"task_resources\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2024-07-06T11:20:00.000+03:00\",\n \"end_time\": \"2024-07-07T19:12:00.000+03:00\",\n \"duration_minutes\": 1912\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"start_time\": \"2024-07-13T12:00:00.000+03:00\",\n \"end_time\": \"2024-07-13T13:54:00.000+03:00\",\n \"duration_minutes\": 114\n }\n ]\n }\n ],\n \"role_id_for_workers\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mobile Helsinki Electricity\"\n },\n \"worker_responsible_type\": \"UserAccounts\",\n \"work_order\": null,\n \"task_template\": null,\n \"task_resource_settings\": {\n \"edit_due_date\": false,\n \"manage_resourcing\": false,\n \"manage_workers\": false,\n \"edit_own_resourcing\": false\n },\n \"read_only\": null,\n \"comments\": [],\n \"log_entries\": [],\n \"in_progress_by\": null,\n \"in_progress_by_current_user\": false,\n \"service_request\": null,\n \"sales_order_number\": null,\n \"route_task\": false,\n \"route_counts\": null,\n \"all_routes_ready\": true,\n \"require_machine_hours\": false,\n \"current_machine_hours\": null,\n \"billable_task\": false\n}"}],"_postman_id":"1b727043-81be-494b-aa9c-7d7b21121645"},{"name":"/v3/tasks/filtered","id":"5f6e4870-966b-4ed8-a286-09068a045fdd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"status\": \"late\",\r\n \"spot_name\": \"Machine\"\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/filtered?q[page]=1","description":"

All possible filtering parameters are listed in the snippet below.

\n

Status options: active, late, in_progress, completed (only one at a time)

\n

If you need all tasks with active, late and in_progress status, you can pass the status option as 'all_active'

\n

Priority options: low, medium, high

\n

Possible ids for responsibles array can be get from this endpoint: GET /api/v2/tasks/task_responsibles/list

\n
{\n    \"status\": \"late\",\n    \"task_heading\": \"Yearly\", // name of the task\n    \"spot_name\": \"Machine\",\n    \"col_name\": \"Tuotantolaitos A\", // collection name\n    \"cust_name\": \"Atmotics\", // customer name\n    \"priorities\": [\n        \"high\",\n        \"low\",\n        \"medium\"\n    ],\n    \"responsibles\": [\n        \"6673232e5-8c3a-4e4d-a3e7-31e2eb4a823\",\n        \"82233518-9b1c-4a1d-9ecf-2a67723337a5\"\n    ],\n    \"category_tags: [\n        \"6dfa78a8-6079-47ad-8e05-07370b95c7f8\",\n        \"07370b95-ei4j-fc03-fck2-ck39fn5klql4\"\n    ]\n}\n\n
","urlObject":{"path":["api","v3","tasks","filtered"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"8d0f55f4-8daa-4043-a9a2-42ea7e4a8d0d","name":"/v3/tasks/filtered","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"status\": \"late\",\r\n \"spot_name\": \"erityis\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/filtered?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","tasks","filtered"],"query":[{"key":"q[page]","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2024-06-20T13:51:42.935+03:00\",\n \"task_heading\": \"Welding robot week check\",\n \"task_description\": \"- Connectors are ok\\n- Check Settings\\n- Calibration check\\n- Oils and fluid check\",\n \"recurrence_interval_number\": 1,\n \"recurrence_interval_block\": \"weeks\",\n \"status\": \"active\",\n \"updated_by\": \"david.tester@example.fi\",\n \"updated_by_name\": \"test manager account\",\n \"completion_remarks\": null,\n \"completion_date\": null,\n \"created_at\": \"2024-06-13T13:51:45.519+03:00\",\n \"updated_at\": \"2024-06-13T13:51:45.519+03:00\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Welding Robot 209 ABB IRB 6640\",\n \"spot_parent_hierarchies\": [\n \"Production Line 201 → Production Machines → Production Site Helsinki → Our Company Ltd\"\n ],\n \"surface_number\": \"A8452\",\n \"responsible_type\": \"MobileUserRole\",\n \"responsible_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"responsible_name\": \"Mobile Helsinki Electricity\",\n \"original_task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_by_name\": null,\n \"task_sections\": [],\n \"requires_review\": false,\n \"planned_start\": null,\n \"planned_end\": null,\n \"planned_duration\": 180,\n \"spent_hours\": 0,\n \"autocreate_pdf_report\": false,\n \"log_entries\": [],\n \"comments\": [],\n \"in_progress_by\": null,\n \"in_progress_at\": null,\n \"in_progress_by_current_user\": false,\n \"task_products\": [],\n \"estimated_cost\": null,\n \"priority\": \"medium\",\n \"upload_items\": [],\n \"customer\": null,\n \"order_num\": \"100673\",\n \"internal_reference\": \"\",\n \"external_reference\": \"\",\n \"enforce_spent_hours\": false,\n \"ongoing_log_by_user\": false,\n \"workers\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"workable_type\": \"UserRole\",\n \"role_type\": \"MobileUserRole\",\n \"worker_name\": \"Mobile Helsinki Electricity\",\n \"task_resources\": []\n }\n ],\n \"role_id_for_workers\": null,\n \"worker_responsible_type\": \"UserRole\",\n \"work_order\": null,\n \"task_template\": null,\n \"task_resource_settings\": {\n \"edit_due_date\": false,\n \"manage_resourcing\": false,\n \"manage_workers\": false,\n \"edit_own_resourcing\": false\n },\n \"read_only\": false,\n \"task_category_tags\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"taggi 2\",\n \"default_locale\": \"fi\",\n \"icon\": \"icons/Automatic.svg\",\n \"category_tag_languages\": [\n {\n \"locale\": \"fi\",\n \"name\": \"taggi 2\"\n },\n {\n \"locale\": \"en\",\n \"name\": \"tag 2\"\n }\n ]\n }\n ],\n \"billable_task\": false\n }\n]"}],"_postman_id":"5f6e4870-966b-4ed8-a286-09068a045fdd"},{"name":"/v3/tasks/:id/generate_pdf","id":"2c26f076-3581-4df1-ad10-b1d1a16adb63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"recipient_addresses\": [\r\n \"address1@example.fi\",\r\n \"address2@example.fi\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:id/generate_pdf","description":"

Generates a PDF report for the given task. Report will be sent to the recipients that listed in the recipients_addresses

\n","urlObject":{"path":["api","v3","tasks",":id","generate_pdf"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

taskUUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"ef37049c-e9ad-41e2-9cda-22a983337085","name":"/v3/tasks/:id/generate_pdf","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"},{"key":"","value":"","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"recipient_addresses\": [\r\n \"address1@example.fi\",\r\n \"address2@example.fi\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id/generate_pdf","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id","generate_pdf"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"message\": \"PDF luotu.\"\r\n}"}],"_postman_id":"2c26f076-3581-4df1-ad10-b1d1a16adb63"}],"id":"f7e9e2d6-a3e8-4090-bcb9-d36528d5027c","_postman_id":"f7e9e2d6-a3e8-4090-bcb9-d36528d5027c","description":""},{"name":"Task Categories","item":[{"name":"/v3/category_tags","id":"aa7c559a-a104-4a9d-9e4d-922f574adea9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/category_tags","description":"

Description

\n

This endpoint retrieves a list of category tags available in the system. Each category tag contains locale information of the tag name. This API endpoint is available for both normal mobile users and users with Integration API Keys (Integraatioavaimet)

\n

This endpoint is useful for fetching category tags that can be utilized in various parts of the application, such as filtering or categorizing items.

\n","urlObject":{"path":["api","v3","category_tags"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"88fa964b-2e87-4b13-a5e8-781f2c28884f","name":"/v3/category_tags","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/category_tags"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"tagi-tagi\", // this is always the tag name of the default locale\r\n \"icon\": \"icons/Automotive.svg\", \r\n \"created_at\": \"2025-11-21T22:05:54.561+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.112+02:00\",\r\n \"default_locale\": \"fi\",\r\n \"category_tag_languages\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"se\",\r\n \"name\": \"taggar-1 api\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // this is the uuid of the category_tag that the task has been assigned to\r\n \"created_at\": \"2025-11-21T22:05:54.585+02:00\",\r\n \"updated_at\": \"2025-11-21T22:05:54.585+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fi\",\r\n \"name\": \"tagi-tagi\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // this is the uuid of the category_tag that the task has been assigned to\r\n \"created_at\": \"2025-11-21T22:05:54.803+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.114+02:00\"\r\n }\r\n ]\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"kulta\",\r\n \"icon\": \"icons/Gold Bars.svg\",\r\n \"created_at\": \"2025-11-20T21:01:17.559+02:00\",\r\n \"updated_at\": \"2025-11-20T21:01:17.559+02:00\",\r\n \"default_locale\": \"fi\",\r\n \"category_tag_languages\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fi\",\r\n \"name\": \"kulta\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-11-20T21:01:17.586+02:00\",\r\n \"updated_at\": \"2025-11-20T21:01:17.586+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"en\",\r\n \"name\": \"gold\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-11-20T21:01:17.768+02:00\",\r\n \"updated_at\": \"2025-11-20T21:01:17.768+02:00\"\r\n }\r\n ]\r\n }\r\n]"}],"_postman_id":"aa7c559a-a104-4a9d-9e4d-922f574adea9"},{"name":"/v3/category_tags/:id","id":"e32e65bd-3655-4022-b84d-f0478fb3467a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"{{special_tenant}}","type":"text"}],"url":"api.spotilla.fi/api/v3/category_tags/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This request is used to retrieve information about a single category tag information.

\n","urlObject":{"path":["api","v3","category_tags",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"dd7d735c-c4cd-43e0-9352-c6e49419af90","name":"/v3/category_tags/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/category_tags/:id","host":["api","spotilla","fi"],"path":["api","v3","category_tags",":id"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"tagi-tagi\",\r\n \"icon\": \"icons/Automotive.svg\",\r\n \"created_at\": \"2025-11-21T22:05:54.561+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.112+02:00\",\r\n \"default_locale\": \"fi\",\r\n \"category_tag_languages\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"se\",\r\n \"name\": \"taggar-1 api\",\r\n \"category_tag_id\": \"98d7e2a7-84a3-49f5-baab-6e7f4905f026\",\r\n \"created_at\": \"2025-11-21T22:05:54.585+02:00\",\r\n \"updated_at\": \"2025-11-21T22:05:54.585+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fi\",\r\n \"name\": \"tagi-tagi\",\r\n \"category_tag_id\": \"98d7e2a7-84a3-49f5-baab-6e7f4905f026\",\r\n \"created_at\": \"2025-11-21T22:05:54.803+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.114+02:00\"\r\n }\r\n ]\r\n }"}],"_postman_id":"e32e65bd-3655-4022-b84d-f0478fb3467a"},{"name":"/v3/category_tags","id":"9b51b6c9-773c-493b-8728-59a16685c803","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"{{special_tenant}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"category_tag\": {\n \"name\": \"tagi in finnish\", // set name in default locale. Requied field for creation\n \"default_locale\": \"fi\", // set default locale. Requied field for creation\n \"icon\": \"icons/Jewel.svg\", // you can also change the icon. Requied field for creation\n \"category_tag_languages_attributes\": [ // availbale locales for creation, Not requied field for creation\n {\"locale\": \"en\", \"name\": \"tag name in english\"},\n {\"locale\": \"se\", \"name\": \"tag name in swedish\"},\n {\"locale\": \"de\", \"name\": \"tag name in german\"},\n {\"locale\": \"fr\", \"name\": \"tag name in french\"},\n {\"locale\": \"da\", \"name\": \"tag name in danish\"}\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/category_tags","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint allows you to create a new category tag. It is used to define a category tag with specific properties such as its name, default locale, icon, and associated language attributes.

\n

Purpose

\n

The primary purpose of this request is to establish a new category tag that can be utilized within the application for categorization purposes.

\n

Request Body Parameters

\n

The request body must be in JSON format and should contain the following structure:

\n\n","urlObject":{"path":["api","v3","category_tags"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"f52797ca-7735-400a-a02f-af7494a53e75","name":"/v3/category_tags","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"category_tag\": {\n // you can always change the default locale to be another language.\n // The available locale should be one of the items in the category_tag_languages_attributes.\n // After update, the name field of this category tag will be automatilcally updated to be the name under the default locale\n \"default_locale\": \"se\", \n \"icon\": \"icons/Automotive.svg\", // You can also change the icon\n \"category_tag_languages_attributes\": [\n {\"locale\": \"en\", \"name\": \"paper\"},// example of adding a new locale \n {\"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"name\": \"updated swedish name\"} // example of update existing locale name, the uuid should be a task_category_tag's instance uuid\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/category_tags"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"tagi in finnish\",\r\n \"icon\": \"icons/Jewel.svg\",\r\n \"created_at\": \"2025-12-08T14:15:31.608+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.608+02:00\",\r\n \"default_locale\": \"fi\",\r\n \"category_tag_languages\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"en\",\r\n \"name\": \"tag name in english\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.629+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.629+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"se\",\r\n \"name\": \"tag name in swedish\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.812+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.812+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"de\",\r\n \"name\": \"tag name in german\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.820+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.820+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fr\",\r\n \"name\": \"tag name in french\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.828+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.828+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"da\",\r\n \"name\": \"tag name in danish\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.837+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.837+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fi\",\r\n \"name\": \"tagi in finnish\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-12-08T14:15:31.844+02:00\",\r\n \"updated_at\": \"2025-12-08T14:15:31.844+02:00\"\r\n }\r\n ]\r\n}"}],"_postman_id":"9b51b6c9-773c-493b-8728-59a16685c803"},{"name":"/v3/category_tags/:id","id":"67114c77-50ed-4162-8417-5b6f7fd2ff11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"{{special_tenant}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"category_tag\": {\n \"default_locale\": \"se\", // you can always change the default locale to be another language. The available locale should be one of the items in the category_tag_languages_attributes\n \"icon\": \"icons/Automotive.svg\", // you can also change the icon \n \"category_tag_languages_attributes\": [\n {\"locale\": \"en\", \"name\": \"paper\"},// example of adding a new locale \n {\"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"name\": \"updated swedish name\"} // example of update existing locale name, the uuid should be a task_category_tag's instance uuid\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/category_tags/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint allows you to update an existing category tag identified by its unique id. It is primarily used to modify the properties of a category tag, including its default locale, icon, and associated language attributes.

\n

Request Body Parameters

\n

The request body must be in JSON format and should contain the following structure:

\n\n","urlObject":{"path":["api","v3","category_tags",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"0b5e2b4e-9da6-46d4-bef6-72da59bda015","name":"/v3/category_tags/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"category_tag\": {\n // you can always change the default locale to be another language.\n // The available locale should be one of the items in the category_tag_languages_attributes.\n // After update, the name field of this category tag will be automatilcally updated to be the name under the default locale\n \"default_locale\": \"se\", \n \"icon\": \"icons/Automotive.svg\", // You can also change the icon\n \"category_tag_languages_attributes\": [\n {\"locale\": \"en\", \"name\": \"paper\"},// example of adding a new locale \n {\"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"name\": \"updated swedish name\"} // example of update existing locale name, the uuid should be a task_category_tag's instance uuid\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/category_tags/:id","host":["api","spotilla","fi"],"path":["api","v3","category_tags",":id"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"updated swedish name\", // always be the name in the default locale\r\n \"icon\": \"icons/Automotive.svg\",\r\n \"created_at\": \"2025-11-21T22:05:54.561+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.112+02:00\",\r\n \"default_locale\": \"se\",\r\n \"category_tag_languages\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"se\",\r\n \"name\": \"updated swedish name\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-11-21T22:05:54.585+02:00\",\r\n \"updated_at\": \"2025-11-21T22:05:54.585+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"fi\",\r\n \"name\": \"tagi-tagi\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-11-21T22:05:54.803+02:00\",\r\n \"updated_at\": \"2025-11-22T19:43:39.114+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"locale\": \"en\",\r\n \"name\": \"paper\",\r\n \"category_tag_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2025-11-22T22:05:54.803+02:00\",\r\n \"updated_at\": \"2025-11-22T22:43:39.114+02:00\"\r\n }\r\n ]\r\n }"}],"_postman_id":"67114c77-50ed-4162-8417-5b6f7fd2ff11"},{"name":"/v3/category_tags/:id","id":"232d23be-add3-45a8-98f7-b4c0df9f498a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-User-Token","value":"{{special_token}}","type":"text"},{"key":"X-User-Id","value":"{{special_id}}","type":"text"},{"key":"X-User-Subdomain","value":"{{special_tenant}}","type":"text"}],"url":"api.spotilla.fi/api/v3/category_tags/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

Description

\n

This endpoint delete a single category tags available in the system.

\n","urlObject":{"path":["api","v3","category_tags",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"77ec420f-3376-41da-ac5c-9910b6b7824d","name":"/v3/category_tags","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/category_tags/:id","host":["api","spotilla","fi"],"path":["api","v3","category_tags",":id"],"variable":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{ \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"msg\": \"Destroy successful\" }"}],"_postman_id":"232d23be-add3-45a8-98f7-b4c0df9f498a"}],"id":"cdf63081-618d-45c1-bec6-78c92a1ac93f","_postman_id":"cdf63081-618d-45c1-bec6-78c92a1ac93f","description":""},{"name":"Task Forms","item":[{"name":"/v3/tasks/:id/task_forms","id":"46b5c889-6b30-4c91-ac56-1bfc2babf94b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tasks/:id/task_forms","description":"

This endpoint retrieves the task form for a single task for which the user has permissions.

\n","urlObject":{"path":["api","v3","tasks",":id","task_forms"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"109d9d07-52df-4ed7-9b8d-55c178ba12e6","name":"/v3/tasks/:id/task_forms","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id/task_forms","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id","task_forms"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Monthly machine inspection\",\n \"description\": \"\",\n \"task_form_sections\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"title\": \"Basic Checks\",\n \"description\": \"\",\n \"is_duplicatable\": false,\n \"is_attachable\": true,\n \"task_form_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine hours\",\n \"input_type\": \"number\",\n \"required\": true,\n \"select_values\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine status\",\n \"input_type\": \"select\",\n \"required\": true,\n \"select_values\": [\n \"Adequate\",\n \"Bad\",\n \"Excellent\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tests completed\",\n \"input_type\": \"boolean\",\n \"required\": false,\n \"select_values\": []\n }\n ]\n }\n ],\n \"task_templates\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Machine Maintenance\",\n \"description\": \"\",\n \"task_heading\": \"Machine maintenance\",\n \"task_description\": \"Complete maintenance as described in form\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"created_at\": \"2020-11-10T09:48:16.387Z\",\n \"updated_at\": \"2020-11-10T10:56:05.003Z\",\n \"task_form_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"recurrence_retain_schedule\": true,\n \"wo_number\": null,\n \"work_order_id\": null,\n \"requires_review\": false,\n \"enforce_spent_hours\": false,\n \"weekday_settings\": {}\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Machine Monthly Inspection\",\n \"description\": \"!(()&&!|*|*|\",\n \"task_heading\": \"Inspect machine\",\n \"task_description\": \"\\nComplete inspection and fill the form\",\n \"recurrence_interval_number\": 1,\n \"recurrence_interval_block\": \"months\",\n \"created_at\": \"2020-11-03T13:43:13.624Z\",\n \"updated_at\": \"2021-02-23T19:00:59.732Z\",\n \"task_form_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"recurrence_retain_schedule\": true,\n \"wo_number\": null,\n \"work_order_id\": null,\n \"requires_review\": false,\n \"enforce_spent_hours\": false,\n \"weekday_settings\": {}\n }\n ],\n \"has_pdf_settings\": true,\n \"auto_generates_report\": false\n}"}],"_postman_id":"46b5c889-6b30-4c91-ac56-1bfc2babf94b"},{"name":"/v3/task_forms","id":"ab50075b-7543-4c7a-8bc6-b4c744b5920b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/task_forms","description":"

This endpoint retrieves a list of task forms that are in use, along with their sections, fields, and templates.

\n","urlObject":{"path":["api","v3","task_forms"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"1c862a96-7d51-40c8-8dd9-a3ec8cc27fa2","name":"/v3/task_forms","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/task_forms"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Monthly machine inspection\",\n \"description\": \"\",\n \"task_form_sections\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"title\": \"Basic Checks\",\n \"description\": \"\",\n \"is_duplicatable\": false,\n \"is_attachable\": true,\n \"task_form_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine hours\",\n \"input_type\": \"number\",\n \"required\": true,\n \"select_values\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine status\",\n \"input_type\": \"select\",\n \"required\": true,\n \"select_values\": [\n \"Adequate\",\n \"Bad\",\n \"Excellent\"\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tests completed\",\n \"input_type\": \"boolean\",\n \"required\": false,\n \"select_values\": []\n }\n ]\n }\n ],\n \"task_templates\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Machine Maintenance\",\n \"description\": \"╰(○'◡'○)╮\",\n \"task_heading\": \"Machine maintenance\",\n \"task_description\": \"Complete maintenance as described in form\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"created_at\": \"2020-11-10T09:48:16.387Z\",\n \"updated_at\": \"2020-11-10T10:56:05.003Z\",\n \"task_form_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"recurrence_retain_schedule\": true,\n \"wo_number\": null,\n \"work_order_id\": null,\n \"requires_review\": false,\n \"enforce_spent_hours\": false,\n \"weekday_settings\": {}\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Machine Monthly Inspection\",\n \"description\": \"╰(○'◡'○)╮\",\n \"task_heading\": \"Inspect machine\",\n \"task_description\": \"Complete inspection and fill the form\",\n \"recurrence_interval_number\": 1,\n \"recurrence_interval_block\": \"months\",\n \"created_at\": \"2020-11-03T13:43:13.624Z\",\n \"updated_at\": \"2021-02-23T19:00:59.732Z\",\n \"task_form_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"recurrence_retain_schedule\": true,\n \"wo_number\": null,\n \"work_order_id\": null,\n \"requires_review\": false,\n \"enforce_spent_hours\": false,\n \"weekday_settings\": {}\n }\n ],\n \"has_pdf_settings\": true,\n \"auto_generates_report\": false\n }\n]"}],"_postman_id":"ab50075b-7543-4c7a-8bc6-b4c744b5920b"}],"id":"4524b647-82a5-430b-bbdd-5d74479d3625","_postman_id":"4524b647-82a5-430b-bbdd-5d74479d3625","description":""},{"name":"Task Templates","item":[{"name":"v3/task_templates","id":"2862cf23-65c4-4980-bd84-965ad5f07178","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/task_templates","description":"

This endpoint makes an HTTP GET request to retrieve a list of task templates from the Spotilla API.

\n

Request Parameters

\n

This request does not require any specific parameters.

\n","urlObject":{"path":["api","v3","task_templates"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"33463ced-a62a-4afa-ac4f-4d646ae3a56b","name":"v3/task_templates","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/task_templates"},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"I am the Fast\",\r\n \"description\": \"Fast\",\r\n \"task_heading\": \"Task with a report\",\r\n \"task_description\": \"\",\r\n \"recurrence_interval_number\": null,\r\n \"recurrence_interval_block\": \"none\",\r\n \"recurrence_retain_schedule\": true,\r\n \"task_form\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Fastform\",\r\n \"description\": \"\"\r\n },\r\n \"require_machine_hours\": false,\r\n \"work_order\": null,\r\n \"signature_templates\": [],\r\n \"task_category_tags\": [],\r\n \"estimated_cost\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Machine Fault Check\",\r\n \"description\": \"\",\r\n \"task_heading\": \"Machine Fault Check\",\r\n \"task_description\": \"Complete maintenance as described in form\",\r\n \"recurrence_interval_number\": null,\r\n \"recurrence_interval_block\": \"none\",\r\n \"recurrence_retain_schedule\": true,\r\n \"task_form\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Weekly Machine Inspection\",\r\n \"description\": \"Needs to be done every week\"\r\n },\r\n \"require_machine_hours\": false,\r\n \"work_order\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"wo_number\": \"1\",\r\n \"status\": \"open\",\r\n \"description\": \"test scenario\",\r\n \"created_at\": \"2023-10-18T08:26:55.568Z\",\r\n \"updated_at\": \"2023-10-18T08:26:55.634Z\",\r\n \"customer_id\": null,\r\n \"name\": \"test\",\r\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": null,\r\n \"end_date\": null\r\n },\r\n \"signature_templates\": [],\r\n \"task_category_tags\": [],\r\n \"estimated_cost\": \"1000.0\"\r\n }\r\n]"}],"_postman_id":"2862cf23-65c4-4980-bd84-965ad5f07178"},{"name":"v3/task_templates/:id","id":"84b5768f-c73a-4c5f-8c08-9cee429b6961","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/task_templates/:id","description":"

This endpoint returns a task template by its UUID.

\n","urlObject":{"path":["api","v3","task_templates",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task template UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"00a92a7f-e77e-4a1f-a684-a5cce7ba8f52","name":"v3/task_templates/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/task_templates/:id","host":["api","spotilla","fi"],"path":["api","v3","task_templates",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task template UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Machine Fault Check\",\n \"description\": \"\",\n \"task_heading\": \"Machine Fault Check\",\n \"task_description\": \"Complete maintenance as described in form\",\n \"recurrence_interval_number\": null,\n \"recurrence_interval_block\": \"none\",\n \"recurrence_retain_schedule\": true,\n \"task_form\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Weekly Machine Inspection\",\n \"description\": \"Needs to be done every week\"\n },\n \"require_machine_hours\": false,\n \"work_order\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"wo_number\": \"1\",\n \"status\": \"open\",\n \"description\": \"test scenario\",\n \"created_at\": \"2023-10-18T08:26:55.568Z\",\n \"updated_at\": \"2023-10-18T08:26:55.634Z\",\n \"customer_id\": null,\n \"name\": \"test\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"begin_date\": null,\n \"end_date\": null\n },\n \"signature_templates\": [],\n \"task_category_tags\": [],\n \"estimated_cost\": \"1000.0\"\n}"}],"_postman_id":"84b5768f-c73a-4c5f-8c08-9cee429b6961"}],"id":"2739a77d-1629-4c1b-8a49-bb5e05ddc867","_postman_id":"2739a77d-1629-4c1b-8a49-bb5e05ddc867","description":""},{"name":"Task Sections","item":[{"name":"/v3/tasks/:id/task_sections","id":"1bfc8312-032f-4d49-a90f-af9822d0128c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections","description":"

The GET request retrieves the task sections for a specific task identified by :id

\n","urlObject":{"path":["api","v3","tasks",":task_id","task_sections"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"task_id"}]}},"response":[{"id":"088953cb-dd35-44e4-bb98-efaccd6d7640","name":"/v3/tasks/:id/task_sections","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections","host":["api","spotilla","fi"],"path":["api","v3","tasks",":task_id","task_sections"],"variable":[{"key":"task_id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"description\": \"\",\n \"task_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine hours\",\n \"input_type\": \"number\",\n \"value\": 600.0,\n \"comment\": \"\",\n \"required\": true,\n \"select_values\": [],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Machine status\",\n \"input_type\": \"select\",\n \"value\": \"Bad\",\n \"comment\": \"Will need maintenance shortly\",\n \"required\": true,\n \"select_values\": [\n \"Adequate\",\n \"Bad\",\n \"Excellent\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tests completed\",\n \"input_type\": \"boolean\",\n \"value\": true,\n \"comment\": \"\",\n \"required\": false,\n \"select_values\": [],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ],\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_at\": \"2020-11-16T15:30:00.000+02:00\",\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [],\n \"is_attachable?\": true,\n \"is_duplicatable\": false,\n \"upload_items_count\": 0\n }\n]"}],"_postman_id":"1bfc8312-032f-4d49-a90f-af9822d0128c"},{"name":"/v3/tasks/:task_id/task_sections","id":"84cdf9ac-6e4f-4474-9217-ead6eced0a18","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"\r\n{\r\n \"task_section\": {\r\n \"completed_at\": \"2022-02-01T13:30Z\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \r\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required params\r\n \"task_fields_attributes\": [ // optional\r\n {\r\n \"value\": \"Kyllä\",\r\n \"comment\": \"Absolutely relevant informatio related to this field\", // optional\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Kyllä\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Kyllä\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:id/task_sections","description":"

Create Task Section

\n

This endpoint is used to create a task section for a specific task, when no section exists or one is repeated.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","tasks",":id","task_sections"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"f459c442-d9d0-42bb-afdb-9fc48a2b2a3b","name":"/v3/tasks/:id/task_sections","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"\r\n{\r\n \"task_section\": {\r\n \"completed_at\": \"2022-02-01T13:30Z\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_fields_attributes\": [\r\n {\r\n \"value\": \"Yes\",\r\n \"comment\": \"A very relevant comment\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Yes\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Yes\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections","host":["api","spotilla","fi"],"path":["api","v3","tasks",":task_id","task_sections"],"variable":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"description\": \"\",\n \"task_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotteen maku\",\n \"input_type\": \"select\",\n \"value\": \"Kyllä\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotteen rakenne\",\n \"input_type\": \"select\",\n \"value\": \"Kyllä\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotteen ulkonäkö\",\n \"input_type\": \"select\",\n \"value\": \"Kyllä\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ],\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_at\": \"2022-02-01T15:30:00.000+02:00\",\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2022-02-01T13:34:02.642+02:00\",\n \"header\": \"Heart eyes emoji image\",\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/5ebfd1aa-d790-42cc-abc2-433245fa9b58\",\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/5ebfd1aa-d790-42cc-abc2-433245fa9b58\",\n \"task\": null\n }\n ],\n \"is_attachable?\": true,\n \"is_duplicatable\": true,\n \"upload_items_count\": 1\n}"}],"_postman_id":"84cdf9ac-6e4f-4474-9217-ead6eced0a18"},{"name":"/v3/tasks/:task_id/task_sections/:id","id":"bf751a59-ccc4-47cd-ad12-e6e1b7358cf1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"\r\n{\r\n \"task_section\": {\r\n \"completed_at\": \"2022-02-01T13:39Z\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // same task_id as in the Path Variable\r\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \r\n \"task_fields_attributes\": [\r\n {\r\n \"value\": \"Ei\",\r\n \"comment\": \"Some relevant comment\", // optional\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n { // pass when creating\r\n \"file_base\": \"examplefilebanse\",\r\n \"content_type\": \"audio/mpeg\",\r\n \"file_description\": \"audio\"\r\n },\r\n { // params when destroying\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass this field when creating. \r\n \"_destroy\": true // pass this and id fields only when destroying\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections/:id","description":"

Update Task Section

\n

This endpoint is used to update an already existing task section with new data.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","tasks",":task_id","task_sections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"task_id"},{"description":{"content":"

task_section UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"ef9c1f9e-5b4d-44c8-a8c6-ab3af42dd9b1","name":"/v3/tasks/:id/task_sections/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"\r\n{\r\n \"task_section\": {\r\n \"completed_at\": \"2022-02-01T13:39Z\",\r\n \"task_fields_attributes\": [\r\n {\r\n \"value\": \"Ei\",\r\n \"comment\": \"Another very relevant comment relating to this field\",\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n { // params to remove a item\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"_destroy\": true\r\n },\r\n { // params to upload a item\r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id/task_sections/:section_id","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id","task_sections",":section_id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"},{"key":"section_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task section UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"description\": \"\",\n \"task_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \n \"label\": \"Tuotteen maku\",\n \"input_type\": \"select\",\n \"value\": \"Kyllä\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotteen rakenne\",\n \"input_type\": \"select\",\n \"value\": \"Kyllä\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotteen ulkonäkö\",\n \"input_type\": \"select\",\n \"value\": \"Ei\",\n \"required\": true,\n \"select_values\": [\n \"Kyllä\",\n \"Ei\"\n ],\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ],\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"completed_at\": \"2022-02-01T15:39:00.000+02:00\",\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [],\n \"is_attachable?\": true,\n \"is_duplicatable\": true,\n \"upload_items_count\": 0\n}"}],"_postman_id":"bf751a59-ccc4-47cd-ad12-e6e1b7358cf1"},{"name":"/v3/tasks/:task_id/task_sections/:id","id":"88c79d29-23ed-48ba-b871-5ab4dce7b300","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections/:id","description":"

This endpoint is used to delete a specific task section within a task.

\n","urlObject":{"path":["api","v3","tasks",":task_id","task_sections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"task_id"},{"description":{"content":"

task section UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"c4ebe401-a241-45a0-b2c7-1a5a5cb51bd1","name":"/v3/tasks/:id/task_sections/:id","originalRequest":{"method":"DELETE","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/tasks/:task_id/task_sections/:id","host":["api","spotilla","fi"],"path":["api","v3","tasks",":task_id","task_sections",":id"],"variable":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"taks UUID"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task section UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"msg\": \"Section removed\",\n \"section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // same task section UUID as passed to the url path\n}"}],"_postman_id":"88c79d29-23ed-48ba-b871-5ab4dce7b300"},{"name":"/v3/task_sections/:id/complete","id":"d652572a-ca56-4d3e-a9bc-e0733a14179f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"task_section\": {\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required\r\n \"completed_at\": \"2020-11-16T15:30:00.000+02:00\", \r\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required\r\n \"task_fields_attributes\": [\r\n {\r\n \"value\": 600.0,\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Bad\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": true,\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"File as BASE64\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"This is an image\",\r\n \"uploaded_by\": \"example user name\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/task_sections/:id/complete","description":"

Complete Task Section

\n

This endpoint is used to mark a task section as complete.

\n

Request Body

\n

Note: the request body is for creating task_section from completion data if it does not exist

\n\n","urlObject":{"path":["api","v3","task_sections",":id","complete"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

task section UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"94024b8d-10a3-4048-ab55-5ae7250eade3","name":"/v3/task_sections/:id/complete","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_fields_attributes\": [\r\n {\r\n \"value\": 600.0,\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": \"Bad\",\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"value\": true,\r\n \"task_form_field_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"completed_at\": \"2020-11-16T15:30:00.000+02:00\",\r\n \"task_form_section_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"File as BASE64\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"This is an image\",\r\n \"uploaded_by\": \"\" \r\n }\r\n ],\r\n \"is_attachable?\": true,\r\n \"is_duplicatable\": false\r\n }\r\n]","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/task_sections/:id/complete","host":["api","spotilla","fi"],"path":["api","v3","task_sections",":id","complete"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task section UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Section skipped\"\n}"}],"_postman_id":"d652572a-ca56-4d3e-a9bc-e0733a14179f"}],"id":"a9532237-795a-422c-8df6-3d64c8f01128","_postman_id":"a9532237-795a-422c-8df6-3d64c8f01128","description":""},{"name":"Maintenance Routes","item":[{"name":"/v3/maintenance_routes","id":"be10871a-7ea5-414f-b190-d6070234b656","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/maintenance_routes?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

This endpoint makes an HTTP GET request to return maintenance routes based on the provided task UUID (required params). The request does not contain a request body as it is a GET request. The task UUID is included as a query parameter in the URL.

\n

The response body will include the maintenance routes corresponding to the provided task UUID. The response will contain information such as route UUID, route name, assigned technician, start and end times, and any other relevant details related to the maintenance routes.

\n","urlObject":{"path":["api","v3","maintenance_routes"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

task UUID, required params

\n","type":"text/plain"},"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"45948bfd-7667-43bd-a62c-b88f5b99a03c","name":"/v3/maintenance_routes?task_id=:task_uuid","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/maintenance_routes?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","maintenance_routes"],"query":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"routes_not_added\": false,\n \"completed_routes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Scrubmaster\",\n \"status\": \"active\"\n },\n \"spot_parent_hierarchies\": [\n \"Amerikka → Laitokset\"\n ],\n \"surface_number\": null,\n \"location\": null,\n \"order\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Vallox IV-kone 145\",\n \"status\": \"active\"\n },\n \"spot_parent_hierarchies\": [\n \"Tuotantolaitokset → Siikajärvi → Laitteet\"\n ],\n \"surface_number\": \"AAA324\",\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"order\": 2\n }\n ],\n \"not_completed_routes\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Test Spot\",\n \"status\": \"inactive\"\n },\n \"spot_parent_hierarchies\": [\n \"Amerikka → Laitokset\"\n ],\n \"surface_number\": \"BKKA32\",\n \"location\": null,\n \"order\": 3\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Jäähdytin kompressori\",\n \"status\": \"active\"\n },\n \"spot_parent_hierarchies\": [\n \"Amerikka → Laitokset\"\n ],\n \"surface_number\": null,\n \"location\": null,\n \"order\": 4\n }\n ]\n}"}],"_postman_id":"be10871a-7ea5-414f-b190-d6070234b656"},{"name":"/v3/maintenance_routes/:id?task_id=:task_uuid","id":"a6d264fb-4474-4f4c-8608-e952d19ed1a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/maintenance_routes/:id?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

API Request Description

\n

This endpoint retrieves maintenance route details with spot info, based on the provided maitenance route UUID and task ID.

\n

Request

\n\n","urlObject":{"path":["api","v3","maintenance_routes",":id"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

task UUID; required params

\n","type":"text/plain"},"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[{"description":{"content":"

maintenance route UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"89b7381c-2548-4ac8-8a43-4244532f6a11","name":"/v3/maintenance_routes/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/maintenance_routes/:id?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","maintenance_routes",":id"],"query":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID; required params"}],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"maintenance route UUID"}]}},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Vallox IV-kone 145\",\n \"status\": \"active\"\n },\n \"spot_parent_hierarchies\": [\n \"Tuotantolaitokset → Siikajärvi → Laitteet\"\n ],\n \"surface_number\": \"AAA324\",\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"order\": 2,\n \"maintenance_route_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Suorita tarkastus\",\n \"value\": true,\n \"details\": \"Vaihdettu suodatin.\",\n \"order\": 1,\n \"required_field\": true\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Kuukausitarkastus\",\n \"value\": null,\n \"details\": null,\n \"order\": 2,\n \"required_field\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d28\",\n \"label\": \"Tarvitsee lisätoimia\",\n \"value\": false,\n \"details\": \"\",\n \"order\": 3,\n \"required_field\": false\n }\n ]\n}"}],"_postman_id":"a6d264fb-4474-4f4c-8608-e952d19ed1a3"},{"name":"/v3/maintenance_routes/:id","id":"a6c07fea-0ce3-4327-b7aa-9e0843a20d1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"maintenance_route\": {\r\n \"maintenance_route_fields_attributes\": [\r\n {\r\n \"details\": \"Vaihdettu suodatin.\",\r\n \"value\": true,\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // maintenance route field UUID\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/maintenance_routes/:id?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Update Maintenance Route

\n

This endpoint allows you to update a specific maintenance route identified by the route ID.

\n

Note: You cannot update the maintenance route if the task is completed.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","maintenance_routes",":id"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

task UUID

\n","type":"text/plain"},"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[{"description":{"content":"

maitenance route UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"bce5e732-f507-4f9b-972a-c4c368a82b2c","name":"/v3/maintenance_routes/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"maintenance_route\": {\r\n \"maintenance_route_fields_attributes\": [\r\n {\r\n \"details\": \"Vaihdettu suodatin.\",\r\n \"value\": true,\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"details\": \"OK\",\r\n \"value\": true,\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/maintenance_routes/:id?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","maintenance_routes",":id"],"query":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task UUID"}],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"maintenance route UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": {\n \"name\": \"Vallox IV-kone 145\",\n \"status\": \"active\"\n },\n \"spot_parent_hierarchies\": [\n \"Tuotantolaitokset → Siikajärvi → Laitteet\"\n ],\n \"surface_number\": \"AAA324\",\n \"location\": {\n \"type\": \"fixed\",\n \"latitude\": \"60.21185111764446\",\n \"longitude\": \"24.66636657714844\"\n },\n \"order\": 2,\n \"maintenance_route_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Suorita tarkastus\",\n \"value\": true,\n \"details\": \"Vaihdettu suodatin.\",\n \"order\": 1,\n \"required_field\": true\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Kuukausitarkastus\",\n \"value\": null,\n \"details\": null,\n \"order\": 2,\n \"required_field\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tarvitsee lisätoimia\",\n \"value\": false,\n \"details\": \"\",\n \"order\": 3,\n \"required_field\": false\n }\n ]\n}"}],"_postman_id":"a6c07fea-0ce3-4327-b7aa-9e0843a20d1d"}],"id":"88bcbe0d-4f04-4fb6-addd-1236e2b7fea6","_postman_id":"88bcbe0d-4f04-4fb6-addd-1236e2b7fea6","description":""}],"id":"1ab19634-0d7b-4aff-800c-814394376282","_postman_id":"1ab19634-0d7b-4aff-800c-814394376282","description":""},{"name":"Service Requests","item":[{"name":"Service Requests","item":[{"name":"/v3/service_requests","id":"cfa8c029-daec-438d-87ba-f83b857604e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_requests?q[page]=4&q[status]=is_open","description":"

Retrieve Service Requests

\n

This endpoint retrieves a list of service requests with pagination. Results can be filtered by the service requests' status.

\n

Request

\n\n","urlObject":{"path":["api","v3","service_requests"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"4"},{"key":"q[status]","value":"is_open"}],"variable":[]}},"response":[{"id":"177a7024-a825-4cd2-9635-bcb477df71b2","name":"/v3/service_requests","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/service_requests?q[page]=1&q[status]=is_open","host":["api","spotilla","fi"],"path":["api","v3","service_requests"],"query":[{"key":"q[page]","value":"1"},{"key":"q[status]","value":"is_open"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000057\",\r\n \"name\": \"{{rand_name}}\",\r\n \"email\": \"{{rand_email}}\",\r\n \"phone\": null,\r\n \"title\": \"Kaasupullo vuotaa\",\r\n \"description\": \"Vuotaa ilmaan\",\r\n \"status\": \"is_open\",\r\n \"priority\": \"high\",\r\n \"service_request_fields\": [],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Tämä pitää selvittää\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\r\n }\r\n ],\r\n \"created_at\": \"2020-12-15T12:20:35.546+02:00\",\r\n \"updated_at\": \"2020-12-15T13:46:46.299+02:00\",\r\n \"manager_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Responsible Role for All Service Requests\"\r\n },\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"General Service Request Responsability\"\r\n },\r\n \"completed_at\": \"2020-12-15T13:46:46.299+02:00\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Gas bottle 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": true,\r\n \"can_add_comment_and_files\": true,\r\n \"can_set_in_progress\": false,\r\n \"log_entries\": [],\r\n \"service_request_products\": [],\r\n \"ongoing_log_by_user\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000058\",\r\n \"name\": \"{{rand_name}}\",\r\n \"email\": \"{{rand_email}}\",\r\n \"phone\": null,\r\n \"title\": \"Hitsauslaite tkee huonoa jälkeä\",\r\n \"description\": \"Saumat pielessä!\",\r\n \"status\": \"is_open\",\r\n \"priority\": \"high\",\r\n \"service_request_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"label\": \"Severity\",\r\n \"value\": \"Immediate Actions Required\",\r\n \"input_type\": \"select\"\r\n }\r\n ],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Otettu selvitykseen\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:21:51.535+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Selvitellään vieläkin, varaosia ehkä tarvitaan\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:22:07.524+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Varaosia ei meinaa saada\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:22:15.195+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Varaosa on vaihdettu\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T13:45:53.319+02:00\"\r\n }\r\n ],\r\n \"created_at\": \"2020-12-15T12:21:30.149+02:00\",\r\n \"updated_at\": \"2020-12-15T13:45:58.750+02:00\",\r\n \"manager_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Responsible Role for All Service Requests\"\r\n },\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Fault Notice Responsability\"\r\n },\r\n \"completed_at\": \"2020-12-15T13:45:58.750+02:00\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Welding Machine 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": false,\r\n \"can_add_comment_and_files\": false,\r\n \"can_set_in_progress\": false,\r\n \"log_entries\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"{{rand_name}}\"\r\n },\r\n \"spent_hours\": 25200,\r\n \"begin_time\": \"2022-09-21T11:00:00.000+03:00\",\r\n \"end_time\": \"2022-09-21T18:00:00.000+03:00\",\r\n \"created_at\": \"2022-09-30T16:16:56.060+03:00\",\r\n \"updated_at\": \"2022-09-30T16:16:56.060+03:00\"\r\n }\r\n ],\r\n \"service_request_products\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 3.0,\r\n \"product\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Suodatin\"\r\n },\r\n \"warehouse\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Eteläinen Varasto\"\r\n },\r\n \"warehouse_slot\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Ylähylly\"\r\n }\r\n }\r\n ],\r\n \"ongoing_log_by_user\": true,\r\n \"on_hold_reason\": null\r\n }\r\n]"}],"_postman_id":"cfa8c029-daec-438d-87ba-f83b857604e4"},{"name":"/v3/spots/:spot_id/service_requests","id":"0b203df7-bab1-47cc-9405-6c53c6954a2b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/:spot_id/service_requests?q[status]=is_open&q[page]=1","description":"

This API endpoint makes an HTTP GET request to retrieve a list of service requests for a specific spot, with the option to filter by status or/and pagination.

\n

optional params:

\n\n","urlObject":{"path":["api","v3","spots",":spot_id","service_requests"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

filter sreq by status: is_open | on_hold | completed

\n","type":"text/plain"},"key":"q[status]","value":"is_open"},{"description":{"content":"

pagination

\n","type":"text/plain"},"key":"q[page]","value":"1"}],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"a7c24d23-add4-4caa-b0ba-17c5a9534562","name":"v3/spots/:spot_id/service_requests?q[status]=completed&q[page]=1","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:spot_id/service_requests?q[status]=completed&q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","spots",":spot_id","service_requests"],"query":[{"key":"q[status]","value":"completed","description":"is_open | on_hold | completed"},{"key":"q[page]","value":"1"}],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[ \r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000017\",\r\n \"name\": \"Black Widow\",\r\n \"email\": \"black.widow@test.com\",\r\n \"phone\": \"\",\r\n \"title\": \"weird noice\",\r\n \"description\": \"\",\r\n \"status\": \"completed\",\r\n \"priority\": \"medium\",\r\n \"service_request_fields\": [\r\n {\r\n \"id\": \"\",\r\n \"label\": \"Fault caused a production stoppage?\",\r\n \"value\": \"\",\r\n \"input_type\": \"select\",\r\n \"required\": false,\r\n \"select_values\": [\r\n \"Yes\",\r\n \"No\"\r\n ],\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"\",\r\n \"label\": \"Device Number / Tag Number\",\r\n \"value\": \"\",\r\n \"input_type\": \"string\",\r\n \"required\": false,\r\n \"select_values\": [],\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"done.\",\r\n \"username\": \"Käyttäjä poistettu\",\r\n \"created_at\": \"2023-04-04T13:33:16.168Z\"\r\n }\r\n ],\r\n \"created_at\": \"2023-03-07T09:26:02.809Z\",\r\n \"updated_at\": \"2023-04-04T13:33:26.320Z\",\r\n \"manager_role\": null,\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Mobile Helsinki Maintenance\"\r\n },\r\n \"completed_at\": \"2023-04-04T13:33:26.319Z\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Gas bottle 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": false,\r\n \"can_add_comment_and_files\": false,\r\n \"can_set_in_progress\": true,\r\n \"log_entries\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"user_account\": {\r\n \"id\": null,\r\n \"name\": \"Deleted user\"\r\n },\r\n \"spent_hours\": 21600,\r\n \"begin_time\": \"2023-04-04T07:33:00.000Z\",\r\n \"end_time\": \"2023-04-04T13:33:00.000Z\",\r\n \"created_at\": \"2023-04-04T13:33:24.390Z\",\r\n \"updated_at\": \"2023-04-20T17:18:54.540Z\"\r\n }\r\n ],\r\n \"service_request_products\": [],\r\n \"ongoing_log_by_user\": false,\r\n \"on_hold_reason\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000002\",\r\n \"name\": \"John Doe\",\r\n \"email\": \"john.doe@example.fi\",\r\n \"phone\": \"\",\r\n \"title\": \"Filter must be changed\",\r\n \"description\": \"Please change the filters\",\r\n \"status\": \"completed\",\r\n \"priority\": \"medium\",\r\n \"service_request_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"label\": \"Criticality Classification\",\r\n \"value\": \"Normal\",\r\n \"input_type\": \"select\",\r\n \"required\": false,\r\n \"select_values\": [\r\n \"Normal\",\r\n \"ASAP\"\r\n ],\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"label\": \"Write more details\",\r\n \"value\": \"\",\r\n \"input_type\": \"text\",\r\n \"required\": false,\r\n \"select_values\": [],\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"label\": \"Device Number / Tag Number\",\r\n \"value\": \"A0067\",\r\n \"input_type\": \"string\",\r\n \"required\": false,\r\n \"select_values\": [],\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n ],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"filter replaced \",\r\n \"username\": \"Käyttäjä poistettu\",\r\n \"created_at\": \"2023-03-07T09:21:22.645Z\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Going to chech this\",\r\n \"username\": \"Joe Sys Admin\",\r\n \"created_at\": \"2022-06-08T08:26:18.221Z\"\r\n }\r\n ],\r\n \"created_at\": \"2019-05-13T13:37:28.000Z\",\r\n \"updated_at\": \"2023-03-07T09:21:24.969Z\",\r\n \"manager_role\": null,\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \" Mobile Stockholm Maintenance\"\r\n },\r\n \"completed_at\": \"2023-03-07T09:21:24.968Z\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Gas bottle 2\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 1,\r\n \"spot_required\": false,\r\n \"can_add_comment_and_files\": false,\r\n \"can_set_in_progress\": true,\r\n \"log_entries\": [],\r\n \"service_request_products\": [],\r\n \"ongoing_log_by_user\": false,\r\n \"on_hold_reason\": null\r\n }\r\n]"}],"_postman_id":"0b203df7-bab1-47cc-9405-6c53c6954a2b"},{"name":"/v3/categories_by_service_requests","id":"f4bc34d9-8614-452e-9bc5-d927553fc746","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/categories_by_service_requests","description":"

List of Service Request Categories that are present in Service Requests that user is allowed to see.

\n","urlObject":{"path":["api","v3","categories_by_service_requests"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"c1636265-fb6b-4829-b6d1-7e5842ddce67","name":"/v3/categories_by_service_requests","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/categories_by_service_requests"},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vikailmoitus\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Korjausilmoitus\"\n }\n]"}],"_postman_id":"f4bc34d9-8614-452e-9bc5-d927553fc746"},{"name":"/v3/service_requests_by_count","id":"ebdaf889-6896-4aea-a107-c6e60ea179ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_requests_by_count","description":"

This endpoint retrieves the count of service requests based on their status. The response is in JSON format and includes the count of \"open\" and \"in_progress\" service requests.

\n","urlObject":{"path":["api","v3","service_requests_by_count"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"593229f6-23aa-4d51-9bd0-5d9f88dcec38","name":"/v3/service_requests_by_count","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_requests_by_count"},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"is_open_count\": 9,\n \"in_progress_count\": 46\n}"}],"_postman_id":"ebdaf889-6896-4aea-a107-c6e60ea179ea"},{"name":"/v3/service_requests/filtered","id":"692589dc-b74e-42cc-88f8-c7a050397c55","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"order\": \"ascending\",\r\n \"status\": \"completed\",\r\n \"issue_number\": \"000000011\", // only pass the integer part of the issue number of a sreq to this field\r\n \"categories\": [\r\n \"e76343429-b2f5-440b-96da-1ea343475c07\", // service category's UUID\r\n \"043438487-4b3e-49a6-92de-1b0a34444f08e\"\r\n ],\r\n \"title\": \"service\", // name of the service request\r\n \"created_by\": \"mikko\", // name or email \r\n \"spot_name\": \"machine 1\",\r\n \"col_name\": \"tuotantolaitos lohja\", // collection name\r\n \"cust_name\": \"atmotics\", // customer name\r\n \"roles\": [ // responsible\r\n \"a8227993-4498-4a2b-9e41-51154b37f536\",\r\n \"b8227993-4498-4a2b-9e41-51154b37f536\"\r\n ],\r\n \"priorities\": [\r\n \"high\",\r\n \"medium\",\r\n \"low\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/filtered?q[page]=1","description":"

List Service Requests with pagination and multiple filtering options.

\n

Status options: is_open, in_progress, cancelled, completed, on_hold (only one at a time)

\n

Priority options: low, medium, high

\n

Categories can be found from this endpoint:

\n

api/v3/categories_by_service_requests

\n

Roles can be found from this endpoint:

\n

/api/v3/mobile_user_roles

\n

Order options: ascending or descending
Default order is descending by create date

\n

All possible filtering parameters are listed in the snippet below:

\n
{\n    \"order\": \"ascending\",\n    \"status\": \"completed\",\n    \"issue_number\": \"000000011\", // only pass the integer part of the issue number of a sreq to this field\n    \"categories\": [\n        \"e76343429-b2f5-440b-96da-1ea343475c07\",\n        \"043438487-4b3e-49a6-92de-1b0a34444f08e\"\n    ],\n    \"title\": \"service\", // name of the service request\n    \"created_by\": \"mikko\", // name or email \n    \"spot_name\": \"machine 1\",\n    \"col_name\": \"tuotantolaitos lohja\", // collection name\n    \"cust_name\": \"atmotics\", // customer name\n    \"roles\": [ // responsible\n        \"a8227993-4498-4a2b-9e41-51154b37f536\",\n        \"b8227993-4498-4a2b-9e41-51154b37f536\"\n    ],\n    \"priorities\": [\n        \"high\",\n        \"medium\",\n        \"low\"\n    ]\n}\n\n
\n","urlObject":{"path":["api","v3","service_requests","filtered"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"39beb311-0b82-4647-b829-b974a579ea14","name":"/v3/service_requests/filtered","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"},{"key":"","value":"","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"order\": \"ascending\",\r\n \"status\": \"completed\",\r\n \"issue_number\": \"000000011\", // only pass the integer part of the issue number of a sreq to this field\r\n \"categories\": [\r\n \"e76343429-b2f5-440b-96da-1ea343475c07\",\r\n \"043438487-4b3e-49a6-92de-1b0a34444f08e\"\r\n ],\r\n \"title\": \"service\", // name of the service request\r\n \"created_by\": \"mikko\", // name or email \r\n \"spot_name\": \"machine 1\",\r\n \"col_name\": \"tuotantolaitos lohja\", // collection name\r\n \"cust_name\": \"atmotics\", // customer name\r\n \"roles\": [ // responsible\r\n \"a8227993-4498-4a2b-9e41-51154b37f536\",\r\n \"b8227993-4498-4a2b-9e41-51154b37f536\"\r\n ],\r\n \"priorities\": [\r\n \"high\",\r\n \"medium\",\r\n \"low\"\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/service_requests/filtered?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","service_requests","filtered"],"query":[{"key":"q[page]","value":"1"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000057\",\r\n \"name\": \"{{rand_name}}\",\r\n \"email\": \"{{rand_email}}\",\r\n \"phone\": null,\r\n \"title\": \"Kaasupullo vuotaa\",\r\n \"description\": \"Vuotaa ilmaan\",\r\n \"status\": \"completed\",\r\n \"priority\": \"high\",\r\n \"service_request_fields\": [],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Tämä pitää selvittää\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\r\n }\r\n ],\r\n \"created_at\": \"2020-12-15T12:20:35.546+02:00\",\r\n \"updated_at\": \"2020-12-15T13:46:46.299+02:00\",\r\n \"manager_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Responsible Role for All Service Requests\"\r\n },\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"General Service Request Responsability\"\r\n },\r\n \"completed_at\": \"2020-12-15T13:46:46.299+02:00\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Gas bottle 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": true,\r\n \"can_add_comment_and_files\": true,\r\n \"can_set_in_progress\": true,\r\n \"log_entries\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"{{rand_name}}\"\r\n },\r\n \"spent_hours\": 25200,\r\n \"begin_time\": \"2022-09-21T11:00:00.000+03:00\",\r\n \"end_time\": \"2022-09-21T18:00:00.000+03:00\",\r\n \"created_at\": \"2022-09-30T16:16:56.060+03:00\",\r\n \"updated_at\": \"2022-09-30T16:16:56.060+03:00\"\r\n }\r\n ],\r\n \"service_request_products\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 3.0,\r\n \"product\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Suodatin\"\r\n },\r\n \"warehouse\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Eteläinen Varasto\"\r\n },\r\n \"warehouse_slot\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Ylähylly\"\r\n }\r\n }\r\n ],\r\n \"ongoing_log_by_user\": false\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000058\",\r\n \"name\": \"{{rand_name}}\",\r\n \"email\": \"{{rand_email}}\",\r\n \"phone\": null,\r\n \"title\": \"Hitsauslaite tkee huonoa jälkeä\",\r\n \"description\": \"Saumat pielessä!\",\r\n \"status\": \"completed\",\r\n \"priority\": \"high\",\r\n \"service_request_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"label\": \"Severity\",\r\n \"value\": \"Immediate Actions Required\",\r\n \"input_type\": \"select\"\r\n }\r\n ],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Otettu selvitykseen\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:21:51.535+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Selvitellään vieläkin, varaosia ehkä tarvitaan\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:22:07.524+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Varaosia ei meinaa saada\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:22:15.195+02:00\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Varaosa on vaihdettu\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T13:45:53.319+02:00\"\r\n }\r\n ],\r\n \"created_at\": \"2020-12-15T12:21:30.149+02:00\",\r\n \"updated_at\": \"2020-12-15T13:45:58.750+02:00\",\r\n \"manager_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Responsible Role for All Service Requests\"\r\n },\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Fault Notice Responsability\"\r\n },\r\n \"completed_at\": \"2020-12-15T13:45:58.750+02:00\",\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Welding Machine 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": false,\r\n \"can_add_comment_and_files\": false,\r\n \"can_set_in_progress\": false,\r\n \"log_entries\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"{{rand_name}}\"\r\n },\r\n \"spent_hours\": 25200,\r\n \"begin_time\": \"2022-09-21T11:00:00.000+03:00\",\r\n \"end_time\": \"2022-09-21T18:00:00.000+03:00\",\r\n \"created_at\": \"2022-09-30T16:16:56.060+03:00\",\r\n \"updated_at\": \"2022-09-30T16:16:56.060+03:00\"\r\n }\r\n ],\r\n \"service_request_products\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 3.0,\r\n \"product\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Suodatin\"\r\n },\r\n \"warehouse\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Eteläinen Varasto\"\r\n },\r\n \"warehouse_slot\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Ylähylly\"\r\n }\r\n }\r\n ],\r\n \"ongoing_log_by_user\": true,\r\n \"on_hold_reason\": null\r\n }\r\n]"}],"_postman_id":"692589dc-b74e-42cc-88f8-c7a050397c55"},{"name":"/v3/service_requests/:id","id":"430e24f1-8c28-4999-9146-6f996e9e41a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_requests/:id","description":"

Get the data for a single Service Request by UUID

\n","urlObject":{"path":["api","v3","service_requests",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service request UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"7532b9f9-2e26-4e7f-8a32-12aa5b3227af","name":"/v3/service_requests/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"issue_number\": \"SPTL000000011\",\n \"name\": \"Iron Man\",\n \"email\": \"iron.man@marvel.com\",\n \"phone\": null,\n \"title\": \"Air is not cool enough and keeps noise\",\n \"description\": \"\",\n \"status\": \"is_open\",\n \"priority\": \"high\",\n \"service_request_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Quality Notice or Deviation\",\n \"value\": \"\",\n \"input_type\": \"select\",\n \"required\": false,\n \"select_values\": [\n \"Notice\",\n \"Deviation\"\n ],\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Choose Production Line\",\n \"value\": \"\",\n \"input_type\": \"select\",\n \"required\": false,\n \"select_values\": [\n \"Production Line 1\",\n \"Production Line 2\",\n \"Production Line 3\",\n \"Production Line 4\"\n ],\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [],\n \"completion_comments\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"Ok\",\n \"username\": \"Spiderman Sys Admin\",\n \"created_at\": \"2022-11-25T12:04:08.949Z\",\n \"can_edit\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"we need to figure it out\",\n \"username\": \"Superman Sys Admin\",\n \"created_at\": \"2022-11-25T12:03:57.516Z\",\n \"can_edit\": false\n }\n \n ],\n \"created_at\": \"2021-08-25T13:19:05.000Z\",\n \"updated_at\": \"2023-08-24T07:34:45.348Z\",\n \"manager_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"Safety & Quality Manager\"\n },\n \"user_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"test mobile user role\"\n },\n \"completed_at\": null,\n \"completed_by_name\": null,\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_name\": \"cool system unit Max-Air 8888\",\n \"can_manage\": true,\n \"open_tasks\": 0,\n \"complete_tasks\": 0,\n \"spot_required\": false,\n \"can_add_comment_and_files\": false,\n \"can_set_in_progress\": true,\n \"log_entries\": [],\n \"service_request_products\": [],\n \"ongoing_log_by_user\": false,\n \"on_hold_reason\": \"\",\n \"all_ongoing_logs\": [],\n \"signature_status\": 2, // status code explanation: 0 -> no pending signature; 1 -> all of the inherited signatures are signed; 2 -> all of the direct signatures are signed; 3 -> there are pending signatures\n \"inherited_signature_templates\": false // if true: this task has inherited pending signatures from its task template; if false: this task has no inherited pending signatures from task template\n}"}],"_postman_id":"430e24f1-8c28-4999-9146-6f996e9e41a6"},{"name":"/v3/service_requests/:id/set_in_progress","id":"928543c8-5295-4365-9589-9cc69717e2ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"user_role_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/:id/set_in_progress","description":"

Set Service Request to be in progress by selected user role.

\n

User can set open sreq to in progress for themselves, and is not able to update sreq until they are set as responsible

\n","urlObject":{"path":["api","v3","service_requests",":id","set_in_progress"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service request UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"3364f93a-7e61-4f87-89a1-b74f0fa6c186","name":"/v3/service_requests/:id/set_in_progress","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"user_role_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id/set_in_progress","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id","set_in_progress"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"issue_number\": \"SPTL000000057\",\n \"name\": \"{{rand_name}}\",\n \"email\": \"{{rand_email}}\",\n \"phone\": null,\n \"title\": \"Kaasupullo vuotaa\",\n \"description\": \"Vuotaa ilmaan\",\n \"status\": \"in_progress\",\n \"priority\": \"high\",\n \"service_request_fields\": [],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [],\n \"completion_comments\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"Tämä pitää selvittää\",\n \"username\": \"{{rand_name}}\",\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\n }\n ],\n \"created_at\": \"2020-12-15T12:20:35.546+02:00\",\n \"updated_at\": \"2020-12-15T13:46:46.299+02:00\",\n \"manager_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"Responsible Role for All Service Requests\"\n },\n \"user_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"General Service Request Responsability\"\n },\n \"completed_at\": \"2020-12-15T13:46:46.299+02:00\",\n \"completed_by_name\": null,\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_name\": \"Gas bottle 1\",\n \"can_manage\": true,\n \"open_tasks\": 0,\n \"complete_tasks\": 0,\n \"spot_required\": false,\n \"can_add_comment_and_files\": false,\n \"can_set_in_progress\": true,\n \"log_entries\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"spent_hours\": 25200,\n \"begin_time\": \"2022-09-21T11:00:00.000+03:00\",\n \"end_time\": \"2022-09-21T18:00:00.000+03:00\",\n \"created_at\": \"2022-09-30T16:16:56.060+03:00\",\n \"updated_at\": \"2022-09-30T16:16:56.060+03:00\"\n }\n ],\n \"service_request_products\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"number_of_products\": 3,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Suodatin\"\n },\n \"warehouse\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Eteläinen Varasto\"\n },\n \"warehouse_slot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ylähylly\"\n }\n }\n ],\n \"ongoing_log_by_user\": false,\n \"on_hold_reason\": null\n}"}],"_postman_id":"928543c8-5295-4365-9589-9cc69717e2ae"},{"name":"/v3/service_requests/:id","id":"30a36846-9732-4cc4-a164-f9708120e477","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"name\": \"Name of the Uploader\",\r\n \"email\": \"{{rand_email}}\",\r\n \"title\": \"Title of the Service Request\",\r\n \"description\": \"Description of the Service Request\",\r\n \"phone\": \"+358401231212\",\r\n \"status\": \"on_hold\", // other possible value: completed, cancelled\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"on_hold_reason\": \"spare_part\",\r\n \"service_request_fields_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // UUID of the sreq field that already exsit in hte current sreq\r\n \"value\": \"update value here\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"BASE64 encoded file here\",\r\n \"file_description\": \"Describe file here\",\r\n \"content_type\": \"image/png\", // change according the upload item type\r\n \"uploaded_by\": \"Name of the uploader\"\r\n }\r\n ],\r\n \"service_request_products_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": \"4\",\r\n \"_destroy\": \"1\" // only pass this and id if destroying\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the service request category has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from an external user\r\n ]\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/:id","description":"

Update the Service Request with any of the params supplied.

\n

When updating service request to on hold, you must sen also 'on_hold_reason' in the parameters. Possible values for that parameter are (english translations are in the parentheses):

\n\n

Status Values for Update:

\n\n

To update the status to other values, use the following endpoints:

\n
    \n

  1. Set In Progress:

    \n\n
    2. \n

  2. Forward Service Request:

    \n\n
    3. \n
\n","urlObject":{"path":["api","v3","service_requests",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service request UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"e2230005-30b5-495d-9f95-f4586b689444","name":"/v3/service_requests/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"","value":"","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"name\": \"Name of the Uploader\",\r\n \"email\": \"email@spotilla.com\",\r\n \"title\": \"Title of the Service Request\",\r\n \"description\": \"Description of the Service Request\",\r\n \"phone\": \"+358401231212\",\r\n \"status\": \"on_hold\", // other options: \"completed\", \"cancelled\"\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"on_hold_reason\": \"spare_part\", // only pass this field when status is updated to be: \"on_hold\"\r\n \"service_request_fields_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Insert updated value here\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"BASE64 encoded file here\",\r\n \"file_description\": \"Describe file here\",\r\n \"content_type\": \"image/png\", // change according the upload item type\r\n \"uploaded_by\": \"Name of the uploader\"\r\n }\r\n ],\r\n \"service_request_products_attributes\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // do not pass when creating\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": \"4\",\r\n \"_destroy\": \"1\" // only pass this and id if destroying\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the service request category has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for adding a pending signatures from a spotilla user; Pass the name of the user account to the \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for adding a pending signatures from a external user\r\n ]\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"issue_number\": \"SPTL000000024\",\n \"name\": \"{{rand_name}}\",\n \"email\": \"{{rand_email}}\",\n \"phone\": \"\",\n \"title\": \"Title of Service Request\",\n \"description\": \"Needs to be fixed\",\n \"status\": \"in_progress\",\n \"priority\": \"low\",\n \"service_request_fields\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Vikakoodi\",\n \"value\": \"Insert updated value here\",\n \"input_type\": \"string\"\n }\n ],\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2022-09-02T11:11:53.797+03:00\",\n \"header\": \"emoji_image\",\n \"thumbnail_url\": \"thumb_url_address\",\n \"url\": \"original_url_address\"\n }\n ],\n \"completion_comments\": [],\n \"created_at\": \"2022-01-28T13:19:10.616+02:00\",\n \"updated_at\": \"2022-09-02T11:11:53.735+03:00\",\n \"manager_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"Vuoropäälliköt\"\n },\n \"user_role\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"display_name\": \"Huoltomiehet\"\n },\n \"completed_at\": null,\n \"completed_by_name\": null,\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_name\": \"Tuotantolinja Kemi\",\n \"can_manage\": true,\n \"open_tasks\": 0,\n \"complete_tasks\": 0,\n \"spot_required\": false,\n \"can_add_comment_and_files\": false,\n \"can_set_in_progress\": true,\n \"log_entries\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"spent_hours\": 25200,\n \"begin_time\": \"2022-09-21T11:00:00.000+03:00\",\n \"end_time\": \"2022-09-21T18:00:00.000+03:00\",\n \"created_at\": \"2022-09-30T16:16:56.060+03:00\",\n \"updated_at\": \"2022-09-30T16:16:56.060+03:00\"\n }\n ],\n \"service_request_products\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"number_of_products\": 3,\n \"product\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Suodatin\"\n },\n \"warehouse\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Eteläinen Varasto\"\n },\n \"warehouse_slot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ylähylly\"\n }\n }\n ],\n \"ongoing_log_by_user\": false,\n \"on_hold_reason\": \"spare_part\"\n}"}],"_postman_id":"30a36846-9732-4cc4-a164-f9708120e477"},{"name":"/v3/service_requests","id":"508da490-2fcc-4daa-a392-f61ee3bf612c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"name\": \"Name of the Uploader\",\r\n \"email\": \"{{rand_email}}\",\r\n \"title\": \"Title of the Service Request\", // required field\r\n \"description\": \"Description of the Service Request\",\r\n \"phone\": \"+358401231212\",\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"status\": \"in_progress\",\r\n \"priority\": \"high\", // other options: low, medium\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required field\r\n \"service_request_fields_attributes\": [\r\n {\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Insert value here\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"BASE64 encoded file here\",\r\n \"file_description\": \"Describe file here\",\r\n \"content_type\": \"image/png\", // change according the upload item type\r\n \"uploaded_by\": \"Name of the uploader\"\r\n }\r\n ],\r\n \"service_request_products_attributes\": [ \r\n {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": \"4\"\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the service request category has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for a pending signatures from a spotilla user; Pass the name of the user account to \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for a pending signatures from an external user\r\n ]\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests","description":"

Create a Service Request based on the parameters.

\n

Required params for creation:

\n\n

Other fields are optional

\n","urlObject":{"path":["api","v3","service_requests"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"cf93343a-a68d-4ed4-8f2e-49174b609db1","name":"/v3/service_requests","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"name\": \"Name of the Uploader\",\r\n \"email\": \"{{rand_email}}\",\r\n \"title\": \"Title of the Service Request\",\r\n \"description\": \"Description of the Service Request\",\r\n \"phone\": \"+358401231212\",\r\n \"status\": \"in_progress\",\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"service_request_fields_attributes\": [\r\n {\r\n \"service_request_field_key_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"Insert value here\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"BASE64 encoded file here\",\r\n \"file_description\": \"Describe file here\",\r\n \"content_type\": \"image/png\",\r\n \"uploaded_by\": \"Name of the uploader\"\r\n }\r\n ],\r\n \"signature_templates_attributes\": [ // do not pass this if the service request category has signature templates\r\n { \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \"signature_name\": \"John Husson\", \"external_user\": false }, // example for a pending signatures from a spotilla user; Pass the name of the user account to \"signature_name\" field;\r\n { \"signature_name\": \"Spiderman\"} // example for a pending signatures from a external user\r\n ]\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"issue_number\": \"SPTL000000057\",\r\n \"name\": \"{{rand_name}}\",\r\n \"email\": \"{{rand_email}}\",\r\n \"phone\": \"+358401231212\",\r\n \"title\": \"Title of the Service Request\",\r\n \"description\": \"Description of the Service Request\",\r\n \"status\": \"in_progress\",\r\n \"priority\": \"high\",\r\n \"service_request_fields\": [],\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [],\r\n \"completion_comments\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"comment\": \"Tämä pitää selvittää\",\r\n \"username\": \"{{rand_name}}\",\r\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\r\n }\r\n ],\r\n \"created_at\": \"2020-12-15T12:20:35.546+02:00\",\r\n \"updated_at\": \"2020-12-15T13:46:46.299+02:00\",\r\n \"manager_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"Responsible Role for All Service Requests\"\r\n },\r\n \"user_role\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"display_name\": \"General Service Request Responsability\"\r\n },\r\n \"completed_at\": null,\r\n \"completed_by_name\": null,\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_name\": \"Gas bottle 1\",\r\n \"can_manage\": true,\r\n \"open_tasks\": 0,\r\n \"complete_tasks\": 0,\r\n \"spot_required\": true,\r\n \"can_add_comment_and_files\": true,\r\n \"can_set_in_progress\": true,\r\n \"ongoing_log_by_user\": false,\r\n \"on_hold_reason\": null\r\n}"}],"_postman_id":"508da490-2fcc-4daa-a392-f61ee3bf612c"},{"name":"/v3/service_requests/:id/forward","id":"958c3b74-27ed-4c7a-85ea-45365e3969d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/:id/forward","description":"

forward the current servie request to another service request category

\n","urlObject":{"path":["api","v3","service_requests",":id","forward"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"87153795-0868-4907-867f-5f75bccc3102","name":"/v3/service_requests/:id/forward","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_request\": {\r\n \"name\": \"Name of the Uploader\",\r\n \"email\": \"email@spotilla.com\",\r\n \"title\": \"Title of the Service Request\",\r\n \"description\": \"Description of the Service Request\",\r\n \"phone\": \"+358401231212\",\r\n \"status\": \"in_progress\",\r\n \"spot_id\": \"6affed92-c797-4630-a84f-1e03fd1f6ec1\",\r\n \"service_request_category_id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\",\r\n \"service_request_fields_attributes\": [\r\n {\r\n \"service_request_field_key_id\": \"d239bc42-b0c5-4675-816e-deac3a178dd8\",\r\n \"value\": \"Insert value here\"\r\n }\r\n ],\r\n \"upload_items_attributes\": [\r\n {\r\n \"file_base\": \"BASE64 encoded file here\",\r\n \"file_description\": \"Describe file here\",\r\n \"content_type\": \"image/png\",\r\n \"uploaded_by\": \"Name of the uploader\"\r\n }\r\n ]\r\n }\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id/forward","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id","forward"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Forwarded successfully\"\r\n}"}],"_postman_id":"958c3b74-27ed-4c7a-85ea-45365e3969d5"},{"name":"/v3/service_requests/:id/files","id":"4e684951-4b09-4038-928e-89104aed897f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/service_requests/files","description":"

This endpoint retrieves a list of files related to service requests. The request does not require any specific parameters. The response will include an array of objects, where each object represents a file and contains the following properties:

\n\n","urlObject":{"path":["api","v3","service_requests","files"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"9bd9e46c-54a9-4d2f-85e6-33b4a48a544a","name":"/v3/service_requests/:id/files","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v/service_requests/:id/files","host":["api","spotilla","fi"],"path":["api","v","service_requests",":id","files"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"text/plain\",\n \"created_at\": \"2024-07-01T09:28:43.460+03:00\",\n \"header\": \"iconPaths.txt\",\n \"uploaded_by\": \"{{rand_name}}\",\n \"thumbnail_url\": \"http://api.mahtavadeveloper.com:3000/assets/application_thumb.png\",\n \"url\": \"http://api.mahtavadeveloper.com:3000/api/v1/files/original/ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_type\": \"ServiceRequest\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n]"}],"_postman_id":"4e684951-4b09-4038-928e-89104aed897f"}],"id":"5cb8ac03-621f-4d25-ad7e-cf91c40b8a5e","_postman_id":"5cb8ac03-621f-4d25-ad7e-cf91c40b8a5e","description":""},{"name":"Service Request Comments","item":[{"name":"/v3/service_requests/:service_request_id/comments","id":"a39fb1a0-58f5-4f6e-bf36-77928205e4c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/service_requests/:id/comments","description":"

Retrieve Service Request Comments

\n

This endpoint returns the comments of a specific service request.

\n

Request Body
This request does not require a request body.

\n","urlObject":{"path":["api","v3","service_requests",":id","comments"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service requests UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"9b6d89d0-399c-4652-9449-105637fe69a0","name":"/v3/service_requests/:service_request_id/comments","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id/comments","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id","comments"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"}]}},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"Tämä pitää selvittää\",\n \"username\": \"{{rand_name}}\",\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\n }\n]"}],"_postman_id":"a39fb1a0-58f5-4f6e-bf36-77928205e4c4"},{"name":"/v3/service_requests/:service_request_id/comments","id":"dd77eb0f-4ab9-41fe-b49b-712f44cd3abf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"This is the comment.\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/:service_request_id/comments","description":"

create a comment for a service request.

\n","urlObject":{"path":["api","v3","service_requests",":service_request_id","comments"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"service_request_id"}]}},"response":[{"id":"711090c2-e802-4b59-bffb-2df8993f03b2","name":"/v3/service_requests/:service_request_id/comments","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"This is the comment.\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v1/service_requests/:sevice_request_id/comments","host":["api","spotilla","fi"],"path":["api","v1","service_requests",":sevice_request_id","comments"],"variable":[{"key":"sevice_request_id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"This is the comment.\",\n \"username\": \"Mikko Mallikas\",\n \"created_at\": \"2020-12-15T12:21:40.989+02:00\"\n }\n]"}],"_postman_id":"dd77eb0f-4ab9-41fe-b49b-712f44cd3abf"},{"name":"/v3/service_requests/:service_request_id/comments/:id","id":"5d5429a0-b0eb-4e56-abcc-20fb06a44ad8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"update comment\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/service_requests/:service_request_id/comments/:id","description":"

This endpoint allows you to update a comment for a specific service request.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","service_requests",":service_request_id","comments",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service request UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"service_request_id"},{"description":{"content":"

comment UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"3d5fb735-0e2c-43c0-9770-b188459482ef","name":"/v3/service_requests/:service_request_id/comments/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"comment\": {\r\n \"comment\": \"update comment\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:service_request_id/comments/:id","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":service_request_id","comments",":id"],"variable":[{"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request UUID"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"comment UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"comment\": \"update comment\",\n \"username\": \"test manager account\",\n \"created_at\": \"2024-06-25T09:29:15.623Z\"\n}"}],"_postman_id":"5d5429a0-b0eb-4e56-abcc-20fb06a44ad8"}],"id":"53cba7e0-7eb4-4bd3-95d1-60c4bdfdcbb1","_postman_id":"53cba7e0-7eb4-4bd3-95d1-60c4bdfdcbb1","description":""},{"name":"Service Request Categories","item":[{"name":"/v3/service_request_categories","id":"0e1d7dad-fddc-4565-ab14-641b3a6ce6b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_request_categories?as=by_create","description":"

List of Service Request Categories user is allowed to read.

\n

Optional parameters:

\n

as=by_create: Lists only those categories that user is allowed to use to create new Service Requests.

\n

/api/v3/service_request_categories?as=by_create

\n

Without the optional paramter: the reponse will list all categories for mobile.

\n","urlObject":{"path":["api","v3","service_request_categories"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"as","value":"by_create"}],"variable":[]}},"response":[{"id":"cc6054c2-f846-4764-88e1-8f5ff49fbdf9","name":"/v3/service_request_categories","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/service_request_categories?as=by_create","host":["api","spotilla","fi"],"path":["api","v3","service_request_categories"],"query":[{"key":"as","value":"by_create","description":"optional params"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vikailmoitus\",\n \"description\": \"\",\n \"service_request_field_keys\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Ilmoituksia yhteensä\",\n \"input_type\": \"number\",\n \"value_selections\": [],\n \"order\": 0,\n \"required\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotekoodi\",\n \"input_type\": \"string\",\n \"value_selections\": [],\n \"order\": 1,\n \"required\": false\n }\n ],\n \"spot_required\": true,\n \"comment_and_files_mobile\": true,\n \"show_open_requests\": true,\n \"user_role_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n }\n]"}],"_postman_id":"0e1d7dad-fddc-4565-ab14-641b3a6ce6b6"},{"name":"/v3/service_request_categories/:id","id":"676ed286-8a11-44e2-8c50-241a019f77ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/service_request_categories/:id","description":"

This endpoint returns information about a specific service request category by its UUID.

\n","urlObject":{"path":["api","v3","service_request_categories",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

request category's UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"7035f255-37ba-4c40-aba2-3b6d05e3feab","name":"/v3/service_request_categories/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"","value":"","type":"text","disabled":true}],"url":{"raw":"api.spotilla.fi/api/v3/service_request_categories/:id","host":["api","spotilla","fi"],"path":["api","v3","service_request_categories",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"service request category UUID"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Total-Pages","value":"4","description":"","type":"text"},{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vikailmoitus\",\n \"description\": \"\",\n \"service_request_field_keys\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Ilmoituksia yhteensä\",\n \"input_type\": \"number\",\n \"value_selections\": [],\n \"order\": 0,\n \"required\": false\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"label\": \"Tuotekoodi\",\n \"input_type\": \"string\",\n \"value_selections\": [],\n \"order\": 1,\n \"required\": false\n }\n ],\n \"spot_required\": true,\n \"comment_and_files_mobile\": true,\n \"show_open_requests\": true,\n \"user_role_id\": null\n}"}],"_postman_id":"676ed286-8a11-44e2-8c50-241a019f77ff"}],"id":"35c99d94-8fce-4941-b2e1-ca50c797f6bb","_postman_id":"35c99d94-8fce-4941-b2e1-ca50c797f6bb","description":""}],"id":"98a2d7bb-03fe-4791-9e64-5adba1dfb5f8","_postman_id":"98a2d7bb-03fe-4791-9e64-5adba1dfb5f8","description":""},{"name":"Messages","item":[{"name":"Messages","item":[{"name":"/v3/messages","id":"6376f1ce-051a-4fd1-af50-022d478cfbb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/messages/?q[page]=1","description":"

This endpoint makes an HTTP GET request to retrieve messages from the spotilla API.

\n

The request includes a optional query parameter \"page\" which specifies the page number of the messages to retrieve.

\n","urlObject":{"path":["api","v3","messages",""],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":"1"}],"variable":[]}},"response":[{"id":"e84cd5ff-d159-4b50-84f4-3cf2481ae446","name":"/v3/messages","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/messages/?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","messages",""],"query":[{"key":"q[page]","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Current-Page","value":"1","description":"","type":"text"},{"key":"X-Total-Pages","value":"3","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"body\": \"test\",\n \"date_time_added\": \"2021-04-22T11:42:33.902+03:00\",\n \"spot\": \"Compressiom machine 2\",\n \"user\": \"Nilla Noheva\",\n \"user_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"priority\": \"medium\",\n \"message_type\": \"Machine Diary Note\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"header\": \"upload item\",\n \"thumbnail_url\": \"thumbnail url\",\n \"url\": \"url...\"\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"body\": \"test\",\n \"date_time_added\": \"2021-04-22T11:24:35.137+03:00\",\n \"spot\": \"Gas bottle 8\",\n \"user\": null,\n \"user_id\": null,\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"priority\": \"medium\",\n \"message_type\": \"Machine Diary Note\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": []\n }\n]"}],"_postman_id":"6376f1ce-051a-4fd1-af50-022d478cfbb1"},{"name":"/v3/spots/:id/messages","id":"6a2033b8-31c7-445b-9f10-64d7f6409c88","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/:spot_id/messages","description":"

Get Spot Messages

\n

This endpoint retrieves messages for a specific spot.

\n","urlObject":{"path":["api","v3","spots",":spot_id","messages"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"fe6c92a2-e5e5-4590-a7fa-ce818e180371","name":"/v3/spots/:id/messages","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/spots/:spot_id/messages","host":["api","spotilla","fi"],"path":["api","v3","spots",":spot_id","messages"],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"body\": \"test\",\n \"date_time_added\": \"2021-04-22T11:42:33.902+03:00\",\n \"spot\": \"Compressiom machine 2\",\n \"user\": \"Nilla Noheva\",\n \"user_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"priority\": \"medium\",\n \"message_type\": \"Machine Diary Note\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"header\": \"upload item\",\n \"thumbnail_url\": \"thumbnail url\",\n \"url\": \"url...\"\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"body\": \"test\",\n \"date_time_added\": \"2021-04-22T11:24:35.137+03:00\",\n \"spot\": \"Gas bottle 8\",\n \"user\": null,\n \"user_id\": null,\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"priority\": \"medium\",\n \"message_type\": \"Machine Diary Note\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_items\": []\n }\n]"}],"_postman_id":"6a2033b8-31c7-445b-9f10-64d7f6409c88"},{"name":"/v3/spots/:spot_id/messages","id":"9609c7b5-b835-4898-b990-288e188b05ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n\t\"message\": {\r\n\t\t\"body\": \"Tilataan\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // (optional),\r\n \"created_at\": \"2023-04-21 11:42:33\", // (optional),\r\n \"priority\": \"high\", // (optional),\r\n \"upload_items_attributes\": [ // (optional)\r\n {\r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\"\r\n }\r\n ]\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:spot_id/messages","description":"

Create a message for a spot

\n

Details:

\n

body: (required) body accepts only values that conform to message_type,

\n

priority: (optional) enum, the default value is \"medium\". The other two option are \"high\", and \"low\". If you don't pass this field, the default value (\"medium\") will be assigned to the message

\n

message_type_id: (optional) an message type uuid that authenticated user has access to

\n

created_at: (optional), datetime as string, only send when you want to prevent automatic timestamp

\n

upload_items_attributes (array): An array of objects containing details about the uploaded items. Each object should include:

\n\n","urlObject":{"path":["api","v3","spots",":spot_id","messages"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"spot_id"}]}},"response":[{"id":"60804dfc-3b30-4edb-bd9b-9a5770bf0699","name":"/v3/spots/:id/messages","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n\t\"message\": {\r\n\t\t\"body\": \"Tilataan\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2023-04-21 11:42:33\",\r\n \"priority\": \"high\",\r\n \"upload_items_attributes\": [\r\n { \r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\"\r\n }\r\n ]\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/spots/:spot_id/messages","host":["api","spotilla","fi"],"path":["api","v3","spots",":spot_id","messages"],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"body\": \"Tilataan\",\r\n \"date_time_added\": \"2023-04-21T11:42:33.902+03:00\",\r\n \"spot\": \"Compressiom machine 2\",\r\n \"user\": \"Nilla Noheva\",\r\n \"user_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"priority\": \"high\",\r\n \"message_type\": \"Machine Diary Note\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"upload_items\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"content_type\": \"image/png\",\r\n \"header\": \"Heart eyes emoji image\",\r\n \"thumbnail_url\": \"https://api.spotilla.fi/api/v1/files/thumb/5ebfd1aa-d790-42cc-abc2-433245fa9b58\",\r\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/5ebfd1aa-d790-42cc-abc2-433245fa9b58\"\r\n }\r\n ]\r\n}"}],"_postman_id":"9609c7b5-b835-4898-b990-288e188b05ac"},{"name":"/v3/spots/:id/messages/:id","id":"1c58380e-355e-4906-8eef-dd5bb407acd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\n\t\"message\": {\n\t\t\"body\": \"test\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"created_at\": \"2023-04-22 12:42:33\",\n \"priority\": \"low\",\n \"upload_items_attributes\": [\n { \n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // don't pass this when creating\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\n \"content_type\": \"image/png\",\n \"file_description\": \"Heart eyes emoji image\",\n \"_destroy\": true // pass this and id field only when destroy\n }\n ]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spots/:spot_id/messages/:id","description":"

Update Spot Message

\n

This endpoint allows the user to update a specific message within a spot. The spot_id and id parameters in the endpoint URL specify the spot and the message to be updated.

\n

Request Body

\n

The request body should be in the raw format and can include any of the following parameters:

\n\n","urlObject":{"path":["api","v3","spots",":spot_id","messages",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"},{"description":{"content":"

message UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"187cdfc3-bbfc-4bef-8192-cbf0286819f9","name":"/v3/spots/:spot_id/messages/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"message\": {\r\n\t\t\"body\": \"test\",\r\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2023-04-22 12:42:33\",\r\n \"priority\": \"low\",\r\n \"upload_items_attributes\": [\r\n { \r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // don't pass this when creating\r\n \"file_base\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3/OAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAANCSURBVEiJtZZPbBtFFMZ/M7ubXdtdb1xSFyeilBapySVU8h8OoFaooFSqiihIVIpQBKci6KEg9Q6H9kovIHoCIVQJJCKE1ENFjnAgcaSGC6rEnxBwA04Tx43t2FnvDAfjkNibxgHxnWb2e/u992bee7tCa00YFsffekFY+nUzFtjW0LrvjRXrCDIAaPLlW0nHL0SsZtVoaF98mLrx3pdhOqLtYPHChahZcYYO7KvPFxvRl5XPp1sN3adWiD1ZAqD6XYK1b/dvE5IWryTt2udLFedwc1+9kLp+vbbpoDh+6TklxBeAi9TL0taeWpdmZzQDry0AcO+jQ12RyohqqoYoo8RDwJrU+qXkjWtfi8Xxt58BdQuwQs9qC/afLwCw8tnQbqYAPsgxE1S6F3EAIXux2oQFKm0ihMsOF71dHYx+f3NND68ghCu1YIoePPQN1pGRABkJ6Bus96CutRZMydTl+TvuiRW1m3n0eDl0vRPcEysqdXn+jsQPsrHMquGeXEaY4Yk4wxWcY5V/9scqOMOVUFthatyTy8QyqwZ+kDURKoMWxNKr2EeqVKcTNOajqKoBgOE28U4tdQl5p5bwCw7BWquaZSzAPlwjlithJtp3pTImSqQRrb2Z8PHGigD4RZuNX6JYj6wj7O4TFLbCO/Mn/m8R+h6rYSUb3ekokRY6f/YukArN979jcW+V/S8g0eT/N3VN3kTqWbQ428m9/8k0P/1aIhF36PccEl6EhOcAUCrXKZXXWS3XKd2vc/TRBG9O5ELC17MmWubD2nKhUKZa26Ba2+D3P+4/MNCFwg59oWVeYhkzgN/JDR8deKBoD7Y+ljEjGZ0sosXVTvbc6RHirr2reNy1OXd6pJsQ+gqjk8VWFYmHrwBzW/n+uMPFiRwHB2I7ih8ciHFxIkd/3Omk5tCDV1t+2nNu5sxxpDFNx+huNhVT3/zMDz8usXC3ddaHBj1GHj/As08fwTS7Kt1HBTmyN29vdwAw+/wbwLVOJ3uAD1wi/dUH7Qei66PfyuRj4Ik9is+hglfbkbfR3cnZm7chlUWLdwmprtCohX4HUtlOcQjLYCu+fzGJH2QRKvP3UNz8bWk1qMxjGTOMThZ3kvgLI5AzFfo379UAAAAASUVORK5CYII=\",\r\n \"content_type\": \"image/png\",\r\n \"file_description\": \"Heart eyes emoji image\",\r\n \"_destroy\": true // pass this and id field only when destroy\r\n }\r\n ]\r\n\t}\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v1/spots/:spot_id/messages/:id","host":["api","spotilla","fi"],"path":["api","v1","spots",":spot_id","messages",":id"],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"message UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"body\": \"test\",\n \"date_time_added\": \"2021-04-22T12:42:33.902+03:00\",\n \"spot\": \"Production Line 2\",\n \"user\": \"Nilla Noheva\",\n \"user_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"priority\": \"low\",\n \"message_type\": \"Machine Diary Note\",\n \"message_type_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"upload_item\": []\n}"}],"_postman_id":"1c58380e-355e-4906-8eef-dd5bb407acd9"}],"id":"b3992745-a47e-4dc1-a5fa-6fcd7626e3b9","_postman_id":"b3992745-a47e-4dc1-a5fa-6fcd7626e3b9","description":""},{"name":"Message Types","item":[{"name":"/v3/message_types","id":"5f0bf817-1af9-48d0-aa5a-0f3bd5088dae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/message_types","description":"

Get Message Types

\n

This endpoint retrieves a list of message types available in the Spotilla system.

\n","urlObject":{"path":["api","v3","message_types"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"4187e4d2-2678-4de2-b1bd-10d72aac8bed","name":"/v3/message_types","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/message_types"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Part Order\",\n \"description\": \"\",\n \"datatype\": \"string\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Maintenance Note\",\n \"description\": \"Maintenance Notification for all kind of extra information\",\n \"datatype\": \"string\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"System_notification_phone\",\n \"description\": \"This message type is used for system update for android phone.\",\n \"datatype\": \"string\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"phone chip production metal supply order\",\n \"description\": \"This is message type is used for make new order for phone chip production.\",\n \"datatype\": \"string\"\n }\n]"}],"_postman_id":"5f0bf817-1af9-48d0-aa5a-0f3bd5088dae"}],"id":"e6ec3063-07ae-4c00-aaab-44fcf1ba1636","_postman_id":"e6ec3063-07ae-4c00-aaab-44fcf1ba1636","description":""}],"id":"da1802d9-6884-4445-8ef7-99aeeb1b1c9d","_postman_id":"da1802d9-6884-4445-8ef7-99aeeb1b1c9d","description":""},{"name":"Costs (Tasks, Service Requests, Device Costs)","item":[{"name":"/v3/sub_cost_unit_types","id":"189c5968-3831-4ae6-a942-e5924e64f8f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/sub_cost_unit_types","description":"

Get a list of possible unit_types for SubCost.

\n

Send value of the id when creating/updating other cost. Name field only shows translated text for the user.

\n","urlObject":{"path":["api","v3","sub_cost_unit_types"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"d07b1d30-7fb0-4fec-bdf0-f28ccc8b8a4a","name":"/v3/sub_cost_unit_types","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"sRFE-pNPCMCy4zV6vAHU","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/sub_cost_unit_types"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"pcs\",\n \"name\": \"kpl\"\n },\n {\n \"id\": \"km\",\n \"name\": \"km\"\n },\n {\n \"id\": \"m\",\n \"name\": \"m\"\n },\n {\n \"id\": \"cm\",\n \"name\": \"cm\"\n },\n {\n \"id\": \"mm\",\n \"name\": \"mm\"\n },\n {\n \"id\": \"km2\",\n \"name\": \"km2\"\n },\n {\n \"id\": \"m2\",\n \"name\": \"m2\"\n },\n {\n \"id\": \"cm2\",\n \"name\": \"cm2\"\n },\n {\n \"id\": \"km3\",\n \"name\": \"km3\"\n },\n {\n \"id\": \"m3\",\n \"name\": \"m3\"\n },\n {\n \"id\": \"cm3\",\n \"name\": \"cm3\"\n },\n {\n \"id\": \"l\",\n \"name\": \"l\"\n },\n {\n \"id\": \"ml\",\n \"name\": \"ml\"\n },\n {\n \"id\": \"kg\",\n \"name\": \"kg\"\n },\n {\n \"id\": \"g\",\n \"name\": \"g\"\n },\n {\n \"id\": \"mg\",\n \"name\": \"mg\"\n },\n {\n \"id\": \"A\",\n \"name\": \"A\"\n },\n {\n \"id\": \"Ah\",\n \"name\": \"Ah\"\n },\n {\n \"id\": \"A_min\",\n \"name\": \"A_min\"\n },\n {\n \"id\": \"bag\",\n \"name\": \"bag\"\n },\n {\n \"id\": \"bar\",\n \"name\": \"bar\"\n },\n {\n \"id\": \"bottle\",\n \"name\": \"bottle\"\n },\n {\n \"id\": \"box\",\n \"name\": \"box\"\n },\n {\n \"id\": \"can\",\n \"name\": \"can\"\n },\n {\n \"id\": \"cl\",\n \"name\": \"cl\"\n },\n {\n \"id\": \"day\",\n \"name\": \"day\"\n },\n {\n \"id\": \"dl\",\n \"name\": \"dl\"\n },\n {\n \"id\": \"doz\",\n \"name\": \"doz\"\n },\n {\n \"id\": \"doz_pack\",\n \"name\": \"doz_pack\"\n },\n {\n \"id\": \"8_pack\",\n \"name\": \"8_pack\"\n },\n {\n \"id\": \"EJ\",\n \"name\": \"EJ\"\n },\n {\n \"id\": \"5_pack\",\n \"name\": \"5_pack\"\n },\n {\n \"id\": \"ft\",\n \"name\": \"ft\"\n },\n {\n \"id\": \"4_pack\",\n \"name\": \"4_pack\"\n },\n {\n \"id\": \"full_day\",\n \"name\": \"full_day\"\n },\n {\n \"id\": \"gal_uk\",\n \"name\": \"gal_uk\"\n },\n {\n \"id\": \"gal_us\",\n \"name\": \"gal_us\"\n },\n {\n \"id\": \"Gbit\",\n \"name\": \"Gbit\"\n },\n {\n \"id\": \"GB\",\n \"name\": \"GB\"\n },\n {\n \"id\": \"GJ\",\n \"name\": \"GJ\"\n },\n {\n \"id\": \"GW\",\n \"name\": \"GW\"\n },\n {\n \"id\": \"GWh\",\n \"name\": \"GWh\"\n },\n {\n \"id\": \"g/m3\",\n \"name\": \"g/m3\"\n },\n {\n \"id\": \"g/m2\",\n \"name\": \"g/m2\"\n },\n {\n \"id\": \"ha\",\n \"name\": \"ha\"\n },\n {\n \"id\": \"h\",\n \"name\": \"h\"\n },\n {\n \"id\": \"hundred\",\n \"name\": \"hundred\"\n },\n {\n \"id\": \"in\",\n \"name\": \"in\"\n },\n {\n \"id\": \"jar\",\n \"name\": \"jar\"\n },\n {\n \"id\": \"J\",\n \"name\": \"J\"\n },\n {\n \"id\": \"W\",\n \"name\": \"W\"\n },\n {\n \"id\": \"kAh\",\n \"name\": \"kAh\"\n },\n {\n \"id\": \"kbit\",\n \"name\": \"kbit\"\n },\n {\n \"id\": \"kB\",\n \"name\": \"kB\"\n },\n {\n \"id\": \"kg/m3\",\n \"name\": \"kg/m3\"\n },\n {\n \"id\": \"kg/m2\",\n \"name\": \"kg/m2\"\n },\n {\n \"id\": \"kJ\",\n \"name\": \"kJ\"\n },\n {\n \"id\": \"kPa\",\n \"name\": \"kPa\"\n },\n {\n \"id\": \"kV\",\n \"name\": \"kV\"\n },\n {\n \"id\": \"kW\",\n \"name\": \"kW\"\n },\n {\n \"id\": \"kWh\",\n \"name\": \"kWh\"\n },\n {\n \"id\": \"lm\",\n \"name\": \"lm\"\n },\n {\n \"id\": \"lot\",\n \"name\": \"lot\"\n },\n {\n \"id\": \"Mbit\",\n \"name\": \"Mbit\"\n },\n {\n \"id\": \"MB\",\n \"name\": \"MB\"\n },\n {\n \"id\": \"MWh\",\n \"name\": \"MWh\"\n },\n {\n \"id\": \"mi\",\n \"name\": \"mi\"\n },\n {\n \"id\": \"mAh\",\n \"name\": \"mAh\"\n },\n {\n \"id\": \"mg/m3\",\n \"name\": \"mg/m3\"\n },\n {\n \"id\": \"mJ\",\n \"name\": \"mJ\"\n },\n {\n \"id\": \"mV\",\n \"name\": \"mV\"\n },\n {\n \"id\": \"mW\",\n \"name\": \"mW\"\n },\n {\n \"id\": \"min\",\n \"name\": \"min\"\n },\n {\n \"id\": \"month\",\n \"name\": \"month\"\n },\n {\n \"id\": \"9_pack\",\n \"name\": \"9_pack\"\n },\n {\n \"id\": \"no_unit\",\n \"name\": \"no_unit\"\n },\n {\n \"id\": \"words\",\n \"name\": \"words\"\n },\n {\n \"id\": \"oz\",\n \"name\": \"oz\"\n },\n {\n \"id\": \"page\",\n \"name\": \"page\"\n },\n {\n \"id\": \"pair\",\n \"name\": \"pair\"\n },\n {\n \"id\": \"pallet\",\n \"name\": \"pallet\"\n },\n {\n \"id\": \"parcel\",\n \"name\": \"parcel\"\n },\n {\n \"id\": \"Pa\",\n \"name\": \"Pa\"\n },\n {\n \"id\": \"person\",\n \"name\": \"person\"\n },\n {\n \"id\": \"PJ\",\n \"name\": \"PJ\"\n },\n {\n \"id\": \"pt_uk\",\n \"name\": \"pt_uk\"\n },\n {\n \"id\": \"pt_us\",\n \"name\": \"pt_us\"\n },\n {\n \"id\": \"plate\",\n \"name\": \"plate\"\n },\n {\n \"id\": \"lb\",\n \"name\": \"lb\"\n },\n {\n \"id\": \"roll\",\n \"name\": \"roll\"\n },\n {\n \"id\": \"sack\",\n \"name\": \"sack\"\n },\n {\n \"id\": \"unit\",\n \"name\": \"unit\"\n },\n {\n \"id\": \"s\",\n \"name\": \"s\"\n },\n {\n \"id\": \"series\",\n \"name\": \"series\"\n },\n {\n \"id\": \"set\",\n \"name\": \"set\"\n },\n {\n \"id\": \"7_pack\",\n \"name\": \"7_pack\"\n },\n {\n \"id\": \"6_pack\",\n \"name\": \"6_pack\"\n },\n {\n \"id\": \"st\",\n \"name\": \"st\"\n },\n {\n \"id\": \"10_pack\",\n \"name\": \"10_pack\"\n },\n {\n \"id\": \"Tbit\",\n \"name\": \"Tbit\"\n },\n {\n \"id\": \"TJ\",\n \"name\": \"TJ\"\n },\n {\n \"id\": \"TW\",\n \"name\": \"TW\"\n },\n {\n \"id\": \"TWh\",\n \"name\": \"TWh\"\n },\n {\n \"id\": \"3_pack\",\n \"name\": \"3_pack\"\n },\n {\n \"id\": \"t\",\n \"name\": \"t\"\n },\n {\n \"id\": \"tube\",\n \"name\": \"tube\"\n },\n {\n \"id\": \"2_pack\",\n \"name\": \"2_pack\"\n },\n {\n \"id\": \"W\",\n \"name\": \"W\"\n },\n {\n \"id\": \"Wh\",\n \"name\": \"Wh\"\n },\n {\n \"id\": \"week\",\n \"name\": \"week\"\n },\n {\n \"id\": \"wrap\",\n \"name\": \"wrap\"\n },\n {\n \"id\": \"yd\",\n \"name\": \"yd\"\n },\n {\n \"id\": \"yr\",\n \"name\": \"yr\"\n }\n]"}],"_postman_id":"189c5968-3831-4ae6-a942-e5924e64f8f1"},{"name":"/v3/sub_costs/:id","id":"7a289b0b-e674-47f0-b842-f4a485dd925a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/sub_costs/:id","description":"

Get SubCost Details

\n

This endpoint returns the details of a specific subcost identified by its ID.

\n

Request Body

\n

This is a GET request and does not require a request body.

\n","urlObject":{"path":["api","v3","sub_costs",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"1d9656ff-7293-4df4-8771-4bcc9d0febfa","name":"/v3/sub_costs/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/sub_costs/:id","host":["api","spotilla","fi"],"path":["api","v3","sub_costs",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": null,\n \"service_request\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vuotava hana\"\n },\n \"title\": \"UPPIS\",\n \"additional_details\": null,\n \"value\": 10500.0,\n \"discount_percentage\": null,\n \"unit_amount\": 100.0,\n \"unit_type\": \"pcs\",\n \"unit_price\": \"105.0\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"created_at\": \"2025-01-10T14:52:45.929+02:00\",\n \"updated_at\": \"2025-01-10T14:53:30.306+02:00\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2025-01-10T14:55:26.318+02:00\",\n \"header\": \"example.png\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae22214f-9512-490c-8d6a-a43e3ed3333\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae62224f-9512-490c-8d6a-a43e3ed22322\",\n \"task\": null\n }\n ],\n \"can_edit_cost\": true\n}"}],"_postman_id":"7a289b0b-e674-47f0-b842-f4a485dd925a"},{"name":"/v3/sub_costs","id":"176b35e4-5beb-4292-a844-1f958224e453","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/sub_costs?service_request_category_ids=[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]&customer_ids=[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]&spot_ids=[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]&begin_date=2024-09-18&end_date=2025-09-18&q[page]","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint retrieves detailed information regarding work costs associated with specific service requests. It allows users to filter the results based on various parameters, including service request category IDs, customer IDs, spot IDs, and a date range.

\n

Request Parameters

\n\n","urlObject":{"path":["api","v3","sub_costs"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

array of service request category ids

\n","type":"text/plain"},"key":"service_request_category_ids","value":"[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]"},{"description":{"content":"

array of customer uuids

\n","type":"text/plain"},"key":"customer_ids","value":"[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]"},{"description":{"content":"

array of spot uuids

\n","type":"text/plain"},"key":"spot_ids","value":"[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]"},{"description":{"content":"

begin date of the work costs creation time

\n","type":"text/plain"},"key":"begin_date","value":"2024-09-18"},{"description":{"content":"

end date of the work costs creation time

\n","type":"text/plain"},"key":"end_date","value":"2025-09-18"},{"key":"q[page]","value":null},{"disabled":true,"description":{"content":"

array of customer contract ids

\n","type":"text/plain"},"key":"customer_contract_ids","value":"[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"]"}],"variable":[]}},"response":[{"id":"9008ec7a-b1cd-4e96-be08-b46fa60f6a6e","name":"/v3/sub_costs","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/sub_costs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_type\": \"ServiceRequest\",\n \"parent_name\": \"St_22-3-2025\",\n \"curr_parent_name\": \"St_22-3-2025\",\n \"completed_at\": \"2025-04-11T07:18:21.941+03:00\",\n \"completed_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"example spot\"\n },\n \"customer\": null,\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"rootti\",\n \"collection_path\": \"rootti\"\n },\n \"collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"order_num\": null,\n \"internal_reference\": null,\n \"external_reference\": null,\n \"estimated_cost\": null,\n \"work_order\": null,\n \"task_template\": null,\n \"task_form\": null,\n \"service_request_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Maileri testingiä\"\n },\n \"issue_number\": \"SPTL000007012\",\n \"billable_task\": null,\n \"customer_contract_task_setting\": null,\n \"data\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2/ServiceRequestProduct\",\n \"section\": \"ServiceRequestProduct\",\n \"total_sum\": 0.0,\n \"data\": [\n {\n \"service_request_product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_name\": \"Product 7\",\n \"product_code\": \"A7\",\n \"unit_type\": \"pcs\",\n \"unit_amount\": 1.0,\n \"unit_price\": 0.0,\n \"non_discount_sum\": 0.0,\n \"created_at\": \"2025-04-01T17:38:20.482+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.510+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"ServiceRequestProduct\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"service_request_product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_name\": \"Product 7\",\n \"product_code\": \"A7\",\n \"unit_type\": \"pcs\",\n \"unit_amount\": 1.0,\n \"unit_price\": 0.0,\n \"non_discount_sum\": 0.0,\n \"created_at\": \"2025-04-01T16:37:45.965+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.487+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"ServiceRequestProduct\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n }\n ]\n },\n {\n \"id\": \"{{uuid}}/LogEntry\",\n \"section\": \"LogEntry\",\n \"total_sum\": 0.0,\n \"data\": [\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 692,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T19:46:51.474+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.456+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 5,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T19:27:41.065+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.435+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 1,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T19:26:55.502+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.417+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\":\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 2,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T13:06:30.112+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.401+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 151,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T10:34:40.986+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.382+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\":\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 133,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T08:36:25.849+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.364+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 1,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T10:31:07.711+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.346+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 40,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T07:55:00.473+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.324+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 1,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T07:54:21.757+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.303+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 3,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T07:51:28.793+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.280+03:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 1,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T07:50:19.041+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.260+03:00\",\n \"id\":\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n },\n {\n \"log_entry_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"unit_type\": \"hour\",\n \"unit_amount\": 1,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-04-10T07:42:45.233+03:00\",\n \"cost_created_at\": \"2025-04-11T07:18:22.240+03:00\",\n \"id\": \"2cf7cb19-7698-4d28-8d88-17708d1b63ee\",\n \"cost_type\": \"LogEntry\",\n \"user_account\": {\n \"id\": \"1183c8-3c31-47c5-bb34-f2353220e9a51\",\n \"name\": \"Nilla Noheva\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n }\n ]\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"parent_type\": \"Task\",\n \"parent_name\": \"Vuosihuolto\",\n \"curr_parent_name\": \"Vuosihuolto\",\n \"completed_at\": \"2025-12-16T16:08:33.000+02:00\",\n \"completed_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Admin\"\n },\n \"spot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vesimittari Keskuskatu 16\"\n },\n \"customer\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_type\": \"company\",\n \"name\": \"Atmotics Oy\",\n \"status\": \"active\",\n \"customer_number\": \"123456851354\",\n \"legal_name\": \"Atmotics Oy\",\n \"company_id\": \"3223276157-6\",\n \"vat\": \"FI32743423261576\",\n \"phone\": \"09 8953261285\",\n \"mobile\": \"04085864568494\",\n \"email\": \"info@atmotics.com\",\n \"created_at\": \"2022-11-25T16:03:12.676+02:00\",\n \"updated_at\": \"2025-11-06T16:34:08.263+02:00\",\n \"address\": \"Vantaankoskentie 14 G\",\n \"postcode\": \"452\",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"inv_address\": \"Vantaankoskentie 14 G\",\n \"inv_postcode\": \"1670\",\n \"inv_city\": \"Vantaa\",\n \"inv_country\": \"FI\",\n \"invoicing_email\": \"mallikas@atmotics.com\",\n \"e_invoice_address\": \"37327613332576\",\n \"operator\": \"0037232233327487\",\n \"customer_group_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"customer_sales_account_id\": null,\n \"customer_cost_center_id\": null,\n \"additional_details\": null\n },\n \"collection\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vesimittaripaikat\",\n \"collection_path\": \"Vesimittaripaikat → Vesiverkosto → Vesilaitos Muuramevesi → Laitokset → Oy Kunnossapitodemo AB\"\n },\n \"collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"order_num\": null,\n \"internal_reference\": null,\n \"external_reference\": null,\n \"estimated_cost\": null,\n \"work_order\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimustyöt\"\n },\n \"task_template\": null,\n \"task_form\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vuosihuollon tehtävät\"\n },\n \"service_request_category\": null,\n \"issue_number\": null,\n \"billable_task\": false,\n \"customer_contract_task_setting\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_heading\": \"Vuosihuolto\",\n \"customer_contract\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Sopimus 2025\",\n \"contract_number\": \"111113313\"\n }\n },\n \"data\": [\n {\n \"id\": \"23222fe-19ce-40ce-822f-e5593327ad71/TaskProduct\",\n \"section\": \"TaskProduct\",\n \"total_sum\": 63.0,\n \"data\": [\n {\n \"task_product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"product_name\": \"Suodatin 3232\",\n \"product_code\": \"4234-3232\",\n \"unit_type\": \"box\",\n \"unit_amount\": 1.0,\n \"unit_price\": 0.0,\n \"created_at\": \"2025-12-12T12:01:54.847+02:00\",\n \"cost_created_at\": \"2025-12-16T16:08:53.445+02:00\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"cost_type\": \"TaskProduct\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Nilla Admin\"\n },\n \"total_sum\": 0.0,\n \"discount_percentage\": null\n }\n ]\n }\n ]\n }\n]"}],"_postman_id":"176b35e4-5beb-4292-a844-1f958224e453"},{"name":"/v3/sub_costs","id":"4fb4e1d0-1706-4b2a-874d-45a89c2fff3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sub_cost\": {\r\n \"title\": \"updated title\",\r\n \"additional_details\": \"additional_details\",\r\n \"unit_amount\": 100, \r\n \"unit_type\": \"pcs\", \r\n \"unit_price\": 105\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/sub_costs","description":"

Create new SubCost/Other cost

\n

Create new SubCost as OtherCost. If you want to add upload items, use /omni_upload endpoint. The target_type for upload item should be SubCost.

\n

Request Body

\n

The request body should be in the raw format and can include any of the following parameters:

\n\n

Also add one of these to mark to which item you want to add the cost:

\n\n

Options for unit_type:

\n

'pcs', 'km', 'm', 'cm', 'mm', 'km2', 'm2', 'cm2', 'km3', 'm3', 'cm3', 'l', 'ml', 'kg', 'g', 'mg', 'A', 'Ah', 'A_min', 'bag', 'bar', 'bottle', 'box', 'can', 'cl', 'day', 'dl', 'doz', 'doz_pack', '8_pack', 'EJ', '5_pack', 'ft', '4_pack', 'full_day', 'gal_uk', 'gal_us', 'Gbit', 'GB', 'GJ', 'GW', 'GWh', 'g/m3', 'g/m2', 'ha', 'h', 'hundred', 'in', 'jar', 'J', 'W', 'kAh', 'kbit', 'kB', 'kg/m3', 'kg/m2', 'kJ', 'kPa', 'kV', 'kW', 'kWh', 'lm', 'lot', 'Mbit', 'MB', 'MWh', 'mi', 'mAh', 'mg/m3', 'mJ', 'mV', 'mW', 'min', 'month', '9_pack', 'no_unit', 'words', 'oz', 'page', 'pair', 'pallet', 'parcel', 'Pa', 'person', 'PJ', 'pt_uk', 'pt_us', 'plate', 'lb', 'roll', 'sack', 'unit', 's', 'series', 'set', '7_pack', '6_pack', 'st', '10_pack', 'Tbit', 'TJ', 'TW', 'TWh', '3_pack', 't', 'tube', '2_pack', 'W', 'Wh', 'week', 'wrap', 'yd', 'yr'

\n","urlObject":{"path":["api","v3","sub_costs"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"cf626b19-ed74-4c4a-9a23-3b4fb6bd06e4","name":"/v3/sub_costs","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sub_cost\": {\r\n \"title\": \"Added title\",\r\n \"additional_details\": \"additional_details\",\r\n \"unit_amount\": 100, \r\n \"unit_type\": \"pcs\", \r\n \"unit_price\": 105,\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n // OR \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/sub_costs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": null,\n \"service_request\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vuotava hana\"\n },\n \"title\": \"Added title\",\n \"additional_details\": \"additional_details\",\n \"value\": 10500.0,\n \"discount_percentage\": null,\n \"unit_amount\": 100.0,\n \"unit_type\": \"pcs\",\n \"unit_price\": \"105.0\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"created_at\": \"2025-01-10T14:52:45.929+02:00\",\n \"updated_at\": \"2025-01-10T14:53:30.306+02:00\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2025-01-10T14:55:26.318+02:00\",\n \"header\": \"example.png\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae22214f-9512-490c-8d6a-a43e3ed3333\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae62224f-9512-490c-8d6a-a43e3ed22322\",\n \"task\": null\n }\n ],\n \"can_edit_cost\": true\n}"}],"_postman_id":"4fb4e1d0-1706-4b2a-874d-45a89c2fff3b"},{"name":"/v3/sub_costs/:id","id":"1b0ae75a-4851-4ffe-b7c6-edd43bcb7beb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sub_cost\": {\r\n \"title\": \"updated title\",\r\n \"additional_details\": \"additional_details\",\r\n \"unit_amount\": 100, \r\n \"unit_type\": \"pcs\", \r\n \"unit_price\": 105,\r\n \"upload_items_attributes \": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"_destroy\": 1\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/sub_costs/:id","description":"

Update SubCost Details

\n

Update selected SubCost. You can only destroy upload items. If you want to add new ones, use /omni_upload endpoint. The target_type for upload item should be SubCost.

\n

Request Body

\n

The request body should be in the raw format and can include any of the following parameters:

\n\n","urlObject":{"path":["api","v3","sub_costs",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"e9a1e9ec-fa61-466f-93d3-ea89271906b1","name":"/v3/sub_costs/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sub_cost\": {\r\n \"title\": \"updated title\",\r\n \"additional_details\": \"additional_details\",\r\n \"unit_amount\": 100, \r\n \"unit_type\": \"pcs\", \r\n \"unit_price\": 105,\r\n \"upload_items_attributes \": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"_destroy\": 1\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/sub_costs/:id","host":["api","spotilla","fi"],"path":["api","v3","sub_costs",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task\": null,\n \"service_request\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Vuotava hana\"\n },\n \"title\": \"UPPIS\",\n \"additional_details\": null,\n \"value\": 10500.0,\n \"discount_percentage\": null,\n \"unit_amount\": 100.0,\n \"unit_type\": \"pcs\",\n \"unit_price\": \"105.0\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"created_at\": \"2025-01-10T14:52:45.929+02:00\",\n \"updated_at\": \"2025-01-10T14:53:30.306+02:00\",\n \"upload_items\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2025-01-10T14:55:26.318+02:00\",\n \"header\": \"example.png\",\n \"thumbnail_url\": \"https://api.dev.spotilla.fi/api/files/thumb/ae22214f-9512-490c-8d6a-a43e3ed3333\",\n \"url\": \"https://api.dev.spotilla.fi/api/files/original/ae62224f-9512-490c-8d6a-a43e3ed22322\",\n \"task\": null\n }\n ],\n \"can_edit_cost\": true\n}"}],"_postman_id":"1b0ae75a-4851-4ffe-b7c6-edd43bcb7beb"},{"name":"/v3/resource_expenses_count","id":"a4d17e31-60c1-494e-b5e0-94c759403500","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/resource_expenses_count?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Returns count for sub(other) costs and for travel allowances.

\n

Use task_id or service_request_id in the parameters to get results.

\n","urlObject":{"path":["api","v3","resource_expenses_count"],"host":["api","spotilla","fi"],"query":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"disabled":true,"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"4d5677f7-c0fc-4058-b4f5-f2ac3be33cf0","name":"/v3/warehouse/:warehouse_id/warehouse_slots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/resource_expenses_count?task_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","resource_expenses_count"],"query":[{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"travel_allowances\": 3,\n \"other_costs\": 2,\n \"total\": 5\n}"}],"_postman_id":"a4d17e31-60c1-494e-b5e0-94c759403500"},{"name":"/v3/expenses_by_resource","id":"02cbf4eb-47cc-4edc-8f29-0f019f189d5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/expenses_by_resource?service_request_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Get all other costs and/or travel allowances that are linked to the selected Task or ServiceRequest.

\n

You must always send either task_id or service_request_id in the parameters.

\n

With expense_type parameter you can get only travel allowances or other costs, without parameter you will get both.

\n

Possible expense_type param options. travel_allowances or costs

\n","urlObject":{"path":["api","v3","expenses_by_resource"],"host":["api","spotilla","fi"],"query":[{"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"disabled":true,"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"disabled":true,"description":{"content":"

travel_allowances or costs

\n","type":"text/plain"},"key":"expense_type","value":null}],"variable":[]}},"response":[{"id":"1b00ad26-f5b3-45b8-90c8-5a42410bc059","name":"/v3/expenses_by_resource","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/expenses_by_resource?service_request_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","expenses_by_resource"],"query":[{"key":"service_request_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"key":"task_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"text","disabled":true},{"key":"expense_type","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"other_costs\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"title\": \"jälkimnmäinen\",\n \"total_price\": 326.0,\n \"unit_amount\": 2.0,\n \"unit_price\": \"163.0\",\n \"unit_type\": \"pcs\",\n \"created_at\": \"2025-01-10T15:15:25.768+02:00\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Mikko Mallikas\"\n },\n \"can_edit_cost\": true\n }\n ],\n \"travel_allowances\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"begin_date\": \"2025-01-10T08:15:00.000+02:00\",\n \"end_date\": \"2025-01-10T16:15:00.000+02:00\",\n \"reason\": \"Stock was empty\",\n \"route\": \"JKL Helsinkiin\",\n \"amount\": \"30.0\",\n \"kilometers\": 35,\n \"additional_passengers\": 2,\n \"trailer\": true,\n \"heavy_transport\": true,\n \"created_at\": \"2025-01-10T15:35:25.539+02:00\",\n \"personal_cost\": true,\n \"free_meals_amount\": 1\n }\n ]\n}"}],"_postman_id":"02cbf4eb-47cc-4edc-8f29-0f019f189d5b"}],"id":"0c1cd4d5-566d-4288-ba37-78bdbfae59dc","_postman_id":"0c1cd4d5-566d-4288-ba37-78bdbfae59dc","description":""},{"name":"Warehouse & Products","item":[{"name":"Products","item":[{"name":"/v3/products","id":"ff20047b-590c-49cc-a401-706105a01838","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/products?as=all&warehouse_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[search]=product name or code","description":"

This endpoint makes an HTTP GET request to retrieve product information from the Spotilla API.

\n

Query Params:

\n

The request includes query parameters for:

\n\n","urlObject":{"path":["api","v3","products"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"as","value":"all"},{"description":{"content":"

warehouse UUID, optional params

\n","type":"text/plain"},"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

optional params, product name or code

\n","type":"text/plain"},"key":"q[search]","value":"product name or code"}],"variable":[]}},"response":[{"id":"418a4106-8f74-4e8e-bec2-20332d46541f","name":"/v3/products","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"sRFE-pNPCMCy4zV6vAHU","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/products?q[search]=45321","host":["api","spotilla","fi"],"path":["api","v3","products"],"query":[{"key":"as","value":"all","description":"optional params","disabled":true},{"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID optional params","disabled":true},{"key":"q[search]","value":"45321","description":"optional params; search by product name or code"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt 45321-10\",\n \"code\": \"45321-10\",\n \"manufacturer\": \"Belt Ltd\",\n \"length\": \"5000.0\",\n \"width\": \"600.0\",\n \"height\": \"35.0\",\n \"weight\": null,\n \"measure_unit\": \"mm\",\n \"storage_unit\": \"pcs\",\n \"price\": \"580.0\",\n \"selling_price\": \"580.0\",\n \"default_vat\": \"25.5\",\n \"reservation_price_euro\": 0,\n \"reservation_price_cent\": 0,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": 1,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belts\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"amount\": 2.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"amount\": 18.0\n }\n ],\n \"created_at\": \"2021-05-06T19:13:20.779Z\",\n \"updated_at\": \"2022-07-20T11:24:22.329Z\",\n \"product_attribute_fields\": null,\n \"vendors\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belts for all Ltd\"\n }\n ],\n \"spare_part_spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt Conveyor 405\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt Conveyor 404\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Packing Machine 405\"\n }\n ],\n \"upload_items\": []\n }\n]"}],"_postman_id":"ff20047b-590c-49cc-a401-706105a01838"},{"name":"/v3/products_for_spot","id":"5f9356fe-fbc0-48f3-bfb2-816d3303d04e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/products_for_spot?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Return Products that are linked to the selected Spot.

\n

Note: spot_id is a required query params

\n","urlObject":{"path":["api","v3","products_for_spot"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

spot UUID; required params

\n","type":"text/plain"},"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"fea06c79-218b-4a70-9b9f-a8155a712a5c","name":"/v3/products_for_spot","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/products_for_spot?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","products_for_spot"],"query":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt 45321-10\",\n \"code\": \"45321-10\",\n \"manufacturer\": \"Belt Ltd\",\n \"length\": \"5000.0\",\n \"width\": \"600.0\",\n \"height\": \"35.0\",\n \"weight\": null,\n \"measure_unit\": \"mm\",\n \"storage_unit\": \"pcs\",\n \"price\": \"580.0\",\n \"selling_price\": \"580.0\",\n \"default_vat\": \"25.5\",\n \"reservation_price_euro\": 0,\n \"reservation_price_cent\": 0,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": 1,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belts\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"amount\": 2.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"amount\": 18.0\n }\n ],\n \"created_at\": \"2021-05-06T19:13:20.779Z\",\n \"updated_at\": \"2022-07-20T11:24:22.329Z\",\n \"product_attribute_fields\": null,\n \"vendors\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belts for all Ltd\"\n }\n ],\n \"spare_part_spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt Conveyor 405\"\n }\n ],\n \"upload_items\": []\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Bearing 3447\",\n \"code\": \"3447\",\n \"manufacturer\": \"\",\n \"length\": null,\n \"width\": null,\n \"height\": null,\n \"weight\": null,\n \"measure_unit\": null,\n \"storage_unit\": \"pcs\",\n \"price\": \"155.0\",\n \"selling_price\": null,\n \"default_vat\": null,\n \"reservation_price_euro\": null,\n \"reservation_price_cent\": null,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": 2,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Robots parts\"\n },\n \"warehouses\": [],\n \"created_at\": \"2023-04-04T14:14:49.119Z\",\n \"updated_at\": \"2023-04-04T14:25:27.125Z\",\n \"product_attribute_fields\": null,\n \"vendors\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Bearings Ltd\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ruhui Wonderful Business\"\n }\n ],\n \"spare_part_spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Belt Conveyor 404\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"HVAC unit Max-Air GK2331 0071\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"CNC-Machine 208-470 CF12 Schiess DS-160\"\n }\n ],\n \"upload_items\": []\n }\n]"}],"_postman_id":"5f9356fe-fbc0-48f3-bfb2-816d3303d04e"},{"name":"/v3/lately_used_products","id":"c4d463d7-6e80-494a-b725-5c7709bbdb3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/lately_used_products?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Returns products that have been used in the tasks or service (of the selected Spot) requests in the past 3months.

\n

Note that the query params \"spot_id\" is required.

\n","urlObject":{"path":["api","v3","lately_used_products"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

required params

\n","type":"text/plain"},"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"e04df34f-ac39-4c0e-9f20-922020592952","name":"/v3/lately_used_products","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/lately_used_products?spot_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","lately_used_products"],"query":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"required params"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Iron Bar HEB 200\",\n \"code\": \"HEB200\",\n \"manufacturer\": \"\",\n \"length\": null,\n \"width\": null,\n \"height\": null,\n \"weight\": null,\n \"measure_unit\": null,\n \"storage_unit\": \"pcs\",\n \"price\": null,\n \"selling_price\": null,\n \"default_vat\": \"25.5\",\n \"reservation_price_euro\": null,\n \"reservation_price_cent\": null,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": null,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons 1\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouses\",\n \"amount\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouses\",\n \"amount\": 1\n }\n ],\n \"created_at\": \"2020-11-02T11:06:33.660+02:00\",\n \"updated_at\": \"2020-11-02T11:06:33.660+02:00\",\n \"product_attribute_fields\": null,\n \"vendors\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Oils & Filters Ltd 1\"\n }\n ],\n \"spare_part_spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Packing Machine 405\"\n }\n ],\n \"upload_items\": []\n }\n]"}],"_postman_id":"c4d463d7-6e80-494a-b725-5c7709bbdb3b"},{"name":"/v3/products/:id","id":"2560eda7-9572-47e4-be2f-552b040b031c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/products/:id","description":"

GET /api/v3/products/:id

\n

This endpoint retrieves product details based on the provided product ID.

\n

Request

\n

No request body is required for this endpoint.

\n","urlObject":{"path":["api","v3","products",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"c349ef92-45b7-4e38-b2cd-b41477d41320","name":"/v3/products/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/products/:id","host":["api","spotilla","fi"],"path":["api","v3","products",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Iron Bar HEB 200\",\n \"code\": \"HEB200\",\n \"manufacturer\": \"\",\n \"length\": null,\n \"width\": null,\n \"height\": null,\n \"weight\": null,\n \"measure_unit\": null,\n \"storage_unit\": \"pcs\",\n \"price\": null,\n \"selling_price\": null,\n \"default_vat\": \"25.5\", // float or null\n \"reservation_price_euro\": null,\n \"reservation_price_cent\": null,\n \"reservation_count_only_weekdays\": false,\n \"product_in_use\": true,\n \"warehouse_alert_limit\": null,\n \"status\": \"in_use\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"amount\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouse\",\n \"amount\": 1\n }\n ],\n \"created_at\": \"2020-11-02T11:06:33.660+02:00\",\n \"updated_at\": \"2020-11-02T11:06:33.660+02:00\",\n \"product_attribute_fields\": null,\n \"vendors\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Oils & Filters Ltd\"\n }\n ],\n \"spare_part_spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Packing Machine 405\"\n }\n ],\n \"upload_items\": [],\n \"latest_purchase_price\": \"0.0\",\n \"latest_po_created_by\": \"John Doe\",\n \"latest_po_created_at\": \"2025-12-26T12:50:30.217+02:00\",\n \"latest_po_warehouses\": \"Kouvola Warehouse\",\n \"latest_po_batch_number\": 10000192\n}"}],"_postman_id":"2560eda7-9572-47e4-be2f-552b040b031c"},{"name":"/v3/latest_product_values_in_warehouses/:id","id":"85d3e379-3636-49b1-92f3-ef050d941025","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/latest_product_values_in_warehouses/:id","description":"

GET /api/v3/latest_product_values_in_warehouses/:id

\n

This endpoint retrieves the latest product values of a product (by uuid) per warehouse.

\n

average_batch_price: Average of the product’s purchase prices across batches delivered to a warehouse. Each batch counts equally.

\n

weighted_average_price: Average purchase price weighted by remaining stock in a warehouse. Batches with more stock left count more.

\n","urlObject":{"path":["api","v3","latest_product_values_in_warehouses",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"0c9d2f89-45b8-4f44-9c9a-93269a851b97","name":"/v3/latest_product_values_in_warehouses/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/latest_product_values_in_warehouses/:id","host":["api","spotilla","fi"],"path":["api","v3","latest_product_values_in_warehouses",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_name\": \"Kaikkia tuotteita\",\n \"average_batch_price\": \"5.6\",\n \"weighted_average_price\": \"8.0\",\n \"recorded_at\": \"2026-01-21T23:02:06.098+02:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_name\": \"Kouvola Warehouse\",\n \"average_batch_price\": \"6.24\",\n \"weighted_average_price\": \"0.0\",\n \"recorded_at\": \"2026-01-21T23:02:06.098+02:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_name\": \"Helsinki Warehouse\",\n \"average_batch_price\": \"4.0\",\n \"weighted_average_price\": \"0.0\",\n \"recorded_at\": \"2026-01-21T23:02:06.098+02:00\"\n }\n]"}],"_postman_id":"85d3e379-3636-49b1-92f3-ef050d941025"},{"name":"/v3/products","id":"6f4b1187-1a4a-4756-b570-46a87c364bdb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product\": {\r\n \"name\": \"Iron Bar HEB 200\", \r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"manufacturer_information\": \"Best manufacturer of all time.\",\r\n \"product_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass product category UUID here\r\n \"length\": \"50\",\r\n \"width\": \"40\",\r\n \"height\": \"10\",\r\n \"weight\": \"100\",\r\n \"measure_unit\": \"cm\",\r\n \"price\": \"100\",\r\n \"selling_price\": \"150\",\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": \"10\",\r\n \"reservation_price_cent\": \"0\",\r\n \"warehouse_alert_limit\": \"3\",\r\n \"storage_unit\": \"g\",\r\n \"reservation_count_only_weekdays\": true\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products","description":"

Request

\n

This endpoint allows you to create a new product by providing the required fields in the request body. The request should be in JSON format and include the following parameters:

\n\n

Options for storage_unit:

\n

'pcs', 'km', 'm', 'cm', 'mm', 'km2', 'm2', 'cm2', 'km3', 'm3', 'cm3', 'l', 'ml', 'kg', 'g', 'mg', 'A', 'Ah', 'A_min', 'bag', 'bar', 'bottle', 'box', 'can', 'cl', 'day', 'dl', 'doz', 'doz_pack', '8_pack', 'EJ', '5_pack', 'ft', '4_pack', 'full_day', 'gal_uk', 'gal_us', 'Gbit', 'GB', 'GJ', 'GW', 'GWh', 'g/m3', 'g/m2', 'ha', 'h', 'hundred', 'in', 'jar', 'J', 'W', 'kAh', 'kbit', 'kB', 'kg/m3', 'kg/m2', 'kJ', 'kPa', 'kV', 'kW', 'kWh', 'lm', 'lot', 'Mbit', 'MB', 'MWh', 'mi', 'mAh', 'mg/m3', 'mJ', 'mV', 'mW', 'min', 'month', '9_pack', 'no_unit', 'words', 'oz', 'page', 'pair', 'pallet', 'parcel', 'Pa', 'person', 'PJ', 'pt_uk', 'pt_us', 'plate', 'lb', 'roll', 'sack', 'unit', 's', 'series', 'set', '7_pack', '6_pack', 'st', '10_pack', 'Tbit', 'TJ', 'TW', 'TWh', '3_pack', 't', 'tube', '2_pack', 'W', 'Wh', 'week', 'wrap', 'yd', 'yr'

\n","urlObject":{"path":["api","v3","products"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"e829dc1c-8a87-4cbe-9aaf-78d247bb76f5","name":"/v3/products","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product\": {\r\n \"name\": \"Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"manufacturer_information\": \"Best manufacturer of all time.\",\r\n \"product_category_id\": \"334548-04c3-4695-989c-6c050da510c3\",\r\n \"length\": \"50\",\r\n \"width\": \"40\",\r\n \"height\": \"10\",\r\n \"weight\": \"100\",\r\n \"measure_unit\": \"kg\",\r\n \"price\": \"100\",\r\n \"selling_price\": \"150\",\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": \"10\",\r\n \"reservation_price_cent\": \"0\",\r\n \"warehouse_alert_limit\": \"32\",\r\n \"storage_unit\": \"mm\",\r\n \"reservation_count_only_weekdays\": true\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"length\": 50,\r\n \"width\": 40,\r\n \"height\": 10,\r\n \"weight\": 100,\r\n \"measure_unit\": \"cm\",\r\n \"storage_unit\": \"g\",\r\n \"price\": 100,\r\n \"selling_price\": 150,\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": 10,\r\n \"reservation_price_cent\": 0,\r\n \"warehouse_alert_limit\": 32,\r\n \"status\": \"in_use\",\r\n \"product_category\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Irons\"\r\n },\r\n \"warehouses\": [],\r\n \"created_at\": \"2020-11-02T11:06:33.660+02:00\",\r\n \"updated_at\": \"2020-11-02T11:06:33.660+02:00\",\r\n \"product_attribute_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"3\",\r\n \"key_name\": \"Tilavuus\",\r\n \"input_type\": \"number\",\r\n \"order\": 1\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"0.5m2\",\r\n \"key_name\": \"Pinta-ala\",\r\n \"input_type\": \"text\",\r\n \"order\": 2\r\n }\r\n ],\r\n \"vendors\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Kaakelipojat\"\r\n }\r\n ],\r\n \"spare_part_spots\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Puskuri\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"A-halli Kalliolan kiinteistö\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hissi 1\"\r\n }\r\n ],\r\n \"upload_items\": []\r\n}"}],"_postman_id":"6f4b1187-1a4a-4756-b570-46a87c364bdb"},{"name":"/v3/spare_parts","id":"ce44e853-7e96-486a-9459-743735517057","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spare_part\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_info\": \"any additional info\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spare_parts","description":"

Request

\n

This endpoint allows you to attaching product (spare part) to spot by providing the required fields in the request body. The request should be in JSON format and include the following parameters:

\n\n","urlObject":{"path":["api","v3","spare_parts"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"1113c45d-0979-4619-a6cf-4f3ed12f123e","name":"/v3/spare_parts","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"spare_part\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"additional_info\": \"any additional info\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spare_parts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spot\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2021-02-23T09:01:06.772+02:00\",\r\n \"updated_at\": \"2024-12-12T13:15:15.621+02:00\",\r\n \"name\": \"Spot AAA\",\r\n \"description\": \"\",\r\n \"legacy_updated_by\": null,\r\n \"status\": \"active\",\r\n \"service_request_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"latitude\": \"59.19479937584231\",\r\n \"longitude\": \"18.115810497161597\",\r\n \"updated_by_user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"amortization_type\": \"amortization\",\r\n \"invest_price\": null,\r\n \"purchase_date\": null,\r\n \"amortization_years\": null,\r\n \"amortization_rate\": null,\r\n \"created_by_workflow_id\": null,\r\n \"updated_by_workflow_id\": null,\r\n \"usage_schedule_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"hierarchy_path\": \"Production Line 401 → Production Lines → Production Site Stockholm → Our Company Ltd\",\r\n \"collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"default_image_id\": null,\r\n \"log_machine_hours\": false,\r\n \"running_machine_hours\": 0.0\r\n },\r\n \"product\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Big Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"manufacturer_information\": \"Best manufacturer of all time.\",\r\n \"price\": \"100.0\",\r\n \"selling_price\": \"150.0\",\r\n \"reservation_price_euro\": 10,\r\n \"reservation_price_cent\": 0,\r\n \"product_in_use\": true,\r\n \"warehouse_alert_limit\": 3,\r\n \"created_at\": \"2024-05-28T10:39:59.725+03:00\",\r\n \"updated_at\": \"2024-07-01T10:19:16.178+03:00\",\r\n \"product_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"status\": \"in_use\",\r\n \"product_warehouse_slot_references\": []\r\n },\r\n \"additional_info\": \"any additional info\"\r\n}"}],"_postman_id":"ce44e853-7e96-486a-9459-743735517057"},{"name":"/v3/products/:id","id":"5ae9e0db-4a58-43e1-a51e-4d703d199649","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product\": {\r\n \"name\": \"Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"manufacturer_information\": \"Best manufacturer of all time.\",\r\n \"product_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", \r\n \"length\": \"50\",\r\n \"width\": \"40\",\r\n \"height\": \"10\",\r\n \"weight\": \"100\",\r\n \"measure_unit\": \"cm\",\r\n \"price\": \"100\",\r\n \"selling_price\": \"150\",\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": \"10\",\r\n \"reservation_price_cent\": \"0\",\r\n \"warehouse_alert_limit\": \"3\",\r\n \"storage_unit\": \"g\",\r\n \"reservation_count_only_weekdays\": true\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products/:id","description":"

This endpoint is used to update a specific product by its ID.

\n

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n

Request Body

\n\n

Options for storage_unit:

\n

'pcs', 'km', 'm', 'cm', 'mm', 'km2', 'm2', 'cm2', 'km3', 'm3', 'cm3', 'l', 'ml', 'kg', 'g', 'mg', 'A', 'Ah', 'A_min', 'bag', 'bar', 'bottle', 'box', 'can', 'cl', 'day', 'dl', 'doz', 'doz_pack', '8_pack', 'EJ', '5_pack', 'ft', '4_pack', 'full_day', 'gal_uk', 'gal_us', 'Gbit', 'GB', 'GJ', 'GW', 'GWh', 'g/m3', 'g/m2', 'ha', 'h', 'hundred', 'in', 'jar', 'J', 'W', 'kAh', 'kbit', 'kB', 'kg/m3', 'kg/m2', 'kJ', 'kPa', 'kV', 'kW', 'kWh', 'lm', 'lot', 'Mbit', 'MB', 'MWh', 'mi', 'mAh', 'mg/m3', 'mJ', 'mV', 'mW', 'min', 'month', '9_pack', 'no_unit', 'words', 'oz', 'page', 'pair', 'pallet', 'parcel', 'Pa', 'person', 'PJ', 'pt_uk', 'pt_us', 'plate', 'lb', 'roll', 'sack', 'unit', 's', 'series', 'set', '7_pack', '6_pack', 'st', '10_pack', 'Tbit', 'TJ', 'TW', 'TWh', '3_pack', 't', 'tube', '2_pack', 'W', 'Wh', 'week', 'wrap', 'yd', 'yr'

\n","urlObject":{"path":["api","v3","products",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"f49507dc-0711-4805-a8e6-1dfecf581e7d","name":"/v3/products/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"manufacturer_information\": \"Best manufacturer of all time.\",\r\n \"product_category_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"length\": \"50\",\r\n \"width\": \"40\",\r\n \"height\": \"10\",\r\n \"weight\": \"100\",\r\n \"measure_unit\": \"cm\",\r\n \"price\": \"100\",\r\n \"selling_price\": \"150\",\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": \"10\",\r\n \"reservation_price_cent\": \"0\",\r\n \"warehouse_alert_limit\": \"3\",\r\n \"storage_unit\": \"g\",\r\n \"reservation_count_only_weekdays\": true\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/products/:id","host":["api","spotilla","fi"],"path":["api","v3","products",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Iron Bar HEB 200\",\r\n \"code\": \"HEB200\",\r\n \"manufacturer\": \"Manu\",\r\n \"length\": 50,\r\n \"width\": 40,\r\n \"height\": 10,\r\n \"weight\": 100,\r\n \"measure_unit\": \"cm\",\r\n \"storage_unit\": \"g\",\r\n \"price\": 100,\r\n \"selling_price\": 150,\r\n \"default_vat\": \"25.5\",\r\n \"reservation_price_euro\": 10,\r\n \"reservation_price_cent\": 0,\r\n \"warehouse_alert_limit\": 3,\r\n \"status\": \"in_use\",\r\n \"product_category\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Irons\"\r\n },\r\n \"warehouses\": [],\r\n \"created_at\": \"2020-11-02T11:06:33.660+02:00\",\r\n \"updated_at\": \"2020-11-02T11:06:33.660+02:00\",\r\n \"product_attribute_fields\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"3\",\r\n \"key_name\": \"Tilavuus\",\r\n \"input_type\": \"number\",\r\n \"order\": 1\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"value\": \"0.5m2\",\r\n \"key_name\": \"Pinta-ala\",\r\n \"input_type\": \"text\",\r\n \"order\": 2\r\n }\r\n ],\r\n \"vendors\": [\r\n {\r\n \"id\": \"9ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Kaakelipojat\"\r\n }\r\n ],\r\n \"spare_part_spots\": [\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Puskuri\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"A-halli Kalliolan kiinteistö\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hissi 1\"\r\n }\r\n ],\r\n \"upload_items\": []\r\n}"}],"_postman_id":"5ae9e0db-4a58-43e1-a51e-4d703d199649"},{"name":"/v3/products/:id/inventory","id":"eb7908d0-9d3c-4e9f-b9da-1e69ebffa1c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"optional_purchase_batch_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required\r\n \"number_of_products\": 1,\r\n \"description\": \"Found one product under the shelf\" // optional params\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products/:id/inventory","description":"

POST /api/v3/products/:id/inventory

\n

This endpoint is used to create a warehouse inventory event for a specific product.

\n

Request Body

\n\n

To load purchase batch options, use this endpoint:

\n

/v3/purchase_batches?product_id=uuid&warehouse_id=uuid&slot_id=uuid

\n","urlObject":{"path":["api","v3","products",":id","inventory"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"69b7ab2e-2b82-4bc3-a66f-92665a51d0cb","name":"/v3/products/:id/inventory","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"optional_purchase_batch_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // required\r\n \"number_of_products\": 1,\r\n \"description\": \"Found one product under the shelf\" //optional params\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/products/:id/inventory","host":["api","spotilla","fi"],"path":["api","v3","products",":id","inventory"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Inventory successful.\"\r\n}"}],"_postman_id":"eb7908d0-9d3c-4e9f-b9da-1e69ebffa1c8"},{"name":"/v3/products/:id/transfer","id":"daa2ee98-f2f6-4a2f-b1e7-1e1442c4f202","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"from_warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID; \r\n \"from_warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"to_warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID\r\n \"to_warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"number_of_products\": 3,\r\n \"optional_purchase_batch_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // purchase batch UUID\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products/:id/transfer","description":"

Transfer Product

\n

This endpoint allows the transfer of a product from one warehouse to another.

\n

NOTE: All of the fields are required.

\n

Make sure you call the endpoint with correct product id.

\n

Request Body

\n\n

Note: make sure that the warehouse slot (from_warehouse_slot_id) in the warehouse (from_warehouse_id) has enough products (number_of_products) to be trasnfered out. Make sure also purchase batch has enough products to cover the transfer.

\n

from and to slots cannot be the same.

\n

Use this endpoint to load available purchase batch options:

\n

/v3/purchase_batches?product_id=uuid&warehouse_id=uuid&slot_id=uuid&only_active=true

\n","urlObject":{"path":["api","v3","products",":id","transfer"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"02ac8408-3f46-4923-9466-f1dd3355603d","name":"/v3/products/:id/transfer","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"from_warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID; \r\n \"from_warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"to_warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID\r\n \"to_warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"number_of_products\": 3,\r\n \"optional_purchase_batch_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // purchase batch UUID\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/products/:id/transfer","host":["api","spotilla","fi"],"path":["api","v3","products",":id","transfer"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Transfer successful.\"\r\n}"}],"_postman_id":"daa2ee98-f2f6-4a2f-b1e7-1e1442c4f202"},{"name":"/v3/products/:id/reservation","id":"4805a99f-3e5c-479e-b8ef-4c01ee3b7a85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"reservation_site_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // reservation site UUID\r\n \"number_of_products\": 3,\r\n \"start_time\": \"2020-12-15 12:21:40\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/products/:id/reservation","description":"

Create Product Reservation

\n

This endpoint allows you to create a reservation for a specific product in a warehouse.

\n

Request Body

\n\n

Note: make sure the warehouse slot (warehouse_slot_id) in the warehouse (warehouse_id) has enough amount of product (number_of_products) to be reserved.

\n","urlObject":{"path":["api","v3","products",":id","reservation"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"1f17e822-bdb9-42d8-9956-0cf82e5497ba","name":"/v3/products/:id/reservation","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse UUID\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // warehouse slot UUID\r\n \"reservation_site_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // reservation site UUID\r\n \"number_of_products\": 3,\r\n \"start_time\": \"2020-12-15 12:21:40\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/products/:id/reservation","host":["api","spotilla","fi"],"path":["api","v3","products",":id","reservation"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Reservation successful.\"\r\n}"}],"_postman_id":"4805a99f-3e5c-479e-b8ef-4c01ee3b7a85"},{"name":"/v3/warehouse_events/buy","id":"dbb19008-97ed-4e93-a63d-5484d3aaa2c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"discount_percentage\": 0, // always send a number \r\n \"alternative_price\": 55.50, // optional\r\n \"event_targets_attributes\": [\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n },\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_events/buy","description":"

Create Buy-event

\n

This endpoint allows you to create a buy-event for a specific product in a warehouse.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","warehouse_events","buy"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"538d68f7-b808-4ed2-8392-f1e24c2dd73c","name":"/v3/warehouse_events/buy","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"discount_percentage\": 0, // always send a number \r\n \"alternative_price\": 55.50, // optional\r\n \"event_targets_attributes\": [\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n },\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_events/buy"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Buy event successful\"\r\n}"}],"_postman_id":"dbb19008-97ed-4e93-a63d-5484d3aaa2c1"},{"name":"/v3/warehouse_events/sell","id":"9a764c0a-8f96-4eba-8bc6-62477b259dae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"description\": \"any text\",\r\n \"discount_percentage\": 0, // always send a number \r\n \"alternative_price\": 55.50, // optional\r\n \"event_sources_attributes\": [\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n }\r\n ],\r\n \"product_warehouse_event_customer_information_attributes\": {\r\n \"client_number\": \"number string\",\r\n \"client_name\": \"Client name Oy\",\r\n \"contact_person\": \"Mikko Mallikas\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_events/sell","description":"

Create Sell-event

\n

This endpoint allows you to create a sell-event for a specific product in a warehouse.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","warehouse_events","sell"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"bb3db7eb-eba3-4b54-92dc-7c152b227eb6","name":"/v3/warehouse_events/sell","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_warehouse_event\": {\r\n \"product_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"description\": \"any text\",\r\n \"discount_percentage\": 0, // always send a number \r\n \"alternative_price\": 55.50, // optional\r\n \"event_sources_attributes\": [\r\n {\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1\r\n }\r\n ],\r\n \"product_warehouse_event_customer_information_attributes\": {\r\n \"client_number\": \"number string\",\r\n \"client_name\": \"Client name Oy\",\r\n \"contact_person\": \"Mikko Mallikas\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_events/sell"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Sell event successful\"\r\n}"}],"_postman_id":"9a764c0a-8f96-4eba-8bc6-62477b259dae"}],"id":"7148f219-38c0-4b71-b280-21eb0516bf34","_postman_id":"7148f219-38c0-4b71-b280-21eb0516bf34","description":""},{"name":"Product Reservations","item":[{"name":"/v3/product_reservations/:id/return","id":"c59fa011-8e7e-4847-9a24-8fa490378197","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1,\r\n \"end_time\": \"2024-11-03T12:21:40.989+02:00\",\r\n \"description\": \"something\"\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/product_reservations/:id/return","description":"

Create Reservation return-event

\n

This endpoint allows you to return a specific product back to warehouse from reservation site.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","product_reservations",":id","return"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"a5d6565e-c88d-42c7-8089-a3819cd48449","name":"/v3/product_reservations/:id/return","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"warehouse_slot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"number_of_products\": 1,\r\n \"end_time\": \"2024-11-03T12:21:40.989+02:00\",\r\n \"description\": \"something\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/product_reservations/:id/return","host":["api","spotilla","fi"],"path":["api","v3","product_reservations",":id","return"],"variable":[{"key":"id","value":""}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Returned 1.0 products.\"\r\n}"}],"_postman_id":"c59fa011-8e7e-4847-9a24-8fa490378197"},{"name":"/v3/reservation_sites/:id/product_reservations","id":"13cb3056-e417-44b4-adc9-f6e0f0e8e6a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/reservation_sites/:id/product_reservations","description":"

The request should include the warehouse ID, warehouse slot ID, and the product ID as a query parameter. This endpoint returns the related purchase batches of that product in selected warehouse slot. With only_active parameter you can get only those batches that still have products left. Do not add only_active parameter if you need to get all batches even if there is no products left.

\n","urlObject":{"path":["api","v3","reservation_sites",":id","product_reservations"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"10242d1e-2018-4660-bb2c-a845ef2cd779","name":"/v3/reservation_sites/:id/product_reservations","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/reservation_sites/23455aac-63ba-4290-ae7b-911c42345cf1/product_reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"a3453367b-d50e-4cd0-ad8e-6804e50b3226\",\n \"start_time\": \"2024-11-01T12:21:40.989+02:00\",\n \"end_time\": null,\n \"product\": {\n \"id\": \"233443a9-06da-48ee-a90b-fdafbb43312c\",\n \"name\": \"Imported Product 123\",\n \"code\": \"IMPR123\"\n },\n \"amount_in_site\": 1,\n \"readonly\": false,\n \"reservation_site\": {\n \"id\": \"23455aac-63ba-4290-ae7b-911c42345cf1\",\n \"name\": \"19001 Nikkilän ratasilta\"\n },\n \"created_by\": {\n \"id\": \"234199-91d6-4342-b78b-1334569526a\",\n \"name\": \"Mikko Mallikas\"\n }\n },\n]"}],"_postman_id":"13cb3056-e417-44b4-adc9-f6e0f0e8e6a6"}],"id":"eb52aba1-bafc-449c-b02a-307c3cd74cda","_postman_id":"eb52aba1-bafc-449c-b02a-307c3cd74cda","description":""},{"name":"Product Categories","item":[{"name":"/v3/product_categories","id":"6c4c7638-e1d8-4ec7-a7b2-1805d3c8b990","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":""},"url":"api.spotilla.fi/api/v3/product_categories?name=iron","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

List of all available Product categories.

\n

To find/filter items by category name, use the name-parameter

\n","urlObject":{"path":["api","v3","product_categories"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"name","value":"iron"}],"variable":[]}},"response":[{"id":"e9020bed-d260-4606-8703-46a942c21d00","name":"/v3/product_categories","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/product_categories?name=iron","host":["api","spotilla","fi"],"path":["api","v3","product_categories"],"query":[{"key":"name","value":"iron","description":"optional params"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\",\n \"description\": \"Automaatiolaitteet\",\n \"created_at\": \"2021-12-21T17:37:54.458Z\",\n \"updated_at\": \"2021-12-21T17:37:54.458Z\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Iron product\",\n \"description\": \"Kuljettimien hihnat\",\n \"created_at\": \"2020-04-26T17:59:34.993Z\",\n \"updated_at\": \"2022-04-27T10:28:40.147Z\"\n }\n]"}],"_postman_id":"6c4c7638-e1d8-4ec7-a7b2-1805d3c8b990"},{"name":"/v3/product_categories/:id","id":"4b5be54b-6aba-496a-b001-46eaf55c3b1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/product_categories/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

The endpoint allows retrieval of a specific product category by providing the product category UUID.

\n

Request

\n\n","urlObject":{"path":["api","v3","product_categories",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product category UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"09b4175f-654c-41fa-9d8f-b7ab02e093a4","name":"/v3/product_categories/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/product_categories/:id","host":["api","spotilla","fi"],"path":["api","v3","product_categories",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product category UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kaakelit\",\n \"description\": \"muuttu\",\n \"created_at\": \"2021-05-10T17:07:07.814+03:00\",\n \"updated_at\": \"2023-08-29T11:13:52.330+03:00\"\n}"}],"_postman_id":"4b5be54b-6aba-496a-b001-46eaf55c3b1f"},{"name":"/v3/product_categories","id":"7bacdc95-64d5-4d76-b347-63bbb6dcb8ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_category\": {\r\n \"name\": \"Hihnat\",\r\n \"description\": \"Kaikki hihnat\" // optional params\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/product_categories","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

Name is required field.

\n

Optional params: \"description\"

\n","urlObject":{"path":["api","v3","product_categories"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"1051fdba-50bb-44fb-8188-c7b2b096dc93","name":"/v3/product_categories","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_category\": {\r\n \"name\": \"Hihnat\",\r\n \"description\": \"Kaikki hihnat\" // optional params\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/product_categories"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hihnat\",\r\n \"description\": \"Kaikki hihnat\",\r\n \"created_at\": \"2023-08-30T19:01:38.571+03:00\",\r\n \"updated_at\": \"2023-08-30T19:01:38.571+03:00\"\r\n}"}],"_postman_id":"7bacdc95-64d5-4d76-b347-63bbb6dcb8ac"},{"name":"/v3/product_categories/:id","id":"f4817590-d027-455e-9e48-be323a2fc376","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_category\": {\r\n \"name\": \"Hihnat 1\",\r\n \"description\": \"Kaikki hihnat\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/product_categories/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint is used to update a specific product category.

\n

Name is required field.

\n

Optional params: \"description\"

\n","urlObject":{"path":["api","v3","product_categories",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

product category UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"e662e112-f481-4967-82fa-ac07997eb687","name":"/v3/product_categories/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"product_category\": {\r\n \"name\": \"Hihnat 1\",\r\n \"description\": \"Kaikki hihnat\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/product_categories/:id","host":["api","spotilla","fi"],"path":["api","v3","product_categories",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product category UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hihnat 1\",\n \"description\": \"Kaikki hihnat\",\n \"created_at\": \"2023-08-30T19:01:38.571+03:00\",\n \"updated_at\": \"2023-08-30T19:01:38.571+03:00\"\n}"}],"_postman_id":"f4817590-d027-455e-9e48-be323a2fc376"}],"id":"f870a981-e708-434d-aa96-0eaa7509f67e","_postman_id":"f870a981-e708-434d-aa96-0eaa7509f67e","description":""},{"name":"Warehouse Slot Collections","item":[{"name":"/v3/warehouse_slot_collections","id":"a2b4c407-3967-4a49-8e32-3e7efce0a379","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":""},"url":"api.spotilla.fi/api/v3/warehouse_slot_collections","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

List of all available Warehouse slot collections with slots.

\n","urlObject":{"path":["api","v3","warehouse_slot_collections"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"8d87113e-5b7e-454b-bd89-0164833ea378","name":"/v3/warehouse_slot_collections","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/warehouse_slot_collections"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kalliola A-hallin perä\",\n \"warehouse_slots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A10\",\n \"ref_1\": \"\",\n \"ref_2\": \"\",\n \"created_at\": \"2020-11-23T09:11:00.360+02:00\",\n \"updated_at\": \"2020-11-23T09:11:00.360+02:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A11\",\n \"ref_1\": \"\",\n \"ref_2\": \"\",\n \"created_at\": \"2020-11-23T09:11:00.361+02:00\",\n \"updated_at\": \"2020-11-23T09:11:00.361+02:00\"\n }\n ],\n \"warehouse_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"created_at\": \"2020-11-23T09:11:00.355+02:00\",\n \"updated_at\": \"2021-05-14T09:58:45.276+03:00\"\n }\n]"}],"_postman_id":"a2b4c407-3967-4a49-8e32-3e7efce0a379"},{"name":"/v3/warehouse_slot_collections/:id","id":"57eec4ce-547e-469f-8784-4347ba8cc959","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/warehouse_slot_collections/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint returns the warehouse slot collection with the specified ID.

\n","urlObject":{"path":["api","v3","warehouse_slot_collections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse slot collection UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"0f1075c7-eee3-4f31-9a42-c4c5cafaa528","name":"/v3/warehouse_slot_collections/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/warehouse_slot_collections/:id","host":["api","spotilla","fi"],"path":["api","v3","warehouse_slot_collections",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse slot collection UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kalliola A-hallin perä\",\n \"warehouse_slots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A10\",\n \"ref_1\": \"\",\n \"ref_2\": \"\",\n \"created_at\": \"2020-11-23T09:11:00.360+02:00\",\n \"updated_at\": \"2020-11-23T09:11:00.360+02:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A11\",\n \"ref_1\": \"\",\n \"ref_2\": \"\",\n \"created_at\": \"2020-11-23T09:11:00.361+02:00\",\n \"updated_at\": \"2020-11-23T09:11:00.361+02:00\"\n }\n ],\n \"warehouse_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"created_at\": \"2020-11-23T09:11:00.355+02:00\",\n \"updated_at\": \"2021-05-14T09:58:45.276+03:00\"\n}"}],"_postman_id":"57eec4ce-547e-469f-8784-4347ba8cc959"},{"name":"/v3/warehouse_slot_collections","id":"d66910c0-bc59-40f8-9d87-c30f2f57731c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_slot_collection\": {\r\n \"name\": \"Hakunilan varastopaikat\",\r\n \"warehouse_slots_attributes\": [\r\n {\r\n \"name\": \"Hylly 1\",\r\n \"ref_1\": \"Refe 1\",\r\n \"ref_2\": \"Refe 2\"\r\n },\r\n {\r\n \"name\": \"Hylly 2\",\r\n \"ref_1\": \"Refe 1\",\r\n \"ref_2\": \"Refe 2\"\r\n },\r\n {\r\n \"name\": \"Hylly 3\",\r\n \"ref_1\": \"Refe 1\",\r\n \"ref_2\": \"Refe 2\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_slot_collections","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

All name fields are required fields. Also ref_1 and ref_2 are required but those can be empty strings.

\n","urlObject":{"path":["api","v3","warehouse_slot_collections"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"7154631a-c553-488c-9662-55af65554535","name":"/v3/warehouse_slot_collections","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_slot_collection\": {\r\n \"name\": \"Hakunilan varastopaikat\",\r\n \"warehouse_slots_attributes\": [\r\n {\r\n \"name\": \"Hylly 1\",\r\n \"ref_1\": \"Refe 1\",\r\n \"ref_2\": \"Refe 2\"\r\n },\r\n {\r\n \"name\": \"Hylly 2\",\r\n \"ref_1\": \"\",\r\n \"ref_2\": \"\"\r\n },\r\n {\r\n \"name\": \"Hylly 3\",\r\n \"ref_1\": \"Refe 1\",\r\n \"ref_2\": \"Refe 2\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_slot_collections"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hakunilan varastopaikat\",\n \"warehouse_slots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hylly 1\",\n \"ref_1\": \"Refe 1\",\n \"ref_2\": \"Refe 2\",\n \"created_at\": \"2023-08-30T19:16:50.410+03:00\",\n \"updated_at\": \"2023-08-30T19:16:50.410+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hylly 2\",\n \"ref_1\": \"\",\n \"ref_2\": \"\",\n \"created_at\": \"2023-08-30T19:16:50.412+03:00\",\n \"updated_at\": \"2023-08-30T19:16:50.412+03:00\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hylly 3\",\n \"ref_1\": \"Refe 1\",\n \"ref_2\": \"Refe 2\",\n \"created_at\": \"2023-08-30T19:16:50.413+03:00\",\n \"updated_at\": \"2023-08-30T19:16:50.413+03:00\"\n }\n ],\n \"warehouse_ids\": [],\n \"created_at\": \"2023-08-30T19:16:50.403+03:00\",\n \"updated_at\": \"2023-08-30T19:16:50.403+03:00\"\n}"}],"_postman_id":"d66910c0-bc59-40f8-9d87-c30f2f57731c"},{"name":"/v3/warehouse_slot_collections/:id","id":"9da2182d-bb52-4a4d-bd96-882ff8154468","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_slot_collection\": {\r\n \"id\": \"2e43242e-9113-4b22-b43f-833823427963\",\r\n \"name\": \"Hakunilan paikat\",\r\n \"warehouse_slots_attributes\": [\r\n {\r\n \"id\": \"40a9584e-7c05-44c5-94ff-093fe02b7fc2\",\r\n \"_destroy\": 1 // destroy existing slot\r\n },\r\n {\r\n \"id\": \"4914a114-53ab-4633-85a7-79559ee6f7ec\",\r\n \"name\": \"Ylähylly\" // update existing slot\r\n },\r\n {\r\n // Create new slot, all fields required, refs can be empty string also\r\n \"name\": \"Alahylly\",\r\n \"ref_1\": \"refe1\",\r\n \"ref_2\": \"\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouse_slot_collections/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

All name fields are required fields. Also ref_1 and ref_2 are required but those can be empty strings.

\n

Description
This endpoint is used to update a warehouse slot collection with the provided ID. The request should include the warehouse_slot_collection object with the necessary updates to the collection and its slots.

\n","urlObject":{"path":["api","v3","warehouse_slot_collections",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse slot collection UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"6cabf7e1-2a52-4bd8-8218-4d50a126bd2d","name":"/v3/warehouse_slot_collections/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse_slot_collection\": {\r\n \"id\": \"2e43242e-9113-4b22-b43f-833823427963\",\r\n \"name\": \"Hakunilan paikat\",\r\n \"warehouse_slots_attributes\": [\r\n {\r\n \"id\": \"40a9584e-7c05-44c5-94ff-093fe02b7fc2\",\r\n \"_destroy\": 1 // destroy existing slot\r\n },\r\n {\r\n \"id\": \"4914a114-53ab-4633-85a7-79559ee6f7ec\",\r\n \"name\": \"Ylähylly\" // update existing slot\r\n },\r\n {\r\n // Create new slot, all fields required, refs can be empty string also\r\n \"name\": \"Alahylly\",\r\n \"ref_1\": \"refe1\",\r\n \"ref_2\": \"\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/warehouse_slot_collections/:id","host":["api","spotilla","fi"],"path":["api","v3","warehouse_slot_collections",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse slot collection UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hakunilan paikat\",\n \"warehouse_slots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Ylähylly\",\n \"ref_1\": \"Refe 1\",\n \"ref_2\": \"Refe 2\",\n \"created_at\": \"2023-08-29T14:02:03.816Z\",\n \"updated_at\": \"2023-08-29T14:02:03.816Z\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Alahylly\",\n \"ref_1\": \"refe1\",\n \"ref_2\": \"\",\n \"created_at\": \"2023-08-30T16:20:30.741Z\",\n \"updated_at\": \"2023-08-30T16:20:30.741Z\"\n }\n ],\n \"warehouse_ids\": [],\n \"created_at\": \"2023-08-29T14:02:03.804Z\",\n \"updated_at\": \"2023-08-29T14:03:05.802Z\"\n}"}],"_postman_id":"9da2182d-bb52-4a4d-bd96-882ff8154468"}],"id":"d397e31b-2401-4923-990e-851e6d51c045","_postman_id":"d397e31b-2401-4923-990e-851e6d51c045","description":""},{"name":"Warehouses","item":[{"name":"/v3/warehouses","id":"2d4c9d8c-998e-4dcd-8a79-38ca21cf0d61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[search]&for_task=true","description":"

Get a list of warehouses.

\n

Query params (optional):

\n\n","urlObject":{"path":["api","v3","warehouses"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

search by warehouse name

\n","type":"text/plain"},"key":"q[search]","value":null},{"description":{"content":"

boolean

\n","type":"text/plain"},"key":"for_task","value":"true"}],"variable":[]}},"response":[{"id":"250a0eaf-d85b-4fe5-8ed5-8b07e96db684","name":"/v3/warehouses","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[search]&for_task","host":["api","spotilla","fi"],"path":["api","v3","warehouses"],"query":[{"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"},{"key":"q[search]","value":null},{"key":"for_task","value":null,"description":"boolean"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"46303e04-ae20-44a4-ab98-f83aa3fe099f\",\n \"name\": \"Helsinki Warehouse\",\n \"address\": \"Pitkäniemenkatu 12\",\n \"zip_code\": \"50500\",\n \"city\": \"Helsinki\",\n \"municipality\": \"Uusimaa\",\n \"country\": \"FI\",\n \"created_at\": \"2020-11-02T11:04:39.068+02:00\",\n \"updated_at\": \"2020-11-02T11:05:00.597+02:00\",\n \"warehouse_slot_collection_id\": \"c9792056-bba6-48a7-bd56-2206fa9190f8\",\n \"warehouse_in_use\": true,\n \"status\": \"in_use\",\n \"email_notification_id\": null\n },\n {\n \"id\": \"ce15d454-d533-4c06-a3db-cd7279c45177\",\n \"name\": \"Stockholm Warehouse\",\n \"address\": \"Långvikgatan 6\",\n \"zip_code\": \"999666\",\n \"city\": \"Stockholm\",\n \"municipality\": \"Lulea\",\n \"country\": \"SE\",\n \"created_at\": \"2020-11-02T11:05:39.826+02:00\",\n \"updated_at\": \"2020-11-02T11:05:39.826+02:00\",\n \"warehouse_slot_collection_id\": \"c9792056-bba6-48a7-bd56-2206fa9190f8\",\n \"warehouse_in_use\": true,\n \"status\": \"in_use\",\n \"email_notification_id\": null\n }\n]"}],"_postman_id":"2d4c9d8c-998e-4dcd-8a79-38ca21cf0d61"},{"name":"/v3/warehouses/:id","id":"cb08399e-76d5-4d41-b49e-9ddedeaa708c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses/:id","description":"

Get Warehouse Details

\n

This endpoint returns the details of a specific warehouse identified by its ID.

\n

Request Body

\n

This is a GET request and does not require a request body.

\n","urlObject":{"path":["api","v3","warehouses",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"1341294a-c580-492b-8629-00de7a7b94f6","name":"/v3/warehouses/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses/:id","host":["api","spotilla","fi"],"path":["api","v3","warehouses",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Siikajärvi päävarasto\",\n \"address\": \"Siikalantie 6\",\n \"zip_code\": \"\",\n \"city\": \"\",\n \"municipality\": \"\",\n \"country\": \"FI\",\n \"created_at\": \"2020-04-26T20:56:34.943+03:00\",\n \"updated_at\": \"2021-05-27T09:41:00.945+03:00\",\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_in_use\": true,\n \"status\": \"in_use\",\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n}"}],"_postman_id":"cb08399e-76d5-4d41-b49e-9ddedeaa708c"},{"name":"/v3/warehouse/:warehouse_id/warehouse_slots","id":"7355cbb1-9d32-4f3d-a557-64ec2463c01c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots","description":"

This endpoint returns the warehouse slots for a specific warehouse identified by the warehouse_id.

\n","urlObject":{"path":["api","v3","warehouses",":warehouse_id","warehouse_slots"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

warehouse UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"warehouse_id"}]}},"response":[{"id":"52ff727b-46cd-4b17-95e2-ba2658b48c7c","name":"/v3/warehouse/:warehouse_id/warehouse_slots","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots","host":["api","spotilla","fi"],"path":["api","v3","warehouses",":warehouse_id","warehouse_slots"],"variable":[{"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A1\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A2\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A3\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A4\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A5\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"B1\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n }\n]"}],"_postman_id":"7355cbb1-9d32-4f3d-a557-64ec2463c01c"},{"name":"/v3/slot_products/:slot_id","id":"6695585c-648e-4bf4-a27d-9ef930097fa6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/slot_products/:slot_id","description":"

Get products inside a slot.

\n","urlObject":{"path":["api","v3","slot_products",":slot_id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

slot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"slot_id"}]}},"response":[{"id":"6e64225b-00c7-4c40-b2c7-32e1e820c6da","name":"/v3/slot_products/:slot_id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/slot_products/:slot_id","host":["api","spotilla","fi"],"path":["api","v3","slot_products",":slot_id"],"variable":[{"key":"slot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"slot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"warehouse\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\"\n },\n \"warehouse_slot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Slot A\",\n \"ref_1\": \"A1\",\n \"ref_2\": \"\"\n },\n \"products\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 17\",\n \"code\": \"A17\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 20\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 8\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 19\",\n \"code\": \"A19\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 20\",\n \"code\": \"A20\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 20\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 7\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 3\",\n \"code\": \"A3\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouse\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 4\",\n \"code\": \"A4\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 10\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 5\n }\n ],\n \"number_of_products\": 5\n }\n ]\n },\n {\n \"warehouse\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\"\n },\n \"warehouse_slot\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Slot A\",\n \"ref_1\": \"A1\",\n \"ref_2\": \"\"\n },\n \"products\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Amount Test Product1\",\n \"code\": \"A12313\",\n \"manufacturer\": \"\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 9\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Iron Bar HEB 100-10\",\n \"code\": \"HEB100\",\n \"manufacturer\": \"Iron Bar Company\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 41\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 7\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 18\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouse\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 36\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Iron Bar HEB 200\",\n \"code\": \"HEB200\",\n \"manufacturer\": \"\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouse\",\n \"number_of_products\": 2\n }\n ],\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 1\",\n \"code\": \"A1\",\n \"manufacturer\": \"Manu\",\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 2\n }\n ],\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 16\",\n \"code\": \"A16\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 3\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 31\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 5\n }\n ],\n \"number_of_products\": 3\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 3\",\n \"code\": \"A3\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 1\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Special Product Warehouse\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 4\",\n \"code\": \"A4\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 10\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 5\n }\n ],\n \"number_of_products\": 2\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 6\",\n \"code\": \"A6\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 10\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 40\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 10\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Product 9\",\n \"code\": \"A9\",\n \"manufacturer\": null,\n \"product_category\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Irons\"\n },\n \"warehouses\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Helsinki Warehouse\",\n \"number_of_products\": 47\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Stockholm Warehouse\",\n \"number_of_products\": 3\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Projektilla\",\n \"number_of_products\": 0\n }\n ],\n \"number_of_products\": 47\n }\n ]\n }\n]"}],"_postman_id":"6695585c-648e-4bf4-a27d-9ef930097fa6"},{"name":"/v3/warehouses_with_product_amounts","id":"cba3c405-90c5-48e0-92ec-e56cd7f55cf0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses_with_product_amounts?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Get all accessible warehouses with amounts for selected Product.

\n","urlObject":{"path":["api","v3","warehouses_with_product_amounts"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

required params; product UUID

\n","type":"text/plain"},"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"dfd2622d-a51c-4f27-8290-ecee7882d9e3","name":"/v3/warehouses_with_product_amounts","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses_with_product_amounts?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","warehouses_with_product_amounts"],"query":[{"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"required params; product UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Kalliola A-hallin varasto\",\n \"product_amount\": 109.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Tyhjä varasto\",\n \"product_amount\": 0\n }\n]"}],"_postman_id":"cba3c405-90c5-48e0-92ec-e56cd7f55cf0"},{"name":"/v3/warehouses","id":"c9367eea-48d9-4559-a4d6-7afad81e7c50","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse\": {\r\n \"name\": \"Hakunilan varasto\",\r\n \"address\": \"Hakunilantie 23\",\r\n \"municipality\": \"Uusimaa\",\r\n \"zip_code\": \"08420\",\r\n \"city\": \"Vantaa\",\r\n \"country\": \"FI\",\r\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouses","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint allows you to create a new warehouse.

\n

Request Body

\n\n

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

Response

\n
{\n  \"type\": \"object\",\n  \"properties\": {\n    \"id\": {\"type\": \"string\"},\n    \"name\": {\"type\": \"string\"},\n    \"address\": {\"type\": \"string\"},\n    \"municipality\": {\"type\": \"string\"},\n    \"zip_code\": {\"type\": \"string\"},\n    \"city\": {\"type\": \"string\"},\n    \"country\": {\"type\": \"string\"},\n    \"created_at\": {\"type\": \"string\"},\n    \"updated_at\": {\"type\": \"string\"},\n    \"warehouse_slot_collection_id\": {\"type\": \"string\"},\n    \"warehouse_in_use\": {\"type\": \"boolean\"},\n    \"status\": {\"type\": \"string\"},\n    \"email_notification_id\": {\"type\": \"string\"}\n  }\n}\n\n
\n","urlObject":{"path":["api","v3","warehouses"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"80deb2bc-2b54-4389-9954-35bc17bec58e","name":"/v3/warehouses","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse\": {\r\n \"name\": \"Hakunilan varasto\",\r\n \"address\": \"Hakunilantie 23\",\r\n \"municipality\": \"Uusimaa\",\r\n \"zip_code\": \"08420\",\r\n \"city\": \"Vantaa\",\r\n \"country\": \"FI\",\r\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouses"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hakunilan varasto\",\n \"address\": \"Hakunilantie 23\",\n \"municipality\": \"Uusimaa\",\n \"zip_code\": \"08420\",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"created_at\": \"2023-08-30T19:28:48.985+03:00\",\n \"updated_at\": \"2023-08-30T19:28:48.985+03:00\",\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_in_use\": true,\n \"status\": \"in_use\",\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n}"}],"_postman_id":"c9367eea-48d9-4559-a4d6-7afad81e7c50"},{"name":"/v3/warehouses/:id","id":"12bb8194-c2de-4ba1-a55c-7ae6d8570c2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hakunilan varasto\",\r\n \"address\": \"Hakunilantie 23\",\r\n \"municipality\": \"Uusimaa\",\r\n \"zip_code\": \"08420\",\r\n \"city\": \"Vantaa\",\r\n \"country\": \"FI\",\r\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/warehouses/:id","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

This endpoint allows you to update the details of a specific warehouse.

\n

For patch request, you can update any of the provided fields (you can leave out unchanged fields).

\n\n","urlObject":{"path":["api","v3","warehouses",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":null,"key":"id"}]}},"response":[{"id":"08cb6a1b-d99e-4166-8987-3e5678c2781e","name":"/v3/warehouses/:id","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"warehouse\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Hakunilan varasto\",\r\n \"address\": \"Hakunilantie 23\",\r\n \"municipality\": \"Uusimaa\",\r\n \"zip_code\": \"08420\",\r\n \"city\": \"Vantaa\",\r\n \"country\": \"FI\",\r\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/warehouses/:id","host":["api","spotilla","fi"],"path":["api","v3","warehouses",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Hakunilan varasto\",\n \"address\": \"Hakunilantie 23\",\n \"municipality\": \"Uusimaa\",\n \"zip_code\": \"08420\",\n \"city\": \"Vantaa\",\n \"country\": \"FI\",\n \"created_at\": \"2023-08-30T19:28:48.985+03:00\",\n \"updated_at\": \"2023-08-30T19:28:48.985+03:00\",\n \"warehouse_slot_collection_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"warehouse_in_use\": true,\n \"status\": \"in_use\",\n \"email_notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n}"}],"_postman_id":"12bb8194-c2de-4ba1-a55c-7ae6d8570c2a"}],"id":"9568f201-0823-4867-a911-62492848f298","_postman_id":"9568f201-0823-4867-a911-62492848f298","description":""},{"name":"Warehouse Slots","item":[{"name":"/v3/warehouses/:warehouse_id/warehouse_slots","id":"a2c8c05e-a86a-4fd0-bc50-39661389c0d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

Get list of slots for a warehouse.

\n

Optional params:

\n\n","urlObject":{"path":["api","v3","warehouses",":warehouse_id","warehouse_slots"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

product UUID

\n","type":"text/plain"},"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[{"description":{"content":"

warehouse UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"warehouse_id"}]}},"response":[{"id":"fd67b233-e92b-4812-bcd8-7fc4a26bc1c2","name":"/v3/warehouses/:warehouse_id/warehouse_slots?product_id=:product_id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","warehouses",":warehouse_id","warehouse_slots"],"query":[{"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID, optional params"}],"variable":[{"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A1\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A3\",\n \"ref_1\": \"\",\n \"ref_2\": \"\"\n }\n]"}],"_postman_id":"a2c8c05e-a86a-4fd0-bc50-39661389c0d7"},{"name":"/v3/warehouses/:warehouse_id/warehouse_slots/:id/amount","id":"c43e0049-ad88-4eb0-b9be-a42df8131084","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots/:warehouse_slot_id/amount?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

This endpoint returns the amount of a specific product in a warehouse slot within a warehouse. The request should include the warehouse ID, warehouse slot ID, and the product ID as a query parameter.

\n","urlObject":{"path":["api","v3","warehouses",":warehouse_id","warehouse_slots",":warehouse_slot_id","amount"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

product UUID, required params

\n","type":"text/plain"},"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[{"description":{"content":"

warehouse UUID, required params

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"warehouse_id"},{"description":{"content":"

warehouse slot UUID, required params

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"warehouse_slot_id"}]}},"response":[{"id":"6a5b5f73-b4f7-49dc-9a17-f3256c13ba26","name":"/v3/warehouses/:warehouse_id/warehouse_slots/:warehouse_slot_id/amount?product_id=uuid","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/warehouses/:warehouse_id/warehouse_slots/:warehouse_slot_id/amount?product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","warehouses",":warehouse_id","warehouse_slots",":warehouse_slot_id","amount"],"query":[{"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}],"variable":[{"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"},{"key":"warehouse_slot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse slot UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"amount\": 10\n}"}],"_postman_id":"c43e0049-ad88-4eb0-b9be-a42df8131084"},{"name":"/v3/wh_slots_with_product_amounts","id":"2b1a6c4c-2946-44b0-86b0-bf1e25f3ade9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/wh_slots_with_product_amounts?warehouse_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

This endpoint retrieves all warehouse slots of the selected warehouse along with the amount of the selected product for each slot.

\n

Request Parameters

\n\n","urlObject":{"path":["api","v3","wh_slots_with_product_amounts"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

warehouse UUID, required params

\n","type":"text/plain"},"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

product UUID, required params

\n","type":"text/plain"},"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"cab6c5bf-c1b7-475a-9be9-623136e00cca","name":"/v3/wh_slots_with_product_amounts?warehouse_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/wh_slots_with_product_amounts?warehouse_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&product_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2","host":["api","spotilla","fi"],"path":["api","v3","wh_slots_with_product_amounts"],"query":[{"key":"warehouse_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"warehouse UUID"},{"key":"product_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"product UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"A1\",\n \"ref_1\": \"A1\",\n \"ref_2\": \"Vasen hyllyrivi\",\n \"product_amount\": 100.0\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"B4\",\n \"ref_1\": \"B4\",\n \"ref_2\": \"Vasen hyllyrivi\",\n \"product_amount\": 10.0\n },\n {\n \"id\": \"7003587a-8268-4130-9239-41542124bcb\",\n \"name\": \"C2\",\n \"ref_1\": \"C2\",\n \"ref_2\": \"Oikea hyllyrivi\",\n \"product_amount\": 0\n }\n]"}],"_postman_id":"2b1a6c4c-2946-44b0-86b0-bf1e25f3ade9"}],"id":"44c8a0a2-1468-44d6-bef0-ec99f09467cc","_postman_id":"44c8a0a2-1468-44d6-bef0-ec99f09467cc","description":""},{"name":"Purchase Batches","item":[{"name":"/v3/purchase_batches?product_id=:id&warehouse_id=:id&slot_id=:id&only_active=true","id":"4148b9b8-bb31-46c0-8208-6ef9476c67da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/purchase_batches?product_id=1234849-2f9d-4a92-868f-dff31c683365&warehouse_id=1234c645-bae7-4657-b2c4-1acf0b54e224&slot_id=1234e500-eac9-4e5f-ae19-b45159a8bc11&only_active=true","description":"

The request should include the warehouse ID, warehouse slot ID, and the product ID as a query parameter. This endpoint returns the related purchase batches of that product in selected warehouse slot. With only_active parameter you can get only those batches that still have products left. Do not add only_active parameter if you need to get all batches even if there is no products left.

\n","urlObject":{"path":["api","v3","purchase_batches"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

product UUID, required params

\n","type":"text/plain"},"key":"product_id","value":"1234849-2f9d-4a92-868f-dff31c683365"},{"description":{"content":"

warehouse UUID, required params

\n","type":"text/plain"},"key":"warehouse_id","value":"1234c645-bae7-4657-b2c4-1acf0b54e224"},{"description":{"content":"

warehouse slot UUID, required params

\n","type":"text/plain"},"key":"slot_id","value":"1234e500-eac9-4e5f-ae19-b45159a8bc11"},{"key":"only_active","value":"true"}],"variable":[]}},"response":[{"id":"368d93c2-506a-4040-a9ef-de5d958e2334","name":"/v3/purchase_batches?product_id=:id&warehouse_id=:id&slot_id=:id&only_active=true","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/purchase_batches?product_id=1234849-2f9d-4a92-868f-dff31c683365&warehouse_id=1234c645-bae7-4657-b2c4-1acf0b54e224&slot_id=1234e500-eac9-4e5f-ae19-b45159a8bc11&only_active=true","host":["api","spotilla","fi"],"path":["api","v3","purchase_batches"],"query":[{"key":"product_id","value":"1234849-2f9d-4a92-868f-dff31c683365","description":"product UUID"},{"key":"warehouse_id","value":"1234c645-bae7-4657-b2c4-1acf0b54e224"},{"key":"slot_id","value":"1234e500-eac9-4e5f-ae19-b45159a8bc11"},{"key":"only_active","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"35262a3e-97c7-4006-88f1-b9c14fd72006\",\n \"batch_number\": 10000024,\n \"customer_number\": \"any string\",\n \"status\": \"emptied\",\n \"products_received_at\": \"2024-11-01T15:38:06.377+02:00\",\n \"additional_notes\": \"any text\",\n \"expiry_date\": \"2024-12-01T15:38:06.377+02:00\",\n \"ref_amount_in_batch\": 10.0\n }\n]"}],"_postman_id":"4148b9b8-bb31-46c0-8208-6ef9476c67da"}],"id":"c45d74ee-42aa-4024-890c-a554b4d91564","_postman_id":"c45d74ee-42aa-4024-890c-a554b4d91564","description":""}],"id":"635f13a2-d6a9-42ac-8922-96b585b733d9","_postman_id":"635f13a2-d6a9-42ac-8922-96b585b733d9","description":""},{"name":"Notifications","item":[{"name":"/v3/users/:user_id/notification_topics","id":"71dbba33-4c1b-4ff6-8437-215fdec68361","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/users/:user_id/notification_topics?q[type]=service_request","description":"

This endpoint returns notification topics for a specific user based on the provided user ID and type.

\n

The request parameters include the user ID (required) in the URL path and the type (optional) in the query parameter.

\n

Other possible value for the \"type\" params: \"task\", \"service_request\", \"message\", \"sreq_complete\", \"sreq_comment\"

\n","urlObject":{"path":["api","v3","users",":user_id","notification_topics"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[type]","value":"service_request"}],"variable":[{"description":{"content":"

user UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"user_id"}]}},"response":[{"id":"2966ca00-7fd0-4a11-b841-005e0ac2a913","name":"/v3/users/:user_id/notification_topics","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v2/users/0bb9823e-12ff-44b4-8725-b9d75728afc5/notification_topics"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"notification_topics\": [\n \"tasks_4c5c9416-c4eb-44c2-b808-a456e53c3262\",\n \"service_requests_4c5c9416-c4eb-44c2-b808-a456e53c3262\",\n \"messages_4c5c9416-c4eb-44c2-b808-a456e53c3262\",\n \"tasks_0bb9823e-12ff-44b4-8725-b9d75728afc5\",\n \"service_requests_0bb9823e-12ff-44b4-8725-b9d75728afc5\",\n \"messages_0bb9823e-12ff-44b4-8725-b9d75728afc5\"\n ]\n}"}],"_postman_id":"71dbba33-4c1b-4ff6-8437-215fdec68361"},{"name":"/v3/filter_notifications","id":"33c2ccc7-268a-4f2e-8555-489ecaba2b02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"},{"key":"","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/filter_notifications?only_active=true&q[page]","description":"

This is the same old route:

\n

/v2/notifications?active_only=true

\n

Get only active notifications with separate parameter:

\n

?only_active=true

\n","urlObject":{"path":["api","v3","filter_notifications"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"only_active","value":"true"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":null}],"variable":[]}},"response":[{"id":"e3d5e6a4-5790-4cc8-aa08-a31ec0e6115b","name":"/v2/notifications","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"},{"key":"","type":"text","value":""}],"url":"api.spotilla.fi/api/v2/notifications"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"3fee27f1-df62-4466-a52d-3fdc887b37c4\",\n \"spot\": \"Gas bottle 10\",\n \"spot_id\": \"ba485fa2-77d0-44b9-872e-db098432f6ad\",\n \"due_date\": \"2021-04-13T00:00:00.000+03:00\",\n \"show_days_before\": 1,\n \"show_days_after\": 2,\n \"notification_heading\": \"Notification\",\n \"notification_description\": \"Notification for Gass bottle 10\",\n \"updated_by\": null,\n \"updated_by_name\": null\n },\n {\n \"id\": \"e44a74cf-6d8e-480d-906a-80ecdce22338\",\n \"spot\": \"Gas bottle 10\",\n \"spot_id\": \"ba485fa2-77d0-44b9-872e-db098432f6ad\",\n \"due_date\": \"2021-04-13T00:00:00.000+03:00\",\n \"show_days_before\": 0,\n \"show_days_after\": 1,\n \"notification_heading\": \"Muistutus1\",\n \"notification_description\": \"Muistutus kaasupullolle\",\n \"updated_by\": null,\n \"updated_by_name\": null\n }\n]"}],"_postman_id":"33c2ccc7-268a-4f2e-8555-489ecaba2b02"},{"name":"/v3/notifications","id":"f9e45a4e-4c9a-41a7-a266-284b0a440b92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/notifications?q[page]","description":"

Get all /paginated results of General Notifications.

\n

read_at-key tells if the current user has read the notification.

\n","urlObject":{"path":["api","v3","notifications"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":null}],"variable":[]}},"response":[{"id":"31ab7318-95a3-489b-85ab-46af8eb1dc80","name":"/v3/notifications","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/notifications"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"37232b8a-c9ab-4190-8e63-53d8a36ba819\",\n \"notif_type\": \"general\",\n \"notification_heading\": \"Kaikille tiedoksi\",\n \"notification_description\": \"Huomenna on katkoksia iltapäivällä.\",\n \"due_date\": \"2023-04-16T00:00:00.000+03:00\",\n \"show_days_before\": 2,\n \"show_days_after\": 5,\n \"read_at\": \"2023-04-17T13:14:06.113+03:00\"\n },\n {\n \"id\": \"2f7cc398-385a-47e0-acb2-5ab5a2323385d\",\n \"notif_type\": \"general\",\n \"notification_heading\": \"Notification to all!\",\n \"notification_description\": \"\",\n \"due_date\": \"2023-04-09T00:00:00.000+03:00\",\n \"show_days_before\": 0,\n \"show_days_after\": 365,\n \"read_at\": null\n }\n]"}],"_postman_id":"f9e45a4e-4c9a-41a7-a266-284b0a440b92"},{"name":"/v3/notifications/:id","id":"0aad8e5c-b3e0-4b5d-b248-86fde846f59d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/notifications/:id","description":"

Get selected General Notification.

\n","urlObject":{"path":["api","v3","notifications",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

notification UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"75af97ee-73d8-4fa3-9819-0e5c01517622","name":"/v3/notifications/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/notifications/:id","host":["api","spotilla","fi"],"path":["api","v3","notifications",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"notification UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":" {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"notif_type\": \"general\",\n \"notification_heading\": \"Kaikille tiedoksi\",\n \"notification_description\": \"Huomenna on katkoksia iltapäivällä.\",\n \"due_date\": \"2023-04-16T00:00:00.000+03:00\",\n \"show_days_before\": 2,\n \"show_days_after\": 5,\n \"read_at\": \"2023-04-17T13:14:06.113+03:00\"\n}\n"}],"_postman_id":"0aad8e5c-b3e0-4b5d-b248-86fde846f59d"},{"name":"/v3/unread_notifications","id":"dfaff613-338e-473b-9203-511590738b33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/unread_notifications?show_notifs=true","description":"

Get Unread Notifications

\n
\n

Description

\n

By default, this endpoint returns the count of unread general notifications. To include notification information, add the parameter show_notifs=true to the request.

\n

Request

\n\n

Response

\n

The response for this request is a JSON object with the following schema:

\n
[{\n  \"id\": \"{{random_id}}\",\n  \"notif_type\": \"general\",\n  \"notification_heading\": \"One more test for iOS\",\n  \"notification_description\": \"Can I see this?\",\n  \"due_date\": \"2023-05-08T00:00:00.000+03:00\",\n  \"show_days_before\": 0,\n  \"show_days_after\": 0,\n  \"read_at\": null,\n  \"created_by\": null\n}]\n\n
\n

Or send the request without the \"show_notif\" params:

\n
{\n  \"count\": 3\n}\n\n
\n

This schema represents the count of unread notifications.

\n","urlObject":{"path":["api","v3","unread_notifications"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"show_notifs","value":"true"}],"variable":[]}},"response":[{"id":"cf0485ae-d498-4715-b6df-625a074f4fa6","name":"/v3/unread_notifications","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/unread_notifications","host":["api","spotilla","fi"],"path":["api","v3","unread_notifications"],"query":[{"key":"show_notifs","value":"true","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"count\": 3\n}"}],"_postman_id":"dfaff613-338e-473b-9203-511590738b33"},{"name":"/v3/notifications/:id/mark_as_read","id":"ce41be2c-d4c7-464c-a47c-025180943686","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/notifications/:notif_id/mark_as_read","description":"

Marks notification as read by current user.

\n

No request body.

\n","urlObject":{"path":["api","v3","notifications",":notif_id","mark_as_read"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

notification UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"notif_id"}]}},"response":[{"id":"f8bfc934-dc89-4d70-891e-6829589fb9cc","name":"/v3/notifications/:id/mark_as_read","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"api.spotilla.fi/api/v3/notifications/:notif_id/mark_as_read","host":["api","spotilla","fi"],"path":["api","v3","notifications",":notif_id","mark_as_read"],"variable":[{"key":"notif_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"notification UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"notification_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // the same notif id as in the query params\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"read_at\": \"2023-04-17T14:38:38.331+03:00\",\n \"created_at\": \"2023-04-17T14:38:38.356+03:00\",\n \"updated_at\": \"2023-04-17T14:38:38.356+03:00\"\n}"}],"_postman_id":"ce41be2c-d4c7-464c-a47c-025180943686"},{"name":"/v3/spots/:spot_id/notifications","id":"951c6cc8-828f-44ef-8f6a-73c3280e7831","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/:spot_id/notifications","description":"

Retrieve Spot Notifications

\n

This endpoint allows you to retrieve all or only active notifications for a specific spot.

\n

Request

\n\n","urlObject":{"path":["api","v3","spots",":spot_id","notifications"],"host":["api","spotilla","fi"],"query":[{"disabled":true,"description":{"content":"

optional params (boolean)

\n","type":"text/plain"},"key":"only_active","value":null}],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"8bc50830-c45a-4f7a-b22a-01dd9d24e77d","name":"/v3/spots/:spot_id/notifications","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/ba485fa2-77d0-44b9-872e-db098432f6ad/notifications"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Gas bottle 10\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2021-04-13T00:00:00.000+03:00\",\n \"show_days_before\": 1,\n \"show_days_after\": 2,\n \"notification_heading\": \"Notification\",\n \"notification_description\": \"Notification for Gass bottle 10\",\n \"updated_by\": null,\n \"updated_by_name\": null,\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Super Man\"\n }\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"spot\": \"Gas bottle 10\",\n \"spot_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"due_date\": \"2021-04-13T00:00:00.000+03:00\",\n \"show_days_before\": 0,\n \"show_days_after\": 1,\n \"notification_heading\": \"Muistutus1\",\n \"notification_description\": \"Muistutus kaasupullolle\",\n \"updated_by\": null,\n \"updated_by_name\": null,\n \"created_by\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Super Man\"\n }\n }\n]"}],"_postman_id":"951c6cc8-828f-44ef-8f6a-73c3280e7831"}],"id":"296bf13a-51de-4603-a54b-ca56756750d7","_postman_id":"296bf13a-51de-4603-a54b-ca56756750d7","description":""},{"name":"Spot and Product Reservations","item":[{"name":"Reservations","item":[{"name":"/v3/spots/:spot_id/reservations","id":"409e7295-0cd5-4ece-965b-f3e3345f5702","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/:spot_id/reservations?q[status]=active","description":"

Get Active Reservations for a Spot

\n

The endpoint retrieves the reservations for a specific spot identified by the spot_id. You can filter the result with the query params \"status\".

\n

Possible values for query parameters:

\n\n

Response

\n

The response will include an array of active reservation objects, each containing the following properties:

\n\n","urlObject":{"path":["api","v3","spots",":spot_id","reservations"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[status]","value":"active"}],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"}]}},"response":[{"id":"157a2a97-263f-41ae-be10-c2f12e2e4df8","name":"/v3/spots/:spot_id/reservations","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/spots/cff28d83-786b-402a-ae50-ce53274fdec3/reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Reservation Batch\",\n \"explanation\": null,\n \"start_time\": \"2021-01-11T01:59:59.999+02:00\",\n \"end_time\": \"2021-02-01T01:59:59.999+02:00\",\n \"user\": {\n \"name\": \"Iron Man\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"active\",\n \"reservation_site\": {},\n \"fullday\": false,\n \"spot_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Batch for test\",\n \"explanation\": null,\n \"start_time\": \"2021-02-14T00:00:00.000+02:00\",\n \"end_time\": \"2021-02-28T00:00:00.000+02:00\",\n \"user\": {\n \"name\": \"Hello Kitty\",\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n },\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"active\",\n \"fullday\": false,\n \"reservation_site\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Project Lahti\"\n },\n \"spot_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n }\n]"}],"_postman_id":"409e7295-0cd5-4ece-965b-f3e3345f5702"},{"name":"v3/spot_reservations/filtered","id":"10d5de62-16d7-408c-98bb-a82db16e35b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spot_reservations/filtered?q[spot_name]=machine&q[reservable]=mikko&q[reservations_site_name]=mestari&q[status]=active","description":"

Usable query parameters:

\n

status: 'completed' or 'active'
reservations_site_name: 'string', name of reservation site
spot_name: 'string', name of spot
reservable_name: name of the user who created the reservation

\n","urlObject":{"path":["api","v3","spot_reservations","filtered"],"host":["api","spotilla","fi"],"query":[{"key":"q[spot_name]","value":"machine"},{"key":"q[reservable]","value":"mikko"},{"key":"q[reservations_site_name]","value":"mestari"},{"key":"q[status]","value":"active"}],"variable":[]}},"response":[{"id":"c5d9421b-aa21-4d78-8976-8abfa498c442","name":"v3/spot_reservations/filtered","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"status\": \"late\",\r\n \"spot_name\": \"erityis\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/spot_reservations/filtered?start_date=2021-08-01&end_date=2026-09-01&q[spot_name]=ilman&q[reservation_site_name]=itä&q[reservable]=Harri","host":["api","spotilla","fi"],"path":["api","v3","spot_reservations","filtered"],"query":[{"key":"start_date","value":"2021-08-01"},{"key":"end_date","value":"2026-09-01"},{"key":"q[spot_name]","value":"ilman"},{"key":"q[reservation_site_name]","value":"itä"},{"key":"q[reservable]","value":"Harri"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"cfbd56a6-f180-4693-871c-a67087cbb239\",\n \"name\": \"Customer Trip\",\n \"explanation\": \"\",\n \"start_time\": \"2024-10-07T00:00:00.000+03:00\",\n \"end_time\": \"2024-11-02T00:00:00.000+02:00\",\n \"user\": {\n \"name\": \"Mikko\",\n \"id\": \"1c54519b-b32f-48f8-9b6e-dfba4ab1acef\"\n },\n \"contact_name\": \"Mikko\",\n \"contact_phone\": \"05068532446\",\n \"contact_email\": \"mikko.mallikas@mikko.com\",\n \"status\": \"active\",\n \"reservation_site\": {\n \"id\": \"d7df3ef0-8d3e-456c-a522-460cbe367d90\",\n \"name\": \"Itämerenkatu Kohde\"\n },\n \"fullday\": false,\n \"spots\": [\n {\n \"id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\n \"name\": \"Ilmanvaihtokone ABC12 2\"\n }\n ],\n \"spot_ids\": [\n \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\"\n ]\n }\n]"}],"_postman_id":"10d5de62-16d7-408c-98bb-a82db16e35b5"},{"name":"v3/spot_reservations/batch_edit","id":"27425f88-285e-497b-a5cf-594522c8b945","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\n \"start_time\": \"2024-08-02 07:59:59\",\n \"end_time\": \"2024-08-02 08:59:59\", \n \"status\": \"active\", \n \"ids\":[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2, ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // spot_reservation uuid\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spot_reservations/batch_edit","description":"

This endpoint allows batch editing of spot reservations.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","spot_reservations","batch_edit"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"3b9bbc45-7651-4ae1-9dbd-33417b611455","name":"v3/spot_reservations/batch_edit","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"start_time\": \"2024-08-02 07:59:59\",\r\n \"end_time\": \"2024-08-02 08:59:59\", \r\n \"status\": \"active\", \r\n \"ids\":[\"ae68c14f-9512-490c-8d6a-a43e3ed290d2, ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] // spot_reservation uuid\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/spot_reservations/batch_edit"},"code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"msg\": \"Updated 2/2 reservations successfully\",\r\n \"errors\": []\r\n}"}],"_postman_id":"27425f88-285e-497b-a5cf-594522c8b945"},{"name":"v3/spots/:spot_id/reservations/:id","id":"c9d2ce18-51f0-4b5b-938d-9fa759540b74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"https://api.spotilla.fi/api/v3/spots/:spot_id/reservations/:id","description":"

Delete Spot Reservation

\n

This endpoint is used to delete a specific reservation for a spot.

\n

Request

\n\n

Response

\n

The response body for this request is empty, with a status code: 200

\n","urlObject":{"protocol":"https","path":["api","v3","spots",":spot_id","reservations",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

spot UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"spot_id"},{"description":{"content":"

spot reservation UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"15f06049-d2db-469a-86b0-91ef3614a31e","name":"v3/spots/:spot_id/reservations/:id","originalRequest":{"method":"DELETE","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"https://api.spotilla.fi/api/v3/spots/:spot_id/reservations/:id","protocol":"https","host":["api","spotilla","fi"],"path":["api","v3","spots",":spot_id","reservations",":id"],"variable":[{"key":"spot_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot UUID"},{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot reservation UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c9d2ce18-51f0-4b5b-938d-9fa759540b74"},{"name":"/v3/spot_reservations","id":"81cc165c-c3aa-40a8-b1e1-ff7762e95d8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"sRFE-pNPCMCy4zV6vAHU","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_reservations","description":"

This endpoint returns a list of active spot reservations.

\n

Request Body
This request does not require a request body.

\n

Response

\n\n","urlObject":{"path":["api","v3","spot_reservations"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"6eb36661-5860-4254-9d23-e569ff43fc85","name":"/v3/active_spot_reservations","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/legacy_spot_reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"26109bfd-2469-425a-8f16-2d6332f3b2a2\",\n \"name\": \"Reservation Batch\",\n \"explanation\": null,\n \"start_time\": \"2021-01-11T01:59:59.999+02:00\",\n \"end_time\": \"2021-02-01T01:59:59.999+02:00\",\n \"user\": {},\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"completed\",\n \"reservation_site\": {},\n \"spot_ids\": [\n \"0517e77d-56aa-41ba-ba81-b9bee4d7fc7c\"\n ],\n \"spots\": [\n {\n \"id\": \"0517e77d-56aa-41ba-ba81-b9bee4d7fc7c\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n },\n {\n \"id\": \"493c4d5f-6116-4a00-aa3b-c296ddc6ab7a\",\n \"name\": \"Batch for test\",\n \"explanation\": null,\n \"start_time\": \"2025-02-14T00:00:00.000+02:00\",\n \"end_time\": \"2025-02-28T00:00:00.000+02:00\",\n \"user\": {},\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"active\",\n \"reservation_site\": {\n \"id\": \"53bb13a2-1841-4d66-bc78-7cfae46e75ce\",\n \"name\": \"Project Lahti\"\n },\n \"spot_ids\": [\n \"0517e77d-56aa-41ba-ba81-b9bee4d7fc7c\"\n ],\n \"spots\": [\n {\n \"id\": \"0517e77d-56aa-41ba-ba81-b9bee4d7fc7c\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n }\n]"}],"_postman_id":"81cc165c-c3aa-40a8-b1e1-ff7762e95d8d"},{"name":"/v3/spot_reservations_calendar","id":"5694696a-c269-424d-919f-47be4e6b45b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/spot_reservations/calendar_reservations?start_date=2021-08-01&end_date=2024-09-01&q[spot_name]=machine","description":"

Get list of spot reservations whose due date is within the time range: start_date ≤ due_date ≤end_date.

\n

If either start_date or end_date is not provided (blank), the code sets start_date to the first day of the current month and end_date to the last day of the current month.

\n

Usable query parameters:

\n

status: 'completed' or 'active'
reservations_site_name: 'string', name of reservation site
spot_name: 'string', name of spot
reservable_name: name of the user who created the reservation

\n","urlObject":{"path":["api","v3","spot_reservations","calendar_reservations"],"host":["api","spotilla","fi"],"query":[{"key":"start_date","value":"2021-08-01"},{"key":"end_date","value":"2024-09-01"},{"key":"q[spot_name]","value":"machine"}],"variable":[]}},"response":[{"id":"fc78f797-8860-413d-bf7f-99d33a769414","name":"v3/spot_reservations/calendar_reservations","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/spot_reservations/calendar_reservations?start_date=2021-08-01&end_date=2024-09-01&q[spot_name]=machine&q[reservation_site_name]=mestari","host":["api","spotilla","fi"],"path":["api","v3","spot_reservations","calendar_reservations"],"query":[{"key":"start_date","value":"2021-08-01"},{"key":"end_date","value":"2024-09-01"},{"key":"q[spot_name]","value":"machine"},{"key":"q[reservation_site_name]","value":"mestari","type":"text"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"cfbd56a6-f180-4693-871c-a67087cbb239\",\n \"name\": \"Customer Trip\",\n \"explanation\": \"\",\n \"start_time\": \"2024-10-07T00:00:00.000+03:00\",\n \"end_time\": \"2024-11-02T00:00:00.000+02:00\",\n \"user\": {\n \"name\": \"Harri\",\n \"id\": \"1c54519b-b32f-48f8-9b6e-dfba4ab1acef\"\n },\n \"contact_name\": \"Harri\",\n \"contact_phone\": \"05068532446\",\n \"contact_email\": \"harri@harri.com\",\n \"status\": \"active\",\n \"reservation_site\": {\n \"id\": \"d7df3ef0-8d3e-456c-a522-460cbe367d90\",\n \"name\": \"Itämerenkatu Kohde\"\n },\n \"fullday\": false,\n \"spots\": [\n {\n \"id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\n \"name\": \"Ilmanvaihtokone ABC12 2\"\n }\n ],\n \"spot_ids\": [\n \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\"\n ]\n },\n {\n \"id\": \"e6f09b6f-5f31-4dd8-9314-189b1c270777\",\n \"name\": \"Hellurei\",\n \"explanation\": \"\",\n \"start_time\": \"2024-08-27T00:00:00.000+03:00\",\n \"end_time\": \"2024-09-26T00:00:00.000+03:00\",\n \"user\": {\n \"name\": \"Pekka\",\n \"id\": \"1c54519b-b32f-48f8-9b6e-dfba4ab1acef\"\n },\n \"contact_name\": \"\",\n \"contact_phone\": \"\",\n \"contact_email\": \"\",\n \"status\": \"active\",\n \"reservation_site\": {},\n \"fullday\": true,\n \"spots\": [\n {\n \"id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\n \"name\": \"Ilmanvaihtokone ABC12 2\"\n }\n ],\n \"spot_ids\": [\n \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\"\n ]\n },\n {\n \"id\": \"c3429be7-adf8-4ebe-b01c-da2b98ea9237\",\n \"name\": \"Mestari\",\n \"explanation\": \"\",\n \"start_time\": \"2024-07-02T00:00:00.000+03:00\",\n \"end_time\": \"2024-08-08T00:00:00.000+03:00\",\n \"user\": {\n \"name\": \"Mikko\",\n \"id\": \"1c54519b-b32f-48f8-9b6e-dfba4ab1acef\"\n },\n \"contact_name\": \"\",\n \"contact_phone\": \"\",\n \"contact_email\": \"\",\n \"status\": \"completed\",\n \"reservation_site\": {},\n \"fullday\": false,\n \"spots\": [\n {\n \"id\": \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\",\n \"name\": \"Ilmanvaihtokone ABC12 2\"\n }\n ],\n \"spot_ids\": [\n \"728bd281-5440-4b8b-8ce7-d0d5ff71e1ba\"\n ]\n }\n]"}],"_postman_id":"5694696a-c269-424d-919f-47be4e6b45b3"},{"name":"/v3/legacy_spot_reservations","id":"9309c177-11e6-452c-9770-db98e90da378","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"sRFE-pNPCMCy4zV6vAHU","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"}],"url":"api.spotilla.fi/api/v3/legacy_spot_reservations?reservation_site_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[status]=ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"

This endpoint is the same as the old route:
v2/spot_reservations

\n

This endpoint retrieves a list of spot reservations. Results can be filtered with the following query params (optional):

\n\n

Request

\n\n

Response

\n

The response will be an array of objects with the following properties:

\n\n","urlObject":{"path":["api","v3","legacy_spot_reservations"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"reservation_site_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[status]","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}],"variable":[]}},"response":[{"id":"638f2ba2-df23-44f3-a27a-678da526adb8","name":"/v3/spot_reservations","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/spot_reservations?reservation_site_id=ae68c14f-9512-490c-8d6a-a43e3ed290d2&q[status]","host":["api","spotilla","fi"],"path":["api","v3","spot_reservations"],"query":[{"key":"reservation_site_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"optional params"},{"key":"q[status]","value":null,"description":"optional params"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Reservation Batch\",\n \"explanation\": null,\n \"start_time\": \"2021-01-11T01:59:59.999+02:00\",\n \"end_time\": \"2021-02-01T01:59:59.999+02:00\",\n \"user\": {},\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"completed\",\n \"reservation_site\": {},\n \"spot_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Batch for test\",\n \"explanation\": null,\n \"start_time\": \"2025-02-14T00:00:00.000+02:00\",\n \"end_time\": \"2025-02-28T00:00:00.000+02:00\",\n \"user\": {},\n \"contact_name\": null,\n \"contact_phone\": null,\n \"contact_email\": null,\n \"status\": \"active\",\n \"reservation_site\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Project Lahti\"\n },\n \"spot_ids\": [\n \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n ],\n \"spots\": [\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Fire Extinguisher 1\"\n }\n ]\n }\n]"}],"_postman_id":"9309c177-11e6-452c-9770-db98e90da378"}],"id":"c1145a01-af67-4194-9029-cba633830ebe","_postman_id":"c1145a01-af67-4194-9029-cba633830ebe","description":""},{"name":"Reservation Sites","item":[{"name":"/v3/reservation_sites","id":"8e090d93-4ca9-4838-8d11-e3a709b1b316","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/reservation_sites?q[search]","description":"

This API endpoint returns a list of reservation sites

\n

Query params (optional):

\n

q[search]: filter reservation sites by name.

\n","urlObject":{"path":["api","v3","reservation_sites"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[search]","value":null}],"variable":[]}},"response":[{"id":"2406e91c-45fc-4cb4-9b68-4ba6eac51d43","name":"/v3/reservation_sites","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":{"raw":"api.spotilla.fi/api/v3/reservation_sites?q[search]=Project","host":["api","spotilla","fi"],"path":["api","v3","reservation_sites"],"query":[{"key":"q[search]","value":"Project","description":"optional params"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"0a2b34bc-e040-44bc-8264-28ae8ec9f19c\",\n \"name\": \"Project Espoo 4024\",\n \"description\": \"\",\n \"address\": \"\",\n \"postcode\": \"4422-432632-43\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"sitecode\": \"\",\n \"sitekey\": \"\",\n \"status\": \"active\",\n \"manager_id\": null,\n \"created_at\": \"2021-01-04T12:15:50.897+02:00\",\n \"updated_at\": \"2021-03-02T11:37:54.511+02:00\",\n \"spot_reservation_count\": 0,\n \"product_reservation_count\": 11\n },\n {\n \"id\": \"f87155c0-ff46-4ae2-a69e-5ffe029aec9a\",\n \"name\": \"Project Göteborg\",\n \"description\": \"\",\n \"address\": \"\",\n \"postcode\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"sitecode\": \"\",\n \"sitekey\": \"\",\n \"status\": \"active\",\n \"manager_id\": null,\n \"created_at\": \"2021-01-04T12:14:25.325+02:00\",\n \"updated_at\": \"2021-01-04T12:14:25.325+02:00\",\n \"spot_reservation_count\": 1,\n \"product_reservation_count\": 3\n }\n]"}],"_postman_id":"8e090d93-4ca9-4838-8d11-e3a709b1b316"},{"name":"/v3/reservation_sites/:id","id":"40e7971e-19b2-43dc-8729-42bfb0fb79af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/reservation_sites/:id","description":"

This endpoint returns information about a specific reservation site identified by its UUID.

\n","urlObject":{"path":["api","v3","reservation_sites",":id"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

reservation site UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"0979bf2d-5806-4ca2-a2cd-7b278a51cf6a","name":"/v3/reservation_sites/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":"sRFE-pNPCMCy4zV6vAHU"},{"key":"X-User-Id","type":"text","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036"},{"key":"X-User-Subdomain","type":"text","value":"kunnossapitodemo"}],"url":{"raw":"api.spotilla.fi/api/v2/reservation_sites/:id","host":["api","spotilla","fi"],"path":["api","v2","reservation_sites",":id"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"reservation site UUID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"reservation site 1\",\r\n \"description\": \"reservation site 1\",\r\n \"address\": \"Albergenkatu 12\",\r\n \"postcode\": \"00100\",\r\n \"city\": \"Helsinki\",\r\n \"state\": \"Uusimaa\",\r\n \"country\": \"Finland\",\r\n \"sitecode\": \"1\",\r\n \"sitekey\": \"1\",\r\n \"status\": \"active\",\r\n \"manager_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"created_at\": \"2024-05-28T07:20:23.078Z\",\r\n \"updated_at\": \"2024-05-28T07:20:23.078Z\",\r\n \"spot_reservation_count\": 1,\r\n \"product_reservation_count\": 3\r\n}"}],"_postman_id":"40e7971e-19b2-43dc-8729-42bfb0fb79af"}],"id":"fe6b6746-b1e0-4bcf-aee5-d9524dede5ae","_postman_id":"fe6b6746-b1e0-4bcf-aee5-d9524dede5ae","description":""}],"id":"d95985f6-b271-4fa5-893b-8b46d871a04e","_postman_id":"d95985f6-b271-4fa5-893b-8b46d871a04e","description":""},{"name":"Event Feed","item":[{"name":"v3/event_feed","id":"8dfc5c53-622d-46f2-8e82-46e432e91485","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/event_feed?q[page]=1","description":"

General Info

\n

Event feed is a way to get a stream of latest events from the key models of Spotilla.

\n

Event Feed can include changes to these models:

\n\n

Use for_item_id parameter if you want the changes for one item.

\n

Events can be create & update

\n

Nested changes can only be related models for example: Spot might have a spot attribute changed, in which case nested changes value would be [\"SpotAttribute\"]

\n

Changed property can include both relations and items own fields for example:
if messages body (messages own field) was changed value would be [\"body\"]
if task responsible (relation) was changed value would be [\"Responsible\"]
items own fields will always use snake_case (small letters and _ separator) while relations will be always represented with CamelCase (big start letters)

\n

DATA PROPERTIES

\n

whodunnit(string): value is always an email, field is always populated

\n

whodunnit_user(object): value can be null when user has been removed from the system, when value is present three object with tree properties will be present (id, name, email)

\n

update_changes(object): null for create events, present for updates

\n\n

date(datetime string): always present

\n

event(string): can be create or update

\n

object_name(string): created or updated items name

\n

item_type(string): one of [\"Task\", \"Spot\", \"Message\", \"ServiceRequest\"]

\n

item_id(string): id of changed item

\n","urlObject":{"path":["api","v3","event_feed"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"q[page]","value":"1"},{"disabled":true,"key":"for_item_id","value":"6443e9d0-75a1-45a7-8957-db6c05bc94343"}],"variable":[]}},"response":[{"id":"a9ad5d13-172d-4824-97db-8a907be0aa70","name":"v3/event_feed","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/event_feed?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","event_feed"],"query":[{"key":"q[page]","value":"1"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 25587,\n \"date\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"whodunnit\": \"{{rand_email}}\",\n \"whodunnit_user\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"{{rand_name}}\",\n \"email\": \"{{rand_email}}\"\n },\n \"item_type\": \"Spot\",\n \"item_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"event\": \"update\",\n \"object_name\": \"Spot23\",\n \"update_changes\": {\n \"meta_change\": false,\n \"changed\": [\n \"ServiceRequestCategory\"\n ],\n \"status_change\": null,\n \"nested_changes\": [\n \"SpotAttribute\"\n ]\n }\n },\n {\n \"id\": 25580,\n \"date\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"whodunnit\": \"{{rand_email}}\",\n \"whodunnit_user\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Spider Man\",\n \"email\": \"{{rand_email}}\"\n },\n \"item_type\": \"Task\",\n \"item_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"event\": \"update\",\n \"object_name\": \"Tarkista tehtävälomakkeen osioiden järjestys\",\n \"update_changes\": {\n \"meta_change\": true,\n \"changed\": [\n \"Responsible\"\n ],\n \"status_change\": null,\n \"nested_changes\": null\n }\n },\n {\n \"id\": 25578,\n \"date\": \"2021-10-07T12:12:12.983+03:00\",\n \"whodunnit\": \"{{rand_email}}\",\n \"whodunnit_user\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Spider Man\",\n \"email\": \"{{rand_email}}\"\n },\n \"item_type\": \"Task\",\n \"item_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"event\": \"update\",\n \"object_name\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"update_changes\": {\n \"meta_change\": true,\n \"changed\": [\n \"status\"\n ],\n \"status_change\": [\n \"active\",\n \"in_progress\"\n ],\n \"nested_changes\": null\n }\n },\n {\n \"id\": 25566,\n \"date\": \"2021-10-06T10:57:18.976+03:00\",\n \"whodunnit\": \"{{rand_email}}\",\n \"whodunnit_user\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Admin User\",\n \"email\": \"{{rand_email}}\"\n },\n \"item_type\": \"ServiceRequest\",\n \"item_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"event\": \"create\",\n \"object_name\": \"testi\",\n \"update_changes\": null\n },\n {\n \"id\": 25540,\n \"date\": \"2021-10-01T14:59:53.420+03:00\",\n \"whodunnit\": \"{{rand_email}}\",\n \"whodunnit_user\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"{{rand_name}}\",\n \"email\": \"{{rand_email}}\"\n },\n \"item_type\": \"Message\",\n \"item_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"event\": \"update\",\n \"object_name\": \"333,3\",\n \"update_changes\": {\n \"meta_change\": true,\n \"changed\": [\n ],\n \"status_change\": null,\n \"nested_changes\": null\n }\n }\n]"}],"_postman_id":"8dfc5c53-622d-46f2-8e82-46e432e91485"},{"name":"v3/event_feed/spot_attribute_changelogs/:id","id":"a2fdbb5f-100b-430e-a801-07b6aeb26740","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"url":"api.spotilla.fi/api/v3/event_feed/spot_attribute_changelogs/:id?q[page]=1","description":"

GENERAL INFO

\n

Display changelogs for a spot attribute: from the latest to the oldest (100 changelogs per page).

\n

IMPORTANT DATA PROPERTIES

\n

value (array): contains the \"previous value\" and the \"current value\";

\n

updated_at (array): updated time for the \"previous value\", and updated time for the \"current value\";

\n","urlObject":{"path":["api","v3","event_feed","spot_attribute_changelogs",":id"],"host":["api","spotilla","fi"],"query":[{"key":"q[page]","value":"1"}],"variable":[{"description":{"content":"

spot attribute UUID

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"636493e8-e681-4ff8-be64-443501939fc7","name":"v3/event_feed/spot_attribute_changelogs/:id","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/event_feed/spot_attribute_changelogs/:id?q[page]=1","host":["api","spotilla","fi"],"path":["api","v3","event_feed","spot_attribute_changelogs",":id"],"query":[{"key":"q[page]","value":"1"}],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"spot attribute UUID"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 25587,\n \"created_at\": \"2021-10-07T12:50:43.810+03:00\",\n \"object_changes\": {\n \"value\": [\n \"g\", \n \"h\"\n ],\n \"updated_at\": [\n \"2023-10-07T00:14:01.387+03:00\",\n \"2023-10-07T00:14:11.074+03:00\"\n ]\n }\n },\n {\n \"id\": 25588,\n \"created_at\": \"2021-10-07T12:50:43.810+03:00\",\n \"object_changes\": {\n \"value\": [\n \"f\",\n \"g\"\n ],\n \"updated_at\": [\n \"2023-10-07T00:13:46.359+03:00\",\n \"2023-10-07T00:14:01.387+03:00\"\n ]\n }\n }\n \n]"}],"_postman_id":"a2fdbb5f-100b-430e-a801-07b6aeb26740"}],"id":"e02f30d8-7104-4a78-8a7f-0784d3bff962","_postman_id":"e02f30d8-7104-4a78-8a7f-0784d3bff962","description":""},{"name":"Signatures","item":[{"name":"/v3/pending_signatures","id":"4a0a90d0-ff9f-48b8-a703-60e2b36e4abf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"resource_type\": \"all\", // possible options for this field: \"task\", \"service_request\", \"all\"\n \"include_externals\": false // pass true to inlcude pending signatures from external users\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/pending_signatures","description":"

This endpoint allows you to retrieve pending signatures for a specific resource type and optionally include pending signatures from external users.

\n

Request Body

\n\n

Response Body

\n

The response will include a list of tasks or/and service requests that are ready for signatures.

\n

Note:

\n

A task will not appear on this list if:

\n\n

A service request that has a status other than \"is_open\" or \"in_progress\" will not appear on this list.

\n","urlObject":{"path":["api","v3","pending_signatures"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"ff85dd9b-15a6-4d9b-96e1-471e9ad8d920","name":"/v3/pending_signatures","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"resource_type\": \"all\", // possible options for this field: \"task\", \"service_request\", \"all\"\n \"include_externals\": false // pass true to inlcude pending signatures from external users\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/pending_signatures"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Door is broken\",\n \"created_at\": \"2024-08-20T18:29:02.000Z\",\n \"due_date\": null,\n \"type\": \"ServiceRequest\",\n \"status\": \"in_progress\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Room temperature is too low\",\n \"created_at\": \"2024-09-10T13:34:16.023Z\",\n \"due_date\": null,\n \"type\": \"ServiceRequest\",\n \"status\": \"in_progress\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"Yearly inspection\",\n \"created_at\": \"2024-09-15T15:59:46.148Z\",\n \"due_date\": \"2023-04-13T21:00:00.000Z\",\n \"type\": \"Task\",\n \"status\": \"in_progress\"\n }\n]"}],"_postman_id":"4a0a90d0-ff9f-48b8-a703-60e2b36e4abf"},{"name":"/v3/signatures","id":"50613fd2-19c8-4339-aef8-2fc9ef09741f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"signature\": {\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // skip passing this field if service_request_id exists\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // skip passing this field if task_id exists\n \"signature_template_id\":\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/signatures","description":"

This endpoint is used to create a signature with the provided parameters.

\n

Request Body

\n\n","urlObject":{"path":["api","v3","signatures"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"8329791b-7794-4021-a8a0-0f17a31739fc","name":"v3/signatures","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","description":"sign in token","type":"text"},{"key":"X-User-Id","value":"","description":"users id which was used to sign in","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same subdomain as was used in sign in","type":"text"}],"body":{"mode":"raw","raw":"{\n \"signature\": {\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // skip passing this field if service_request_id exists\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // skip passing this field if task_id exists\n \"signature_template_id\":\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/signatures"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"signature_template_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"task_id\": null,\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"user_account_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // user account id of the signature name, if the signature is required from a spotilla user\n \"signature_name\": \"test manager account\",\n \"external_user\": false, // this field will be true, if the \"user_account_id\" field is empty\n \"signed\": false, // only after the user has post the signature image to this signature instance, this field will updated to be \"true\"\n \"signed_by\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // user account id of the signer\n \"created_at\": \"2024-09-27T11:48:01.999+03:00\",\n \"updated_at\": \"2024-09-27T11:48:01.999+03:00\"\n}"}],"_postman_id":"50613fd2-19c8-4339-aef8-2fc9ef09741f"},{"name":"/v3/signatures_by_count","id":"1a0e499d-9bcb-4f8e-9ca8-2b34a72ad5ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/signatures_by_count","description":"

This endpoint retrieves the count of resources (tasks, service requests) that has pending signatures for the current user.

\n

By default, it only includes resources with pending signatures for the current Spotilla user. To include resources with pending signatures for external users as well, you can pass the query parameter include_externals=true.

\n","urlObject":{"path":["api","v3","signatures_by_count"],"host":["api","spotilla","fi"],"query":[{"disabled":true,"description":{"content":"

Optional; default value is false

\n","type":"text/plain"},"key":"include_externals","value":"true"}],"variable":[]}},"response":[{"id":"f33a8054-e3a2-49cd-a0d2-3a028c928045","name":"v3/signatures_by_count","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"sign in token","type":"text"},{"key":"X-User-Id","value":"","description":"users id which was used to sign in","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same subdomain as was used in sign in","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/signatures_by_count","host":["api","spotilla","fi"],"path":["api","v3","signatures_by_count"],"query":[{"key":"include_externals","value":"false","description":"optional params. default is false;","disabled":true}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"all_pending_items_count\": 6,\n \"pending_tasks_count\": 3,\n \"pending_sreqs_count\": 3\n}"}],"_postman_id":"1a0e499d-9bcb-4f8e-9ca8-2b34a72ad5ae"},{"name":"/v3/signatures/:id/file","id":"b23f9285-78ac-4531-be4c-ec6f936d2f6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/signatures/:id/file","description":"

This endpoint is for retrieving the information of the signature image instance.

\n","urlObject":{"path":["api","v3","signatures",":id","file"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

signature uuid

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"d2cdc49b-72da-4bb7-b9f4-c886a19a25f9","name":"/v3/signatures/:id/file","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"sign in token","type":"text"},{"key":"X-User-Id","value":"","description":"users id which was used to sign in","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same subdomain as was used in sign in","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/signatures/:id/file","host":["api","spotilla","fi"],"path":["api","v3","signatures",":id","file"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"signature uuid"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"content_type\": \"image/png\",\n \"created_at\": \"2024-09-27T12:07:36.590+03:00\",\n \"header\": \"signature.png\",\n \"uploaded_by\": \"test manager account\",\n \"thumbnail_url\": \"{{rand_url}}\",\n \"url\": \"{{rand_url}}\",\n \"target_type\": \"Signature\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // the uuid of the signature instance\n}"}],"_postman_id":"b23f9285-78ac-4531-be4c-ec6f936d2f6b"},{"name":"/v3/service_requests/:id/signatures","id":"c392d808-7fef-4779-9f94-859acaea569c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/service_requests/:id/signatures","description":"

This endpoint retrieves both signed and unsigned signatures for a specific service request UUID, provided the user has the correct permission.

\n

Request Body

\n

This request does not require a request body.

\n

Response

\n\n","urlObject":{"path":["api","v3","service_requests",":id","signatures"],"host":["api","spotilla","fi"],"query":[],"variable":[{"description":{"content":"

service request uuid

\n","type":"text/plain"},"type":"any","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","key":"id"}]}},"response":[{"id":"dc0b3665-4483-47e6-805d-335f701ee2bb","name":"/v3/service_requests/:id/signatures","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"sign in token","type":"text"},{"key":"X-User-Id","value":"","description":"users id which was used to sign in","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same subdomain as was used in sign in","type":"text"}],"url":{"raw":"api.spotilla.fi/api/v3/service_requests/:id/signatures","host":["api","spotilla","fi"],"path":["api","v3","service_requests",":id","signatures"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"object_type\": \"Signature Template\",\n \"signature_name\": \"Joshua Ubber\",\n \"external_user\": true,\n \"signed\": null,\n \"signed_by\": null,\n \"user_account\": null,\n \"can_sign\": true,\n \"signed_at\": \"Pending signature\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"object_type\": \"Signature\",\n \"signature_name\": \"John Allen\",\n \"external_user\": false,\n \"signed\": true,\n \"signed_by\": \"John Allen\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Allen\"\n },\n \"can_sign\": false,\n \"signed_at\": \"2024-09-27T12:07:36.590+03:00\"\n }\n]"}],"_postman_id":"c392d808-7fef-4779-9f94-859acaea569c"},{"name":"/v3/tasks/:id/signatures","id":"3d8a3a43-9184-42ca-b234-057ae04b0a7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"

sign in token

\n","type":"text"},{"key":"X-User-Id","value":"","description":"

users id which was used to sign in

\n","type":"text"},{"key":"X-User-Subdomain","value":"","description":"

the same subdomain as was used in sign in

\n","type":"text"}],"url":"api.spotilla.fi/api/v3/tasks/:id/signatures","description":"

GET /api/v3/tasks/:id/signatures

\n

This endpoint retrieves both signed and unsigned signatures for a specific task UUID, provided the user has the correct permission.

\n

Response

\n\n","urlObject":{"path":["api","v3","tasks",":id","signatures"],"host":["api","spotilla","fi"],"query":[],"variable":[{"type":"any","value":"","key":"id"}]}},"response":[{"id":"8ceb8485-a390-41be-950c-53fffcf6bef8","name":"/v3/tasks/:id/signatures","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","description":"sign in token","type":"text"},{"key":"X-User-Id","value":"","description":"users id which was used to sign in","type":"text"},{"key":"X-User-Subdomain","value":"","description":"the same subdomain as was used in sign in","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"api.spotilla.fi/api/v3/tasks/:id/signatures","host":["api","spotilla","fi"],"path":["api","v3","tasks",":id","signatures"],"variable":[{"key":"id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"task uuid"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"object_type\": \"Signature Template\",\n \"signature_name\": \"Joshua Ubber\",\n \"external_user\": true,\n \"signed\": null,\n \"signed_by\": null,\n \"user_account\": null,\n \"can_sign\": true,\n \"signed_at\": \"Pending signature\"\n },\n {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"object_type\": \"Signature\",\n \"signature_name\": \"John Allen\",\n \"external_user\": false,\n \"signed\": true,\n \"signed_by\": \"John Allen\",\n \"user_account\": {\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"name\": \"John Allen\"\n },\n \"can_sign\": false,\n \"signed_at\": \"2024-09-27T12:07:36.590+03:00\"\n }\n]"}],"_postman_id":"3d8a3a43-9184-42ca-b234-057ae04b0a7b"}],"id":"de553f2f-e95b-486a-9c8b-7b3f8ea25fb5","description":"

Uploading files to resources.

\n","_postman_id":"de553f2f-e95b-486a-9c8b-7b3f8ea25fb5"},{"name":"UploadItems","item":[{"name":"/v3/omni_upload","id":"03796760-267e-41d7-9e28-451a6b6b5c61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"

sign in token

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

users id which was used to sign in

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same subdomain as was used in sign in

\n"}],"body":{"mode":"formdata","formdata":[{"key":"target_type","value":"Spot","description":"

can be any of: [ServiceRequest, Spot, Task, TaskSection]

\n","type":"text"},{"key":"target_id","value":"bcc4a269-42db-4638-afbb-8f99bc8bf774","type":"text"},{"key":"upload_item","description":"

any file with supported filetype (only 1 file)

\n","type":"file","value":null},{"key":"chunk_tracker_id","value":"","description":"

(don't include in file transfer) include in all chunk requests (/chunk_meta)

\n","type":"text","disabled":true},{"key":"last_chunk","value":"false","description":"

(don't include in file transfer) set to true for last chunk

\n","type":"text","disabled":true}]},"url":"api.spotilla.fi/api/v3/omni_upload","description":"

General Info

\n

/omni_upload is a general uploader endpoint which supports both file transfer and chunked file upload.

\n

Uploads can be made to following resources:

\n\n

Note: if uploads are made to file badge:

\n\n

For chunked upload a meta data request must be made before uploading chunks in a sequence, for more information on chunk metadata see documentation for:

\n

/v3/chunk_meta

\n

/v3/omni_upload (file chunks)

\n
\n

Note that for chunk upload the last_chunk needs to be set to true to finish the upload.

\n
\n","urlObject":{"path":["api","v3","omni_upload"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"1c23fd6d-5d86-4049-a506-bf21199b397a","name":"/v3/omni_upload (file_transfer)","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"target_type","value":"Spot","description":"can be any of: [ServiceRequest, Spot, Task, TaskSection, Signature]","type":"text"},{"key":"target_id","value":"bcc4a269-42db-4638-afbb-8f99bc8bf774","type":"text"},{"key":"upload_item","description":"any file with supported filetype","type":"file","value":null},{"key":"file_badge_id","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","description":"UUID of a file badge (optional field, and if this field exsit, target type should be Spot)","type":"text","uuid":"9e55f741-5ef7-4814-a95b-3399334cb0ed"}]},"url":"api.spotilla.fi/api/v3/omni_upload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"54e577ac-55d2-466d-97b4-24536c161064\",\n \"content_type\": \"audio/mpeg\",\n \"created_at\": \"2023-03-15T10:41:37.296+02:00\",\n \"header\": \"Some Randowm Audio File.mp3\",\n \"uploaded_by\": \"Sampo Sahla\",\n \"thumbnail_url\": \"https://api.spotilla.fi\",\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/54e577ac-55d2-466d-97b4-24536c161064\",\n \"target_class\": \"Spot\",\n \"target_id\": \"bcc4a269-42db-4638-afbb-8f99bc8bf774\"\n}"},{"id":"24ce8d70-cb9e-4d6f-ab27-8e5e05d7c673","name":"/v3/omni_upload (file chunks)","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"formdata","formdata":[{"key":"target_type","value":"Spot","description":"can be any of: [ServiceRequest, Spot, Task, TaskSection]","type":"text"},{"key":"target_id","value":"bcc4a269-42db-4638-afbb-8f99bc8bf774","type":"text"},{"key":"upload_item","description":"any file with supported filetype","type":"file","value":null},{"key":"chunk_tracker_id","value":"","description":"include in all chunk requests (/chunk_meta)","type":"text"},{"key":"last_chunk","value":"false","description":"set to true for last chunk","type":"text"}]},"url":"api.spotilla.fi/api/v3/omni_upload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"54e577ac-55d2-466d-97b4-24536c161064\",\n \"content_type\": \"audio/mpeg\",\n \"created_at\": \"2023-03-15T10:41:37.296+02:00\",\n \"header\": \"Some Randowm Audio File.mp3\",\n \"uploaded_by\": \"Sampo Sahla\",\n \"thumbnail_url\": \"https://api.spotilla.fi\",\n \"url\": \"https://api.spotilla.fi/api/v1/files/original/54e577ac-55d2-466d-97b4-24536c161064\",\n \"target_class\": \"Spot\",\n \"target_id\": \"bcc4a269-42db-4638-afbb-8f99bc8bf774\"\n}"}],"_postman_id":"03796760-267e-41d7-9e28-451a6b6b5c61"},{"name":"/v3/chunk_meta","id":"9c3922ad-7bce-4e89-a992-4e1123e30568","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"

sign in token

\n"},{"key":"X-User-Id","type":"text","value":"","description":"

users id which was used to sign in

\n"},{"key":"X-User-Subdomain","type":"text","value":"","description":"

the same subdomain as was used in sign in

\n"}],"body":{"mode":"raw","raw":"{\n \"target_type\": \"Spot\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"filename\": \"some_audio.mp3\",\n \"file_extension\": \".mp3\"\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/chunk_meta","description":"

General Info

\n

/chunk_meta is an endpoint for chunk upload tracking data.

\n

Request must be made before uploading chunks in a sequence.

\n

tracking_id in response must be included in all chunk uploads

\n

Body (json)

\n\n","urlObject":{"path":["api","v3","chunk_meta"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"5cd8b05a-2c68-4eef-9077-c21b6c1a7c84","name":"v3/chunk_meta","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":"","description":"sign in token"},{"key":"X-User-Id","type":"text","value":"","description":"users id which was used to sign in"},{"key":"X-User-Subdomain","type":"text","value":"","description":"the same subdomain as was used in sign in"}],"body":{"mode":"raw","raw":"{\n \"target_type\": \"Spot\",\n \"target_id\": \"bcc4a269-42db-4638-afbb-8f99bc8bf774\",\n \"filename\": \"some_audio.mp3\",\n \"file_extension\": \".mp3\"\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/chunk_meta"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\n \"target_type\": \"Spot\",\n \"filename\": \"some_audio.mp3\",\n \"file_extension\": \".mp3\",\n \"uploaded_by\": \"{{rand_name}}\",\n \"created_at\": \"2023-03-15T11:21:08.411+02:00\",\n \"updated_at\": \"2023-03-15T11:21:08.411+02:00\",\n \"file_file_name\": null,\n \"file_file_size\": null,\n \"file_content_type\": null,\n \"tracking_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\n}"}],"_postman_id":"9c3922ad-7bce-4e89-a992-4e1123e30568"}],"id":"45239a59-f262-4fb0-87d6-806140012916","description":"

Uploading files to resources.

\n","_postman_id":"45239a59-f262-4fb0-87d6-806140012916"},{"name":"Work Hours And Travel Costs","item":[{"name":"Log Entries","item":[{"name":"/v3/log_entries","id":"f25e015e-51fe-4f9a-8c32-de7947560efd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/log_entries?begin_date=31.08.2023&end_date=01.09.2023&date=01.09.2023&log_type=task&approved=true&status=processed","description":"

GET /api/v3/log_entries

\n

The GET request retrieves a list of log entries based on the provided parameters.

\n

Request Parameters (Optional)

\n\n","urlObject":{"path":["api","v3","log_entries"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params;

\n","type":"text/plain"},"key":"begin_date","value":"31.08.2023"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"end_date","value":"01.09.2023"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"date","value":"01.09.2023"},{"description":{"content":"

optional params; task or service_request

\n","type":"text/plain"},"key":"log_type","value":"task"},{"key":"approved","value":"true"},{"key":"status","value":"processed"}],"variable":[]}},"response":[{"id":"a24af181-8970-4261-a717-3c0b0b7bad41","name":"/v3/log_entries","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/log_entries?log_type=task","host":["api","dev","spotilla","fi"],"path":["api","v3","log_entries"],"query":[{"key":"log_type","value":"task"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 0,\r\n \"begin_time\": \"2021-02-03T18:05:30.000+02:00\",\r\n \"end_time\": \"2021-02-03T18:05:30.893+02:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Black Widow\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"03.02\",\r\n \"task\": null,\r\n \"service_request\": null,\r\n \"status\": \"completed\",\r\n \"approved\": false,\r\n \"log_entry_subtype_id\": null,\r\n \"subtype_unit_value\": null,\r\n \"log_entry_subtype\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 0,\r\n \"begin_time\": \"2021-07-02T13:52:47.000+03:00\",\r\n \"end_time\": \"2021-07-02T13:52:47.559+03:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Super Man\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"02.07\",\r\n \"task\": null,\r\n \"service_request\": null,\r\n \"status\": \"completed\",\r\n \"approved\": false,\r\n \"log_entry_subtype_id\": null,\r\n \"subtype_unit_value\": null,\r\n \"log_entry_subtype\": null\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 0,\r\n \"begin_time\": \"2021-01-29T14:53:42.000+02:00\",\r\n \"end_time\": \"2021-01-29T14:53:42.716+02:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Spider man\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"29.01\",\r\n \"task\": null,\r\n \"service_request\": null,\r\n \"status\": \"completed\",\r\n \"approved\": false,\r\n \"log_entry_subtype_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"subtype_unit_value\": \"1.0\",\r\n \"log_entry_subtype\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Sales Provision\",\r\n \"code\": \"PCS-001\",\r\n \"unit_type\": \"pcs\",\r\n \"main_log_types\": [\r\n \"general\",\r\n \"task\"\r\n ]\r\n }\r\n }\r\n]"}],"_postman_id":"f25e015e-51fe-4f9a-8c32-de7947560efd"},{"name":"/v3/log_entries/subtypes","id":"7da7e48c-83aa-4335-84dd-a53218b8513b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/log_entries/subtypes?main_log_types=task,general,service_request","description":"

The GET request returns the available log entry subtypes for the specified main log types or all. Use this endpoint to populate subtype options or validate which subtypes are supported for one or more main log categories.

\n

Request Parameters (Optional)

\n\n","urlObject":{"path":["api","v3","log_entries","subtypes"],"host":["api","spotilla","fi"],"query":[{"key":"main_log_types","value":"task,general,service_request"}],"variable":[]}},"response":[{"id":"8f10646f-7d09-4f4a-9e12-41ae62ca08f0","name":"/v3/log_entries/subtypes","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/log_entries/subtypes?main_log_types=task,general","host":["api","dev","spotilla","fi"],"path":["api","v3","log_entries","subtypes"],"query":[{"key":"main_log_types","value":"task,general","description":"You can filter subtypes by one more multiple main types"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Overtime 50%\",\r\n \"code\": \"TIME-001\",\r\n \"description\": \"\",\r\n \"unit_type\": \"time\",\r\n \"main_log_types\": [\r\n \"task\",\r\n \"service_request\",\r\n \"general\"\r\n ],\r\n \"status\": \"active\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Sales Provision\",\r\n \"code\": \"PCS-001\",\r\n \"description\": \"\",\r\n \"unit_type\": \"pcs\",\r\n \"main_log_types\": [\r\n \"task\",\r\n \"service_request\"\r\n ],\r\n \"status\": \"active\"\r\n }\r\n]"}],"_postman_id":"7da7e48c-83aa-4335-84dd-a53218b8513b"},{"name":"/v3/log_entries/latest_log_entries","id":"8e73eab6-e627-429e-809e-ad93f1378a60","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/log_entries/latest_log_entries?start_from=13.03.2023&end_to=14.03.2023&log_type=task&status=active","description":"

Returns the latest log entries that have begin and end time. Only current users logs are returned.

\n

Possible parameters:

\n

start_from: date_value (by default today)

\n

end_to: date_value (by default today)

\n

log_type: task or service_request (by default both are returned)

\n

status: active (only option)

\n

When status=active is in the parameters, response doesn't include completed tasks or service requests. Do not send the parameter if you want all items no matter what the status is.

\n","urlObject":{"path":["api","v3","log_entries","latest_log_entries"],"host":["api","spotilla","fi"],"query":[{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"start_from","value":"13.03.2023"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"end_to","value":"14.03.2023"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"log_type","value":"task"},{"description":{"content":"

optional params

\n","type":"text/plain"},"key":"status","value":"active"}],"variable":[]}},"response":[{"id":"54ae9367-47d8-4017-af4b-a2e3b0392464","name":"/v3/log_entries/latest_log_entries","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":{"raw":"api.dev.spotilla.fi/api/v3/log_entries/latest_log_entries?start_from=13.03.2023&end_to=14.03.2023&log_type=service_request","host":["api","dev","spotilla","fi"],"path":["api","v3","log_entries","latest_log_entries"],"query":[{"key":"start_from","value":"13.03.2023","description":"optional params"},{"key":"end_to","value":"14.03.2023","description":"optional params"},{"key":"log_type","value":"service_request","description":"optional params"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 2100,\r\n \"begin_time\": \"2023-03-13T14:43:45.953+02:00\",\r\n \"end_time\": \"2023-03-13T15:18:01.917+02:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"log_type\": \"service_request\",\r\n \"date\": \"13.03.\",\r\n \"task\": null,\r\n \"service_request\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"title\": \"Mäntä jumittaa\"\r\n }\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 10,\r\n \"begin_time\": \"2023-03-13T15:19:13.878+02:00\",\r\n \"end_time\": \"2023-03-13T15:29:20.160+02:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"log_type\": \"service_request\",\r\n \"date\": \"13.03.\",\r\n \"task\": null,\r\n \"service_request\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"title\": \"Vuotava hana\"\r\n }\r\n }\r\n]"}],"_postman_id":"8e73eab6-e627-429e-809e-ad93f1378a60"},{"name":"/v3/log_entries/mark_processed","id":"16ead994-313a-495e-9784-fd5727941b3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{ \"ids\": [\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"] } // pass the log entry's uuid in the array.Note: only approved log entries can be processed","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries/mark_processed","description":"

NOTE: Only available with Integration API Keys (Integraatioavaimet)

\n

The endpoint allows user to update approved log entries to be in processed status

\n

Request body:
Send a JSON object with an ids array containing one or more log entry UUIDs.

\n

Only approved log entries can be processed.

\n","urlObject":{"path":["api","v3","log_entries","mark_processed"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"a5b95041-364a-41cb-991c-e14aff1f876a","name":"/v3/log_entries/mark_processed","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"api.dev.spotilla.fi/api/v3/log_entries/mark_processed"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"{\r\n \"count\": 2,\r\n \"msg\": \"Batch mark processed is being performed in the background\"\r\n}"}],"_postman_id":"16ead994-313a-495e-9784-fd5727941b3f"},{"name":"/v3/log_entries","id":"c840e23e-33b0-4416-baa5-9075d03f6195","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"log_type\": \"task\", //other option: \"service_request_id\"\r\n \"begin_time\": \"2021-08-17 12:00:00\",\r\n \"end_time\": \"2021-08-17 12:59:00\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // pass this field, only when log type is \"task\". Don't pass the \"service_request_id\" at the same time\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass this field, only when log type is \"service_request\". Don't pass the \"task_id\" at the same time\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries","description":"

Create a log entry for a task or a service request.

\n

When creating Log Entry for Task, use:

\n

\"log_type\": \"task\",

\n

\"task_id\": \"task_uuid\"

\n

When creating Log Entry for Service Request, use:

\n

\"log_type\": \"service_request\",

\n

\"service_request_id\": \"service_request_uuid\"

\n","urlObject":{"path":["api","v3","log_entries"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"06b92573-0706-4065-92af-2abbbaa3e3c2","name":"/v3/log_entries","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"log_type\": \"task\",\r\n \"begin_time\": \"2021-08-17 12:00:00\",\r\n \"end_time\": \"2021-08-17 12:59:00\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 3540,\r\n \"begin_time\": \"2021-08-17T12:00:00.000+03:00\",\r\n \"end_time\": \"2021-08-17T12:59:00.000+03:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Iron Man\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"17.08\",\r\n \"task\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_heading\": \"Example Task\"\r\n }\r\n}"}],"_postman_id":"c840e23e-33b0-4416-baa5-9075d03f6195"},{"name":"v3/log_entries/start_log","id":"45f30710-d422-4211-aa5b-25a77e6c328e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass this field only when create for a task. Don't pass the \"service_request_id\" at the same time\r\n //OR \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\" // pass this field only when create for a service request. Don't pass the \"task_id\" at the same time\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries/start_log","description":"

This request will create Log entry without end time. Begin time (current timestamp) will be set automatically on create.

\n

When creating Log Entry for Task, use:

\n

\"task_id\": \"task_uuid\"

\n

When creating Log Entry for Service Request, use:

\n

\"service_request_id\": \"service_request_uuid\"

\n","urlObject":{"path":["api","v3","log_entries","start_log"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"5d91f059-9c34-49fd-a1da-08c36e699b11","name":"v3/log_entries/start_log","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries/start_log"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 0,\r\n \"begin_time\": \"2023-03-14T10:57:27.514+02:00\",\r\n \"end_time\": null,\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"14.03.\",\r\n \"task\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_heading\": \"Hihnojen tarkistus\"\r\n },\r\n \"service_request\": null\r\n}"}],"_postman_id":"45f30710-d422-4211-aa5b-25a77e6c328e"},{"name":"v3/log_entries/end_log","id":"b717daf2-1135-4551-80cd-aed5e3e77970","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"X-User-Token","type":"text","value":""},{"key":"X-User-Id","type":"text","value":""},{"key":"X-User-Subdomain","type":"text","value":""}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n // OR \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries/end_log","description":"

This request will end ongoing Log entry for selected item. End time will be set automatically (current timestamp) when saving found log.

\n

When ending Log Entry for Task, use:

\n

\"task_id\": \"task_uuid\"

\n

When ending Log Entry for Service Request, use:

\n

\"service_request_id\": \"service_request_uuid\"

\n","urlObject":{"path":["api","v3","log_entries","end_log"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"9c0b418e-cbe9-4918-b99f-ac61f4a69248","name":"/v3/log_entries/end_log","originalRequest":{"method":"PATCH","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"log_entry\": {\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/log_entries/end_log"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true,"disableEdit":true,"info":"Indicates the resource's media type."},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true,"disableEdit":true,"info":"Custom header"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"spent_hours\": 1200,\r\n \"begin_time\": \"2023-03-14T10:57:27.514+02:00\",\r\n \"end_time\": \"2023-03-14T11:18:19.901+02:00\",\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"log_type\": \"task\",\r\n \"date\": \"14.03.\",\r\n \"task\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_heading\": \"Hihnojen tarkistus\"\r\n },\r\n \"service_request\": null\r\n}"}],"_postman_id":"b717daf2-1135-4551-80cd-aed5e3e77970"}],"id":"38b295f2-5e29-47d1-b722-2a8353d6afaa","_postman_id":"38b295f2-5e29-47d1-b722-2a8353d6afaa","description":""},{"name":"Travel Allowances","item":[{"name":"/v3/travel_allowances","id":"b4dee250-64c9-4339-b79b-a06b598baf27","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/travel_allowances?only_personal=true","description":"

This endpoint retrieves a list of travel allowances.

\n

Possible parameters:

\n

only_personal=true (get only personal travel allowances)

\n

Without parameter you will get all accessible travel allowances.

\n

Response

\n

The response will include an array of travel allowance objects, each containing the following properties:

\n\n","urlObject":{"path":["api","v3","travel_allowances"],"host":["api","spotilla","fi"],"query":[{"key":"only_personal","value":"true"}],"variable":[]}},"response":[{"id":"984e599c-0a78-43b3-a75e-456a5e7ddd3e","name":"/v3/travel_allowances","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/travel_allowances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true},{"key":"X-User-Token","value":"","description":"","type":"text"},{"key":"X-User-Id","value":"","description":"","type":"text"},{"key":"X-User-Subdomain","value":"","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": \"2021-08-10T08:15:00.000+02:00\",\r\n \"end_date\": \"2021-08-10T16:15:00.000+02:00\",\r\n \"reason\": \"going to work\",\r\n \"route\": \"LTI-HKI highway\",\r\n \"amount\": \"51.7\",\r\n \"kilometers\": 110,\r\n \"additional_passengers\": 1,\r\n \"trailer\": false,\r\n \"heavy_transport\": false,\r\n \"created_at\": \"2021-08-11T09:34:32.449+03:00\",\r\n \"updated_at\": \"2021-08-11T09:34:32.449+03:00\",\r\n \"task\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_heading\": \"Suodattimen tarkistus\"\r\n },\r\n \"service_request\": null,\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"free_meals_amount\": 1,\r\n \"daily_allowance_amount\": \"20\",\r\n \"total_sum\": \"71.7\"\r\n },\r\n {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": \"2025-01-17T08:15:00.000+02:00\",\r\n \"end_date\": \"2025-01-17T16:15:00.000+02:00\",\r\n \"reason\": \"Going to office\",\r\n \"route\": \"LTI-HKI Highway\",\r\n \"amount\": \"47.96\",\r\n \"kilometers\": 109,\r\n \"additional_passengers\": 0,\r\n \"trailer\": false,\r\n \"heavy_transport\": false,\r\n \"personal_cost\": false,\r\n \"created_at\": \"2021-08-17T13:54:04.376+03:00\",\r\n \"updated_at\": \"2021-08-17T13:54:04.376+03:00\",\r\n \"task\": null,\r\n \"service_request\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"title\": \"Haljennut lukko\"\r\n },\r\n \"user_account\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"name\": \"Mikko Mallikas\"\r\n },\r\n \"free_meals_amount\": null,\r\n \"daily_allowance_amount\": null,\r\n \"total_sum\": \"47.96\"\r\n }\r\n]"}],"_postman_id":"b4dee250-64c9-4339-b79b-a06b598baf27"},{"name":"/v3/travel_allowances","id":"e8d679e7-a0d1-43e6-abcc-8bb36ae9731e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"travel_allowance\": {\r\n \"begin_date\": \"2021-08-17 13:00:00\", // required field\r\n \"end_date\": \"2021-08-17 14:00:00\", // required field\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\", // required field\r\n \"kilometers\": \"109\", // required field\r\n \"additional_passengers\": \"0\",\r\n \"trailer\": \"false\",\r\n \"heavy_transport\": \"false\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // Both task_id and service_request_id cannot be present\r\n \"service_request_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"personal_cost\": false,\r\n \"free_meals_amount\": \"1\" // to add daily allowance\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/travel_allowances","description":"

Create Travel Allowance

\n

This endpoint allows you to create a travel allowance by providing the necessary details in the request body.

\n

Request Body

\n

required fields:

\n\n

optional fields:

\n\n","urlObject":{"path":["api","v3","travel_allowances"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"f3e6207d-01db-4bfa-86e1-c85a209700b9","name":"With daily allowance","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"2xqL-ppyzJpSSJhwmxYs","type":"text"},{"key":"X-User-Id","value":"852e0ff8-51be-49c2-adc9-4bcc48e05036","type":"text"},{"key":"X-User-Subdomain","value":"kunnossapitodemo","type":"text"},{"key":"","value":"","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"travel_allowance\": {\r\n \"begin_date\": \"2021-08-17 13:00:00\", // required field\r\n \"end_date\": \"2021-08-17 14:00:00\", // required field\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\", // required field\r\n \"kilometers\": \"109\", // required field\r\n \"additional_passengers\": \"0\",\r\n \"trailer\": \"false\",\r\n \"heavy_transport\": \"false\",\r\n \"personal_cost\": true,\r\n \"free_meals_amount\": \"2\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/travel_allowances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": \"2021-08-17T13:00:00.000+02:00\",\r\n \"end_date\": \"2021-08-17T14:00:00.000+02:00\",\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\",\r\n \"amount\": \"47.96\",\r\n \"kilometers\": 109,\r\n \"additional_passengers\": 0,\r\n \"trailer\": false,\r\n \"heavy_transport\": false,\r\n \"personal_cost\": true,\r\n \"created_at\": \"2021-08-17T14:12:14.730+03:00\",\r\n \"updated_at\": \"2021-08-17T14:12:14.730+03:00\",\r\n \"task\": null,\r\n \"service_request\": null,\r\n \"free_meals_amount\": 1,\r\n \"daily_allowance_amount\": \"11.0\",\r\n \"total_sum\": \"58.96\"\r\n}"},{"id":"5422b050-3d2a-4807-8e8e-3c7bdd4da64c","name":"Without daily allowance","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"travel_allowance\": {\r\n \"begin_date\": \"2021-08-17 13:00:00\",\r\n \"end_date\": \"2021-08-17 14:00:00\",\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\",\r\n \"kilometers\": \"109\",\r\n \"additional_passengers\": \"0\",\r\n \"trailer\": \"false\",\r\n \"heavy_transport\": \"false\",\r\n \"personal_cost\": true\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/travel_allowances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": \"2021-08-17T13:00:00.000+02:00\",\r\n \"end_date\": \"2021-08-17T14:00:00.000+02:00\",\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\",\r\n \"amount\": \"47.96\",\r\n \"kilometers\": 109,\r\n \"additional_passengers\": 0,\r\n \"trailer\": false,\r\n \"heavy_transport\": false,\r\n \"personal_cost\": true,\r\n \"created_at\": \"2021-08-17T14:09:26.461+03:00\",\r\n \"updated_at\": \"2021-08-17T14:09:26.461+03:00\",\r\n \"task\": null,\r\n \"service_request\": null,\r\n \"free_meals_amount\": null,\r\n \"daily_allowance_amount\": null,\r\n \"total_sum\": \"47.96\"\r\n}"},{"id":"b9550dea-c067-4380-a81b-534905159d39","name":"Trip for task","originalRequest":{"method":"POST","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"travel_allowance\": {\r\n \"begin_date\": \"2021-08-17 13:00:00\",\r\n \"end_date\": \"2021-08-17 14:00:00\",\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\",\r\n \"kilometers\": \"109\",\r\n \"additional_passengers\": \"0\",\r\n \"trailer\": \"false\",\r\n \"heavy_transport\": \"false\",\r\n \"task_id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\", // task uuid\r\n \"personal_cost\": false\r\n // \"free_meals_amount\": \"2\" // add for daily allowance\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"api.spotilla.fi/api/v3/travel_allowances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8","description":"Indicates the resource's media type.","enabled":true},{"key":"X-Current-Page","value":"1","description":"Custom header","enabled":true},{"key":"X-Total-Pages","value":"5","description":"Custom header","enabled":true}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"begin_date\": \"2021-08-17T13:00:00.000+02:00\",\r\n \"end_date\": \"2021-08-17T14:00:00.000+02:00\",\r\n \"reason\": \"Seeing customer\",\r\n \"route\": \"LTI-HKI\",\r\n \"amount\": \"47.96\",\r\n \"kilometers\": 109,\r\n \"additional_passengers\": 0,\r\n \"trailer\": false,\r\n \"heavy_transport\": false,\r\n \"personal_cost\": false,\r\n \"created_at\": \"2021-08-18T18:13:41.728Z\",\r\n \"updated_at\": \"2021-08-18T18:13:41.728Z\",\r\n \"task\": {\r\n \"id\": \"ae68c14f-9512-490c-8d6a-a43e3ed290d2\",\r\n \"task_heading\": \"Safety Check\"\r\n },\r\n \"service_request\": null,\r\n \"free_meals_amount\": null,\r\n \"daily_allowance_amount\": null,\r\n \"total_sum\": \"47.96\"\r\n}"}],"_postman_id":"e8d679e7-a0d1-43e6-abcc-8bb36ae9731e"}],"id":"36252776-f38b-4575-b703-f85c491b1914","_postman_id":"36252776-f38b-4575-b703-f85c491b1914","description":""}],"id":"ee53f631-606e-48e8-8d27-fa3b33f0833a","_postman_id":"ee53f631-606e-48e8-8d27-fa3b33f0833a","description":""},{"name":"Country options","item":[{"name":"v3/country_options","id":"d8ce4249-5d17-4817-8470-a7f7d75b83be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/country_options","description":"

Get all country options, names are in with your current locale.

\n

Use the 'id' value when sending country values for Warehouses, Customers, Collections or CustomerContracts.

\n","urlObject":{"path":["api","v3","country_options"],"host":["api","spotilla","fi"],"query":[],"variable":[]}},"response":[{"id":"579ec08a-40bc-4e43-89d1-dab485b37944","name":"v3/country_options","originalRequest":{"method":"GET","header":[{"key":"X-User-Token","value":"","type":"text"},{"key":"X-User-Id","value":"","type":"text"},{"key":"X-User-Subdomain","value":"","type":"text"}],"url":"api.spotilla.fi/api/v3/country_options"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"AF\",\n \"value\": \"Afganistan\"\n },\n {\n \"id\": \"AL\",\n \"value\": \"Albania\"\n },\n {\n \"id\": \"DZ\",\n \"value\": \"Algeria\"\n },\n {\n \"id\": \"AS\",\n \"value\": \"Amerikan Samoa\"\n },\n {\n \"id\": \"AD\",\n \"value\": \"Andorra\"\n },\n {\n \"id\": \"AO\",\n \"value\": \"Angola\"\n },\n {\n \"id\": \"AI\",\n \"value\": \"Anguilla\"\n },\n {\n \"id\": \"AQ\",\n \"value\": \"Antarktis\"\n },\n {\n \"id\": \"AG\",\n \"value\": \"Antigua ja Barbuda\"\n },\n {\n \"id\": \"AR\",\n \"value\": \"Argentiina\"\n },\n {\n \"id\": \"AM\",\n \"value\": \"Armenia\"\n },\n {\n \"id\": \"AW\",\n \"value\": \"Aruba\"\n },\n {\n \"id\": \"AU\",\n \"value\": \"Australia\"\n },\n {\n \"id\": \"AT\",\n \"value\": \"Itävalta\"\n },\n {\n \"id\": \"AZ\",\n \"value\": \"Azerbaidžan\"\n },\n {\n \"id\": \"BS\",\n \"value\": \"Bahama\"\n },\n {\n \"id\": \"BH\",\n \"value\": \"Bahrain\"\n },\n {\n \"id\": \"BD\",\n \"value\": \"Bangladesh\"\n },\n {\n \"id\": \"BB\",\n \"value\": \"Barbados\"\n },\n {\n \"id\": \"BY\",\n \"value\": \"Valko-Venäjä\"\n },\n {\n \"id\": \"BE\",\n \"value\": \"Belgia\"\n },\n {\n \"id\": \"BZ\",\n \"value\": \"Belize\"\n },\n {\n \"id\": \"BJ\",\n \"value\": \"Benin\"\n },\n {\n \"id\": \"BM\",\n \"value\": \"Bermuda\"\n },\n {\n \"id\": \"BT\",\n \"value\": \"Bhutan\"\n },\n {\n \"id\": \"BO\",\n \"value\": \"Bolivia (monikansallinen valtio)\"\n },\n {\n \"id\": \"BQ\",\n \"value\": \"Bonaire, Sint Eustatius ja Saba\"\n },\n {\n \"id\": \"BA\",\n \"value\": \"Bosnia ja Hertsegovina\"\n },\n {\n \"id\": \"BW\",\n \"value\": \"Botswana\"\n },\n {\n \"id\": \"BV\",\n \"value\": \"Bouvetin saari\"\n },\n {\n \"id\": \"BR\",\n \"value\": \"Brasilia\"\n },\n {\n \"id\": \"IO\",\n \"value\": \"Brittiläinen Intian valtameren alue\"\n },\n {\n \"id\": \"BN\",\n \"value\": \"Brunei Darussalam\"\n },\n {\n \"id\": \"BG\",\n \"value\": \"Bulgaria\"\n },\n {\n \"id\": \"BF\",\n \"value\": \"Burkina Faso\"\n },\n {\n \"id\": \"BI\",\n \"value\": \"Burundi\"\n },\n {\n \"id\": \"CV\",\n \"value\": \"Cabo Verde\"\n },\n {\n \"id\": \"KH\",\n \"value\": \"Kambodža\"\n },\n {\n \"id\": \"CM\",\n \"value\": \"Kamerun\"\n },\n {\n \"id\": \"CA\",\n \"value\": \"Kanada\"\n },\n {\n \"id\": \"KY\",\n \"value\": \"Caymansaaret\"\n },\n {\n \"id\": \"CF\",\n \"value\": \"Keski-Afrikan tasavalta\"\n },\n {\n \"id\": \"TD\",\n \"value\": \"Tšad\"\n },\n {\n \"id\": \"CL\",\n \"value\": \"Chile\"\n },\n {\n \"id\": \"CN\",\n \"value\": \"Kiina\"\n },\n {\n \"id\": \"CX\",\n \"value\": \"Joulusaari\"\n },\n {\n \"id\": \"CC\",\n \"value\": \"Kookossaari\"\n },\n {\n \"id\": \"CO\",\n \"value\": \"Kolumbia\"\n },\n {\n \"id\": \"KM\",\n \"value\": \"Komorit\"\n },\n {\n \"id\": \"CD\",\n \"value\": \"Kongo\"\n },\n {\n \"id\": \"CG\",\n \"value\": \"Kongo\"\n },\n {\n \"id\": \"CK\",\n \"value\": \"Cookinsaaret\"\n },\n {\n \"id\": \"CR\",\n \"value\": \"Costa Rica\"\n },\n {\n \"id\": \"HR\",\n \"value\": \"Kroatia\"\n },\n {\n \"id\": \"CU\",\n \"value\": \"Kuuba\"\n },\n {\n \"id\": \"CW\",\n \"value\": \"Curaçao\"\n },\n {\n \"id\": \"CY\",\n \"value\": \"Kypros\"\n },\n {\n \"id\": \"CZ\",\n \"value\": \"Tšekki\"\n },\n {\n \"id\": \"CI\",\n \"value\": \"Norsunluurannikko\"\n },\n {\n \"id\": \"DK\",\n \"value\": \"Tanska\"\n },\n {\n \"id\": \"DJ\",\n \"value\": \"Djibouti\"\n },\n {\n \"id\": \"DM\",\n \"value\": \"Dominica\"\n },\n {\n \"id\": \"DO\",\n \"value\": \"Dominikaaninen tasavalta\"\n },\n {\n \"id\": \"EC\",\n \"value\": \"Ecuador\"\n },\n {\n \"id\": \"EG\",\n \"value\": \"Egypti\"\n },\n {\n \"id\": \"SV\",\n \"value\": \"El Salvador\"\n },\n {\n \"id\": \"GQ\",\n \"value\": \"Päiväntasaajan Guinea\"\n },\n {\n \"id\": \"ER\",\n \"value\": \"Eritrea\"\n },\n {\n \"id\": \"EE\",\n \"value\": \"Viro\"\n },\n {\n \"id\": \"SZ\",\n \"value\": \"Eswatini\"\n },\n {\n \"id\": \"ET\",\n \"value\": \"Etiopia\"\n },\n {\n \"id\": \"FK\",\n \"value\": \"Falklandinsaaret\"\n },\n {\n \"id\": \"FO\",\n \"value\": \"Färsaaret\"\n },\n {\n \"id\": \"FJ\",\n \"value\": \"Fidži\"\n },\n {\n \"id\": \"FI\",\n \"value\": \"Suomi\"\n },\n {\n \"id\": \"FR\",\n \"value\": \"Ranska\"\n },\n {\n \"id\": \"GF\",\n \"value\": \"Ranskan Guayana\"\n },\n {\n \"id\": \"PF\",\n \"value\": \"Ranskan Polynesia\"\n },\n {\n \"id\": \"TF\",\n \"value\": \"Ranskan eteläiset ja antarktiset alueet\"\n },\n {\n \"id\": \"GA\",\n \"value\": \"Gabon\"\n },\n {\n \"id\": \"GM\",\n \"value\": \"Gambia\"\n },\n {\n \"id\": \"GE\",\n \"value\": \"Georgia\"\n },\n {\n \"id\": \"DE\",\n \"value\": \"Saksa\"\n },\n {\n \"id\": \"GH\",\n \"value\": \"Ghana\"\n },\n {\n \"id\": \"GI\",\n \"value\": \"Gibraltar\"\n },\n {\n \"id\": \"GR\",\n \"value\": \"Kreikka\"\n },\n {\n \"id\": \"GL\",\n \"value\": \"Grönlanti\"\n },\n {\n \"id\": \"GD\",\n \"value\": \"Grenada\"\n },\n {\n \"id\": \"GP\",\n \"value\": \"Guadeloupe\"\n },\n {\n \"id\": \"GU\",\n \"value\": \"Guam\"\n },\n {\n \"id\": \"GT\",\n \"value\": \"Guatemala\"\n },\n {\n \"id\": \"GG\",\n \"value\": \"Guernsey\"\n },\n {\n \"id\": \"GN\",\n \"value\": \"Guinea\"\n },\n {\n \"id\": \"GW\",\n \"value\": \"Guinea-Bissau\"\n },\n {\n \"id\": \"GY\",\n \"value\": \"Guyana\"\n },\n {\n \"id\": \"HT\",\n \"value\": \"Haiti\"\n },\n {\n \"id\": \"HM\",\n \"value\": \"Heard ja McDonaldinsaaret\"\n },\n {\n \"id\": \"VA\",\n \"value\": \"Pyhä istuin\"\n },\n {\n \"id\": \"HN\",\n \"value\": \"Honduras\"\n },\n {\n \"id\": \"HK\",\n \"value\": \"Hong Kong\"\n },\n {\n \"id\": \"HU\",\n \"value\": \"Unkari\"\n },\n {\n \"id\": \"IS\",\n \"value\": \"Islanti\"\n },\n {\n \"id\": \"IN\",\n \"value\": \"Intia\"\n },\n {\n \"id\": \"ID\",\n \"value\": \"Indonesia\"\n },\n {\n \"id\": \"IR\",\n \"value\": \"Iran (islamilainen tasavalta)\"\n },\n {\n \"id\": \"IQ\",\n \"value\": \"Irak\"\n },\n {\n \"id\": \"IE\",\n \"value\": \"Irlanti\"\n },\n {\n \"id\": \"IM\",\n \"value\": \"Mansaari\"\n },\n {\n \"id\": \"IL\",\n \"value\": \"Israel\"\n },\n {\n \"id\": \"IT\",\n \"value\": \"Italia\"\n },\n {\n \"id\": \"JM\",\n \"value\": \"Jamaika\"\n },\n {\n \"id\": \"JP\",\n \"value\": \"Japani\"\n },\n {\n \"id\": \"JE\",\n \"value\": \"Jersey\"\n },\n {\n \"id\": \"JO\",\n \"value\": \"Jordania\"\n },\n {\n \"id\": \"KZ\",\n \"value\": \"Kazakstan\"\n },\n {\n \"id\": \"KE\",\n \"value\": \"Kenia\"\n },\n {\n \"id\": \"KI\",\n \"value\": \"Kiribati\"\n },\n {\n \"id\": \"KP\",\n \"value\": \"Korean demokraattinen kansantasavalta\"\n },\n {\n \"id\": \"KR\",\n \"value\": \"Korean tasavalta\"\n },\n {\n \"id\": \"KW\",\n \"value\": \"Kuwait\"\n },\n {\n \"id\": \"KG\",\n \"value\": \"Kirgisia\"\n },\n {\n \"id\": \"LA\",\n \"value\": \"Laosin demokraattinen kansantasavalta\"\n },\n {\n \"id\": \"LV\",\n \"value\": \"Latvia\"\n },\n {\n \"id\": \"LB\",\n \"value\": \"Libanon\"\n },\n {\n \"id\": \"LS\",\n \"value\": \"Lesotho\"\n },\n {\n \"id\": \"LR\",\n \"value\": \"Liberia\"\n },\n {\n \"id\": \"LY\",\n \"value\": \"Libya\"\n },\n {\n \"id\": \"LI\",\n \"value\": \"Liechtenstein\"\n },\n {\n \"id\": \"LT\",\n \"value\": \"Liettua\"\n },\n {\n \"id\": \"LU\",\n \"value\": \"Luxemburg\"\n },\n {\n \"id\": \"MO\",\n \"value\": \"Macao\"\n },\n {\n \"id\": \"MG\",\n \"value\": \"Madagaskar\"\n },\n {\n \"id\": \"MW\",\n \"value\": \"Malawi\"\n },\n {\n \"id\": \"MY\",\n \"value\": \"Malesia\"\n },\n {\n \"id\": \"MV\",\n \"value\": \"Malediivit\"\n },\n {\n \"id\": \"ML\",\n \"value\": \"Mali\"\n },\n {\n \"id\": \"MT\",\n \"value\": \"Malta\"\n },\n {\n \"id\": \"MH\",\n \"value\": \"Marshallinsaaret\"\n },\n {\n \"id\": \"MQ\",\n \"value\": \"Martinique\"\n },\n {\n \"id\": \"MR\",\n \"value\": \"Mauritania\"\n },\n {\n \"id\": \"MU\",\n \"value\": \"Mauritius\"\n },\n {\n \"id\": \"YT\",\n \"value\": \"Mayotte\"\n },\n {\n \"id\": \"MX\",\n \"value\": \"Meksiko\"\n },\n {\n \"id\": \"FM\",\n \"value\": \"Mikronesia\"\n },\n {\n \"id\": \"MD\",\n \"value\": \"Moldova\"\n },\n {\n \"id\": \"MC\",\n \"value\": \"Monaco\"\n },\n {\n \"id\": \"MN\",\n \"value\": \"Mongolia\"\n },\n {\n \"id\": \"ME\",\n \"value\": \"Montenegro\"\n },\n {\n \"id\": \"MS\",\n \"value\": \"Montserrat\"\n },\n {\n \"id\": \"MA\",\n \"value\": \"Marokko\"\n },\n {\n \"id\": \"MZ\",\n \"value\": \"Mosambik\"\n },\n {\n \"id\": \"MM\",\n \"value\": \"Myanmar\"\n },\n {\n \"id\": \"NA\",\n \"value\": \"Namibia\"\n },\n {\n \"id\": \"NR\",\n \"value\": \"Nauru\"\n },\n {\n \"id\": \"NP\",\n \"value\": \"Nepal\"\n },\n {\n \"id\": \"NL\",\n \"value\": \"Alankomaat\"\n },\n {\n \"id\": \"NC\",\n \"value\": \"Uusi-Kaledonia\"\n },\n {\n \"id\": \"NZ\",\n \"value\": \"Uusi Seelanti\"\n },\n {\n \"id\": \"NI\",\n \"value\": \"Nicaragua\"\n },\n {\n \"id\": \"NE\",\n \"value\": \"Niger\"\n },\n {\n \"id\": \"NG\",\n \"value\": \"Nigeria\"\n },\n {\n \"id\": \"NU\",\n \"value\": \"Niue\"\n },\n {\n \"id\": \"NF\",\n \"value\": \"Norfolkin saari\"\n },\n {\n \"id\": \"MP\",\n \"value\": \"Pohjois-Mariaanit\"\n },\n {\n \"id\": \"NO\",\n \"value\": \"Norja\"\n },\n {\n \"id\": \"OM\",\n \"value\": \"Oman\"\n },\n {\n \"id\": \"PK\",\n \"value\": \"Pakistan\"\n },\n {\n \"id\": \"PW\",\n \"value\": \"Palau\"\n },\n {\n \"id\": \"PS\",\n \"value\": \"Palestiina, osavaltio\"\n },\n {\n \"id\": \"PA\",\n \"value\": \"Panama\"\n },\n {\n \"id\": \"PG\",\n \"value\": \"Papua-Uusi-Guinea\"\n },\n {\n \"id\": \"PY\",\n \"value\": \"Paraguay\"\n },\n {\n \"id\": \"PE\",\n \"value\": \"Peru\"\n },\n {\n \"id\": \"PH\",\n \"value\": \"Filippiinit\"\n },\n {\n \"id\": \"PN\",\n \"value\": \"Pitcairnsaaret\"\n },\n {\n \"id\": \"PL\",\n \"value\": \"Puola\"\n },\n {\n \"id\": \"PT\",\n \"value\": \"Portugali\"\n },\n {\n \"id\": \"PR\",\n \"value\": \"Puerto Rico\"\n },\n {\n \"id\": \"QA\",\n \"value\": \"Qatar\"\n },\n {\n \"id\": \"MK\",\n \"value\": \"Pohjois-Makedonian tasavalta\"\n },\n {\n \"id\": \"RO\",\n \"value\": \"Romania\"\n },\n {\n \"id\": \"RU\",\n \"value\": \"Venäjän federaatio\"\n },\n {\n \"id\": \"RW\",\n \"value\": \"Ruanda\"\n },\n {\n \"id\": \"RE\",\n \"value\": \"Réunion\"\n },\n {\n \"id\": \"BL\",\n \"value\": \"Saint Barthélemy\"\n },\n {\n \"id\": \"SH\",\n \"value\": \"Pyhä Helena, ylösnousemus ja Tristan da Cunha\"\n },\n {\n \"id\": \"KN\",\n \"value\": \"Saint Kitts ja Nevis\"\n },\n {\n \"id\": \"LC\",\n \"value\": \"Saint Lucia\"\n },\n {\n \"id\": \"MF\",\n \"value\": \"Saint Martin (ranskalainen osa)\"\n },\n {\n \"id\": \"PM\",\n \"value\": \"Saint Pierre ja Miquelon\"\n },\n {\n \"id\": \"VC\",\n \"value\": \"Saint Vincent ja Grenadiinit\"\n },\n {\n \"id\": \"WS\",\n \"value\": \"Samoa\"\n },\n {\n \"id\": \"SM\",\n \"value\": \"San Marino\"\n },\n {\n \"id\": \"ST\",\n \"value\": \"Sao Tome ja Principe\"\n },\n {\n \"id\": \"SA\",\n \"value\": \"Saudi-Arabia\"\n },\n {\n \"id\": \"SN\",\n \"value\": \"Senegal\"\n },\n {\n \"id\": \"RS\",\n \"value\": \"Serbia\"\n },\n {\n \"id\": \"SC\",\n \"value\": \"Seychellit\"\n },\n {\n \"id\": \"SL\",\n \"value\": \"Sierra Leone\"\n },\n {\n \"id\": \"SG\",\n \"value\": \"Singapore\"\n },\n {\n \"id\": \"SX\",\n \"value\": \"Sint Maarten (Alankomaat)\"\n },\n {\n \"id\": \"SK\",\n \"value\": \"Slovakia\"\n },\n {\n \"id\": \"SI\",\n \"value\": \"Slovenia\"\n },\n {\n \"id\": \"SB\",\n \"value\": \"Solomonsaaret\"\n },\n {\n \"id\": \"SO\",\n \"value\": \"Somalia\"\n },\n {\n \"id\": \"ZA\",\n \"value\": \"Etelä-Afrikka\"\n },\n {\n \"id\": \"GS\",\n \"value\": \"Etelä-Georgia ja Eteläiset Sandwichsaaret\"\n },\n {\n \"id\": \"SS\",\n \"value\": \"Eteläsudan\"\n },\n {\n \"id\": \"ES\",\n \"value\": \"Espanja\"\n },\n {\n \"id\": \"LK\",\n \"value\": \"Sri Lanka\"\n },\n {\n \"id\": \"SD\",\n \"value\": \"Sudan\"\n },\n {\n \"id\": \"SR\",\n \"value\": \"Suriname\"\n },\n {\n \"id\": \"SJ\",\n \"value\": \"Huippuvuoret ja Jan Mayen\"\n },\n {\n \"id\": \"SE\",\n \"value\": \"Ruotsi\"\n },\n {\n \"id\": \"CH\",\n \"value\": \"Sveitsi\"\n },\n {\n \"id\": \"SY\",\n \"value\": \"Syyria\"\n },\n {\n \"id\": \"TW\",\n \"value\": \"Taiwan\"\n },\n {\n \"id\": \"TJ\",\n \"value\": \"Tadžikistan\"\n },\n {\n \"id\": \"TZ\",\n \"value\": \"Tansanian yhdistynyt tasavalta\"\n },\n {\n \"id\": \"TH\",\n \"value\": \"Thaimaa\"\n },\n {\n \"id\": \"TL\",\n \"value\": \"Itä-Timor\"\n },\n {\n \"id\": \"TG\",\n \"value\": \"Togo\"\n },\n {\n \"id\": \"TK\",\n \"value\": \"Tokelau\"\n },\n {\n \"id\": \"TO\",\n \"value\": \"Tonga\"\n },\n {\n \"id\": \"TT\",\n \"value\": \"Trinidad ja Tobago\"\n },\n {\n \"id\": \"TN\",\n \"value\": \"Tunisia\"\n },\n {\n \"id\": \"TR\",\n \"value\": \"Turkki\"\n },\n {\n \"id\": \"TM\",\n \"value\": \"Turkmenistan\"\n },\n {\n \"id\": \"TC\",\n \"value\": \"Turks- ja Caicossaaret\"\n },\n {\n \"id\": \"TV\",\n \"value\": \"Tuvalu\"\n },\n {\n \"id\": \"UG\",\n \"value\": \"Uganda\"\n },\n {\n \"id\": \"UA\",\n \"value\": \"Ukraina\"\n },\n {\n \"id\": \"AE\",\n \"value\": \"Yhdistyneet arabiemiirikunnat\"\n },\n {\n \"id\": \"GB\",\n \"value\": \"Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta\"\n },\n {\n \"id\": \"UM\",\n \"value\": \"Yhdysvaltain pienet erillissaaret\"\n },\n {\n \"id\": \"US\",\n \"value\": \"Amerikan yhdysvallat\"\n },\n {\n \"id\": \"UY\",\n \"value\": \"Uruguay\"\n },\n {\n \"id\": \"UZ\",\n \"value\": \"Uzbekistan\"\n },\n {\n \"id\": \"VU\",\n \"value\": \"Vanuatu\"\n },\n {\n \"id\": \"VE\",\n \"value\": \"Venezuela (Bolivarian tasavalta)\"\n },\n {\n \"id\": \"VN\",\n \"value\": \"Vietnam\"\n },\n {\n \"id\": \"VG\",\n \"value\": \"Neitsytsaaret (Ison-Britannia)\"\n },\n {\n \"id\": \"VI\",\n \"value\": \"Neitsytsaaret (Yhdysvallat)\"\n },\n {\n \"id\": \"WF\",\n \"value\": \"Wallis ja Futuna\"\n },\n {\n \"id\": \"EH\",\n \"value\": \"Länsi-Sahara\"\n },\n {\n \"id\": \"YE\",\n \"value\": \"Jemen\"\n },\n {\n \"id\": \"ZM\",\n \"value\": \"Sambia\"\n },\n {\n \"id\": \"ZW\",\n \"value\": \"Zimbabwe\"\n },\n {\n \"id\": \"AX\",\n \"value\": \"Ahvenanmaa\"\n }\n]"}],"_postman_id":"d8ce4249-5d17-4817-8470-a7f7d75b83be"}],"id":"fac22ef4-5ae5-498e-bbfc-9c8afce764d7","_postman_id":"fac22ef4-5ae5-498e-bbfc-9c8afce764d7","description":""}],"event":[{"listen":"prerequest","script":{"id":"177bfc28-3165-458d-bee4-6255ef65530e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"687be987-4dd0-46b0-93c5-c94ba89f0ae1","type":"text/javascript","exec":[""]}}],"variable":[{"key":"user_token","value":""},{"key":"user_id","value":""},{"key":"current_tenant","value":""},{"key":"rand_uuid","value":"ae68c14f-9512-490c-8d6a-a43e3ed290d2","type":"string"},{"key":"{{rand_url}}","value":"http://random_domain/files/thumb/28ba65e0-9fcd-49a2-a949-f9faf0ecceb2"}]}