{ "item": [ { "name": "Authentication", "description": "OAuth2 authorization-code flow with PKCE. Endpoints live under `/strax/agent`.", "item": [ { "id": "9b1d860c-9844-4d33-a653-299920008adf", "name": "Consent screen (start the OAuth flow)", "request": { "name": "Consent screen (start the OAuth flow)", "description": { "content": "Send the user's browser here. They sign in to Konto, review the requested\nscopes, and are redirected back to `redirect_uri` with a short-lived\nauthorization `code` (10-minute TTL) and your `state`.\n\n**PKCE:** if you send a `code_challenge`, only `S256` is accepted. Public\nclients (no `client_secret`) **must** send one. `redirect_uri` must match\nthe value registered for the client **exactly**.\n", "type": "text/plain" }, "url": { "path": [ "strax", "agent", "authorize" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "client_id", "value": "" }, { "disabled": false, "description": { "content": "(Required) Comma-separated scopes (e.g. `nav,create_invoice,cost`).", "type": "text/plain" }, "key": "scope", "value": "" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "redirect_uri", "value": "" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "code_challenge", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of S256)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" } ], "variable": [] }, "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "3e7f3083-b1a3-4960-b630-04b739bb92ea", "name": "Redirect to `redirect_uri?code=…&state=…` on consent.", "originalRequest": { "url": { "path": [ "strax", "agent", "authorize" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "client_id", "value": "" }, { "disabled": false, "description": { "content": "(Required) Comma-separated scopes (e.g. `nav,create_invoice,cost`).", "type": "text/plain" }, "key": "scope", "value": "" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "redirect_uri", "value": "" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "key": "state", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "code_challenge", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of S256)", "type": "text/plain" }, "key": "code_challenge_method", "value": "S256" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Found", "code": 302, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "22b6ebb3-e616-4316-950e-39d80daf79ec", "name": "Exchange a code or refresh token for tokens", "request": { "name": "Exchange a code or refresh token for tokens", "description": { "content": "Exchange an authorization `code` (with `grant_type=authorization_code`) or\na `refresh_token` (with `grant_type=refresh_token`) for an access token.\n**Refresh tokens rotate** — persist the new `refresh_token` from every\nresponse. Refresh does not require `redirect_uri`.\n", "type": "text/plain" }, "url": { "path": [ "strax", "agent", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"client_id\": \"\",\n \"grant_type\": \"refresh_token\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"redirect_uri\": \"\",\n \"code_verifier\": \"\",\n \"refresh_token\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "02d11a25-3f8b-4566-aa87-9c7f0e18dd21", "name": "Token set.", "originalRequest": { "url": { "path": [ "strax", "agent", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"client_id\": \"\",\n \"grant_type\": \"refresh_token\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"redirect_uri\": \"\",\n \"code_verifier\": \"\",\n \"refresh_token\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"access_token\": \"\",\n \"refresh_token\": \"\",\n \"expires_in\": \"\",\n \"scope\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eb1ce350-2c43-4a76-9176-4fb52abdc39d", "name": "`invalid_grant` (expired/used code or dead refresh chain) or bad request.", "originalRequest": { "url": { "path": [ "strax", "agent", "token" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"client_id\": \"\",\n \"grant_type\": \"refresh_token\",\n \"client_secret\": \"\",\n \"code\": \"\",\n \"redirect_uri\": \"\",\n \"code_verifier\": \"\",\n \"refresh_token\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6681a221-9d93-4cbb-b358-836c7be02207", "name": "Register an agent client", "request": { "name": "Register an agent client", "description": { "content": "Create an agent client and receive a `client_id` + `client_secret`\n(**the secret is shown once**). In practice Konto often provisions\nclients — especially shared **app clients** (one client many merchants\nauthorize) — manually; contact Konto for onboarding.\n", "type": "text/plain" }, "url": { "path": [ "strax", "agent", "register" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"redirect_uri\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "65747160-0809-4914-b501-ed86e0d71a52", "name": "Created client (secret shown once).", "originalRequest": { "url": { "path": [ "strax", "agent", "register" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"redirect_uri\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"client_id\": \"\",\n \"client_secret\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Account & agents", "description": "Identity, and managing which agent clients have access.", "item": [ { "id": "711ad887-8725-4e5c-af56-7326e293ce72", "name": "Account identity / health check", "request": { "name": "Account identity / health check", "description": { "content": "Returns the connected company name, registration number (kennitala) and username. The MCP also derives the environment from the host.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "9aa01b50-22bc-4c40-ab2b-a6b840d46e87", "name": "Account identity.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"company_name\": \"\",\n \"registration_no\": \"\",\n \"username\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "372d3c2d-d547-44d5-8c40-244eb64b259b", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "status" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2c966b40-cd8d-4887-9690-cae9c64cf8b7", "name": "List authorized agent clients", "request": { "name": "List authorized agent clients", "description": { "content": "The agent clients currently authorized on this account, with granted scopes and timestamps.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5f4a895f-da21-424b-85eb-aa340977aad7", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c05dc415-c77c-40ce-bd04-f6fd5d08f4a9", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agents" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "705b1fd9-4b69-49d3-9572-5453f61b21a1", "name": "Revoke an agent client", "request": { "name": "Revoke an agent client", "description": { "content": "Immediately invalidates that client's tokens. **Irreversible.** Revoking the client you are currently using cuts off your own access.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agents", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) The agent client_id to revoke.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": null }, "response": [ { "id": "1ee02d96-7e46-4652-b5a4-c6b872f1803e", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agents", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The agent client_id to revoke.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "94052948-b477-4ee2-9ee9-ddd3f3c6e330", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agents", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The agent client_id to revoke.", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1bd66661-37a7-463e-87bb-17ee7f308f7e", "name": "Agent audit log", "request": { "name": "Agent audit log", "description": { "content": "Recent actions taken by agent clients on this account. See the in-app reference for the record shape.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "255551e4-685d-473d-b070-a22f523eda86", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be6e83f2-e059-4560-83f7-b1a0dc7acfb9", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Customers", "description": "Scope: `manage_customers`.", "item": [ { "id": "6102b4d8-964f-44e0-a27b-3b7fd365f611", "name": "List / search customers", "request": { "name": "List / search customers", "description": { "content": "Search matches name, kennitala or email. Note: results include deactivated profiles — filter client-side if needed. To look up by kennitala exactly, use `?kennitala=`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Exact kennitala lookup.", "type": "text/plain" }, "key": "kennitala", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "edd47379-2537-49ce-8a61-12f0465c3d71", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Exact kennitala lookup.", "type": "text/plain" }, "key": "kennitala", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60e439fd-0115-441f-8211-d39afe68c1fe", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Exact kennitala lookup.", "type": "text/plain" }, "key": "kennitala", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56b201c5-d093-4109-97bd-4236ff327178", "name": "The agent token does not include the required scope, or the plan lacks the feature.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "Exact kennitala lookup.", "type": "text/plain" }, "key": "kennitala", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9234b848-c7e8-4525-9169-9e5031863159", "name": "Create a customer", "request": { "name": "Create a customer", "description": { "content": "**Does not dedupe** by kennitala — each call creates a new profile. To change an existing one, GET it then PUT. Returns the created customer incl. its `guid`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "5f4dc5a5-af43-4650-8646-7f87d2ff04ff", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9623b177-8371-45c1-9c55-ad97014fd8d9", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "412dcae2-91c4-4d44-aeba-1bd2690c1d46", "name": "The agent token does not include the required scope, or the plan lacks the feature.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3f8fdad9-6c39-4d5a-a099-f0061be75eb1", "name": "Count customers", "request": { "name": "Count customers", "description": {}, "url": { "path": [ "api", "v1", "agent", "customers", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "9c01c237-0a48-42cc-aac0-938d2fde4f90", "name": "A count result.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"count\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c3f077ab-172d-4680-bc1b-a5a0668bbb44", "name": "Get a customer", "request": { "name": "Get a customer", "description": {}, "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "bfb478f8-638b-48e3-8642-4ddf964a12f6", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15107bde-9276-48e6-bef0-744d7fa60619", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0c788d75-a8d8-4863-94c4-c2c4ac62dff7", "name": "Update a customer", "request": { "name": "Update a customer", "description": { "content": "Send the fields you want to change. GET first if you need to preserve existing values. PUT bodies must be `application/json`.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "8acd5612-fee8-40ac-a6ca-067caaa190f5", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e43f67c7-9d83-4eec-b57c-24abd635fb0f", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "customers", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Items", "description": "Product/service catalogue. Scope: `nav`.", "item": [ { "id": "001aaefc-3969-4858-86e5-8ed365288f02", "name": "List items", "request": { "name": "List items", "description": {}, "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "7c187289-a27a-48d4-87f7-ae4583d5a5da", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32258185-869c-4378-8aba-ea8586113288", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a6b4d27f-1b3d-48d7-bf36-fd3c4d107ab4", "name": "Create an item", "request": { "name": "Create an item", "description": { "content": "Catalogue product/service. **`tax` defaults to `Z` (0 %) if omitted** — set `S` or `AA` for taxable items.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "0181de26-3daf-46b4-a554-87e6b5b30113", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84a05119-a234-4829-b43d-f9457e167684", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e9c5a9e9-e562-4491-bee7-92cdf3d13469", "name": "Count items", "request": { "name": "Count items", "description": {}, "url": { "path": [ "api", "v1", "agent", "items", "count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "6295567f-34e8-4ab8-a691-80d72293f168", "name": "A count result.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items", "count" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"count\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3ac03095-a4e7-436a-a511-23d06bfb3ad6", "name": "Get an item", "request": { "name": "Get an item", "description": {}, "url": { "path": [ "api", "v1", "agent", "items", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "8a4bae79-6b8d-48e7-b176-8715b8659460", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1af01e3a-6669-41b1-b5d3-0977c8c4837b", "name": "Update an item", "request": { "name": "Update an item", "description": {}, "url": { "path": [ "api", "v1", "agent", "items", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "e10cebb9-efe1-40c4-b8d2-1f086b0b8c32", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "items", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Invoices", "description": "Scopes: `nav` (read/update), `create_invoice` (create), `recurring`.", "item": [ { "id": "1aef22b1-b104-41e0-816a-70d1457cca6d", "name": "List invoices", "request": { "name": "List invoices", "description": {}, "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": " (This can only be one of Created,Posted,Skipped,Error)", "type": "text/plain" }, "key": "accounting_status", "value": "Posted" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "5bbb79dd-e911-4df9-9e03-0ccaf5687c5e", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": " (This can only be one of Created,Posted,Skipped,Error)", "type": "text/plain" }, "key": "accounting_status", "value": "Posted" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3513dbc0-e152-43a8-b90d-65c70420243e", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": " (This can only be one of Created,Posted,Skipped,Error)", "type": "text/plain" }, "key": "accounting_status", "value": "Posted" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9f2dbdba-f581-4a4e-a097-a77842ef2e5b", "name": "Create an invoice (or credit note)", "request": { "name": "Create an invoice (or credit note)", "description": { "content": "Creates and **issues** an invoice — Konto delivers it to the customer per\ntheir delivery setting. `amount` must equal Σ(line items) + VAT.\nFor a credit note, send `type: credit` + `ref_invoice_guid` (the original\nis marked credited and its customer is inherited).\n", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "ca1ccbf8-36ea-43a3-b5a9-211e17444b19", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba38fdb1-e9ca-4fcf-91d8-bf20abb09c2e", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef18abd7-62c2-4258-a12a-68330e586a00", "name": "The agent token does not include the required scope, or the plan lacks the feature.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fd28cdea-1b7d-4f88-819d-faf387378365", "name": "Get an invoice", "request": { "name": "Get an invoice", "description": {}, "url": { "path": [ "api", "v1", "agent", "invoices", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "e149d17c-c27d-461b-80a3-9f7363f176ef", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6193349c-beb0-4a13-959b-f451568a9aeb", "name": "Update invoice accounting status", "request": { "name": "Update invoice accounting status", "description": { "content": "Updates **only** the bookkeeping accounting status (and an optional message). It cannot edit amounts, dates, line items or the customer.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "invoices", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "e18b9d4e-b594-4adc-b757-515bf882f629", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "invoices", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aca9371c-4695-43f5-a866-abbf5ad9c8f3", "name": "Create a recurring invoice", "request": { "name": "Create a recurring invoice", "description": { "content": "A template that auto-generates invoices on a schedule. Same `amount`/line-item and date rules as a normal invoice.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "recurring-invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "de913bc0-1d66-47e7-89dc-00cc4a4b425c", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "recurring-invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3bd703bb-c7de-4b77-b2bf-6c898a9941ee", "name": "The agent token does not include the required scope, or the plan lacks the feature.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "recurring-invoices" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Costs", "description": "Expenses / receipts. Scope: `cost`.", "item": [ { "id": "df1a9c95-8b08-4802-91f5-fe0acb91d43e", "name": "List costs", "request": { "name": "List costs", "description": { "content": "Records return oldest-first — pass `from_date` for \"recent\" queries. Heavy `file`/`xml` fields are omitted from lists; fetch a single cost for them.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Comma-separated statuses.", "type": "text/plain" }, "key": "accounting_status", "value": "" }, { "disabled": false, "description": { "content": "cost_code filter (numeric). `Items` = 2353.", "type": "text/plain" }, "key": "type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "supplier_id", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of created_date,date)", "type": "text/plain" }, "key": "date_filter", "value": "date" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "f87a24c4-42d2-4e50-bc6e-5c2018de0dba", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Comma-separated statuses.", "type": "text/plain" }, "key": "accounting_status", "value": "" }, { "disabled": false, "description": { "content": "cost_code filter (numeric). `Items` = 2353.", "type": "text/plain" }, "key": "type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "supplier_id", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of created_date,date)", "type": "text/plain" }, "key": "date_filter", "value": "date" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b6a237b2-e125-4aa3-b5f1-746c93b1ea2c", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "Comma-separated statuses.", "type": "text/plain" }, "key": "accounting_status", "value": "" }, { "disabled": false, "description": { "content": "cost_code filter (numeric). `Items` = 2353.", "type": "text/plain" }, "key": "type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "supplier_id", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of created_date,date)", "type": "text/plain" }, "key": "date_filter", "value": "date" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9d69f1f5-9a91-4ae0-bfab-713d7d4e50dc", "name": "Create a cost from a receipt file (OCR)", "request": { "name": "Create a cost from a receipt file (OCR)", "description": { "content": "Upload a receipt/invoice image or PDF (**multipart/form-data**, max 5 MB)\nfor Konto's AI to extract amount, supplier, VAT and cost code. When Cost\nAI is enabled the record is queued (`result.queue = true`) — re-fetch the\ncost to read extracted fields. If you already have the numbers, use\n`/costs/advanced` instead.\n", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) ", "type": "text/plain" }, "key": "date", "value": "", "type": "text" }, { "description": { "content": "(Required) jpg, jpeg, png, gif or pdf; ≤ 5 MB.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "description", "value": "", "type": "text" } ] }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "72cbea83-bf67-43c6-9d83-6e5781e1ee8f", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) ", "type": "text/plain" }, "key": "date", "value": "", "type": "text" }, { "description": { "content": "(Required) jpg, jpeg, png, gif or pdf; ≤ 5 MB.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "description", "value": "", "type": "text" } ] } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bffc1840-e689-4e35-8c5e-cf2613fca239", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "formdata", "formdata": [ { "description": { "content": "(Required) ", "type": "text/plain" }, "key": "date", "value": "", "type": "text" }, { "description": { "content": "(Required) jpg, jpeg, png, gif or pdf; ≤ 5 MB.", "type": "text/plain" }, "key": "file", "type": "file" }, { "description": { "content": "", "type": "text/plain" }, "key": "description", "value": "", "type": "text" } ] } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "82f27fb7-a957-4815-9d33-d0f3c9dc5e6f", "name": "Create a cost from structured fields", "request": { "name": "Create a cost from structured fields", "description": { "content": "Record a cost from numbers you already have. File attachment optional. For a credit note set `credit_note: 1` and keep `amount` positive.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs", "advanced" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"amount\": \"\",\n \"how_paid\": 2,\n \"supplier_name\": \"\",\n \"supplier_id\": \"\",\n \"type\": \"\",\n \"description\": \"\",\n \"vat_11\": \"\",\n \"vat_24\": \"\",\n \"credit_note\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "6209ae1b-2b45-478e-bf38-7fdda501a550", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", "advanced" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"amount\": \"\",\n \"how_paid\": 2,\n \"supplier_name\": \"\",\n \"supplier_id\": \"\",\n \"type\": \"\",\n \"description\": \"\",\n \"vat_11\": \"\",\n \"vat_24\": \"\",\n \"credit_note\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95e2b2d3-4e53-41a8-9530-b1d759721478", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", "advanced" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"date\": \"\",\n \"amount\": \"\",\n \"how_paid\": 2,\n \"supplier_name\": \"\",\n \"supplier_id\": \"\",\n \"type\": \"\",\n \"description\": \"\",\n \"vat_11\": \"\",\n \"vat_24\": \"\",\n \"credit_note\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e406bde7-2d48-436f-b1f8-37dff773139a", "name": "Count costs", "request": { "name": "Count costs", "description": {}, "url": { "path": [ "api", "v1", "agent", "costs", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "accounting_status", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "supplier_id", "value": "" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "363d9eaf-99d8-4a85-95c4-329675a4ba1b", "name": "A count result.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "accounting_status", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "type", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "supplier_id", "value": "" }, { "disabled": false, "description": { "content": "Start date (YYYY-MM-DD).", "type": "text/plain" }, "key": "from_date", "value": "" }, { "disabled": false, "description": { "content": "End date (YYYY-MM-DD).", "type": "text/plain" }, "key": "to_date", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"count\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d40f420e-e4ed-40a6-b784-e51a6568cfb5", "name": "Get a cost (with file & xml)", "request": { "name": "Get a cost (with file & xml)", "description": {}, "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "02d6332e-5062-4d9a-9965-dd41e90399bc", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5396dfed-d1a3-4fa3-a945-bed59abaa85f", "name": "Update cost accounting status", "request": { "name": "Update cost accounting status", "description": { "content": "Updates only the accounting status (`Created`/`Posted`/`Skipped`/`Error`) + optional message. `Posted` is terminal. To edit a Created cost's data, move it to New first, then re-approve.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "1849a6a2-ba42-4952-b8c6-114d040a6f76", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4d7583ff-3ee8-4f54-b814-da9f1f00ebbd", "name": "Delete a cost", "request": { "name": "Delete a cost", "description": { "content": "Permanent and irreversible. Prefer status `Skipped` to exclude from bookkeeping. Posted costs cannot be deleted.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "912b166c-1d79-4691-a8bb-3c4b9e086170", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c794b594-ecdc-4c37-bd39-0d998a0741f1", "name": "Re-open a cost (move back to New)", "request": { "name": "Re-open a cost (move back to New)", "description": { "content": "Moves an approved (Created), non-Posted cost back to `New` so it can be edited; re-approving regenerates its bookkeeping XML.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "costs", ":guid", "move-to-new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "61786b99-ef1b-4126-9bc4-d574c1717c0a", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "costs", ":guid", "move-to-new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Tasks", "description": "Tasks & time tracking. Scope: `task`.", "item": [ { "id": "37f44a41-6db1-4eba-95ba-3d28419e401e", "name": "List tasks", "request": { "name": "List tasks", "description": {}, "url": { "path": [ "api", "v1", "agent", "tasks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of open,invoice,older)", "type": "text/plain" }, "key": "type", "value": "open" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "dd61a522-4397-4038-93e6-bf4c4f67e3b3", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of open,invoice,older)", "type": "text/plain" }, "key": "type", "value": "open" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da92922f-0791-42d7-9250-4db150fc604a", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of open,invoice,older)", "type": "text/plain" }, "key": "type", "value": "open" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bdeb9102-0118-4eb6-abbd-dc1c1018101d", "name": "Create a task", "request": { "name": "Create a task", "description": { "content": "A task linked to a customer, with an associated (existing or inline) item.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "tasks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "aed9dd36-0aff-4c22-a9f5-f6ec4ac47a9b", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"data\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "58552e08-3bfd-4c9b-b472-7993acd25913", "name": "Count tasks", "request": { "name": "Count tasks", "description": {}, "url": { "path": [ "api", "v1", "agent", "tasks", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of open,invoice,older)", "type": "text/plain" }, "key": "type", "value": "open" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "856d949d-7aa7-4c72-a59d-d28fbdfe54d7", "name": "A count result.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of open,invoice,older)", "type": "text/plain" }, "key": "type", "value": "open" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"count\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cf865686-c6b4-462e-bb1d-29c2591b7991", "name": "Get a task (with time-log entries)", "request": { "name": "Get a task (with time-log entries)", "description": { "content": "Each log entry carries the task-LOG guid needed by the log edit/delete endpoints.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "tasks", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "1dc7f720-d044-4d5f-87b4-68ebe61e496b", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "0ccbeefa-8c3a-43be-9785-0e9a2cc3cb08", "name": "Start a task timer", "request": { "name": "Start a task timer", "description": {}, "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "35001907-48fc-4307-a8c7-7012de58a5b0", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "start" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ae6225b4-2386-4d00-8eeb-ba0764e0c45e", "name": "Stop the timer / log time", "request": { "name": "Stop the timer / log time", "description": { "content": "Stops the running timer. Send `adv: 1` with `date`/`h`/`p` to record a specific dated time entry instead.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "end" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"adv\": \"\",\n \"date\": \"\",\n \"end_date\": \"\",\n \"h\": \"\",\n \"p\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "ed261985-93d0-48ec-8336-d860b136c283", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "end" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"adv\": \"\",\n \"date\": \"\",\n \"end_date\": \"\",\n \"h\": \"\",\n \"p\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "292a1eb0-e1da-4b2a-9221-aafd338f8d30", "name": "Archive a task", "request": { "name": "Archive a task", "description": {}, "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "7c9a5a37-c788-4140-b34b-dd764f26a554", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", ":guid", "deactivate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f3afaa7b-f006-4243-9bba-4d58172838ac", "name": "Edit a task-log entry", "request": { "name": "Edit a task-log entry", "description": { "content": "Takes the task-LOG entry's guid (from a task's log list), not the task's guid.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "tasks", "log" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"guid\": \"\",\n \"description\": \"\",\n \"date\": \"\",\n \"end_date\": \"\",\n \"h\": \"\",\n \"p\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "2163b0a9-0f52-4651-8228-50f22135bf09", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", "log" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"guid\": \"\",\n \"description\": \"\",\n \"date\": \"\",\n \"end_date\": \"\",\n \"h\": \"\",\n \"p\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5c263f7b-18fa-4a8d-902a-556c0e976f73", "name": "Delete a task-log entry", "request": { "name": "Delete a task-log entry", "description": { "content": "Irreversible. Takes the task-LOG entry's guid, not the task's guid.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "tasks", "log", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) Task-LOG entry guid.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "b531b6e2-944c-4a2c-9703-704a40a73aad", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "tasks", "log", ":guid" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Task-LOG entry guid.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Product sales", "description": "Read-only sell pages. Scope: `sell_product`.", "item": [ { "id": "4638ab29-0219-4ded-a68b-d420dc4ebac7", "name": "List product sales (sell pages)", "request": { "name": "List product sales (sell pages)", "description": { "content": "Read-only. Each result has a sale type: `STAND`, `SUB`, `DONA`, `EVENT`. Only `EVENT` sales have attendees.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "product-sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search_text", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "c50b4719-95c6-4d7a-910c-06cd453032da", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "product-sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search_text", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "804319de-ff56-41e2-b171-9ddc74983c2a", "name": "Missing/invalid/expired Bearer token, or a non-token auth failure (see the \"401 ≠ expiry\" note).", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "product-sales" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search_text", "value": "" }, { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"\",\n \"message\": \"\",\n \"code\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "cd002348-aefd-46cc-bcc4-376355008569", "name": "Count product sales", "request": { "name": "Count product sales", "description": {}, "url": { "path": [ "api", "v1", "agent", "product-sales", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search_text", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "478dd842-4ef1-4395-9939-dfcabebcab95", "name": "A count result.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "product-sales", "count" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search_text", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": {\n \"count\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "498b761c-fdbf-4a21-bf1c-f5dea62a0613", "name": "List attendees of an EVENT sale", "request": { "name": "List attendees of an EVENT sale", "description": { "content": "The guid must belong to an `EVENT`-type sale.", "type": "text/plain" }, "url": { "path": [ "api", "v1", "agent", "product-sales", ":guid", "attendees" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "type": "any", "value": "", "key": "guid", "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper" }, { "key": "redirect_uri", "value": "https://konto.is/strax/agent/token" }, { "key": "accessTokenUrl", "value": "https://konto.is/strax/agent/token" }, { "key": "authUrl", "value": "https://konto.is/strax/agent/authorize" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "59dee216-9384-4a1a-a42b-84821286edda", "name": "Standard envelope.", "originalRequest": { "url": { "path": [ "api", "v1", "agent", "product-sales", ":guid", "attendees" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Results per page (default 10).", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Page number (default 1).", "type": "text/plain" }, "key": "page", "value": "1" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) The resource's GUID.", "type": "text/plain" }, "type": "any", "value": "", "key": "guid" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"message\": \"\",\n \"result\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "auth": { "type": "oauth2", "oauth2": [ { "type": "any", "value": "nav create_invoice recurring cost manage_customers task sell_product dashboard_data bookkeeper", "key": "scope" }, { "type": "any", "value": "https://konto.is/strax/agent/token", "key": "redirect_uri" }, { "type": "any", "value": "https://konto.is/strax/agent/token", "key": "accessTokenUrl" }, { "type": "any", "value": "https://konto.is/strax/agent/authorize", "key": "authUrl" }, { "type": "any", "value": "authorization_code", "key": "grant_type" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://konto.is" } ], "info": { "_postman_id": "1cc4c654-7ce2-4faa-8b28-ca478058957e", "name": "Konto Agent API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "The **Agent API** lets a third-party application act on behalf of a Konto\nuser, after that user signs in and consents to a set of **scopes**. It is the\nOAuth2 surface behind the [Konto MCP connector](https://mcp.konto.is) and is\nthe recommended path for **user-delegated** and **AI** integrations.\n\n> For **headless server-to-server** integrations (no user to log in) — e.g. a\n> billing cron or an ERP sync running as a service — use the legacy\n> `username` + `api_key` REST API instead (see the in-app reference).\n\n## Environments\n\n| | Host | Purpose |\n|---|---|---|\n| **Production** | `https://konto.is` | Real accounts, real invoices & email. |\n| **Development** | `https://dev.konto.is` | Safe sandbox. Sign in with a dev/test account. |\n\nOAuth clients are **per-environment**: a `client_id` registered on dev does\nnot exist on prod, and vice versa. The OAuth endpoints live under\n`/strax/agent/*`; the resource endpoints under `/api/v1/agent/*`.\n\n> **dev.konto.is is always in maintenance mode.** Server-side calls to dev\n> must append `?en4_maint_code=` or receive HTTP 503. Ask Konto for the\n> current dev bypass code. Never send it to production.\n\n## Response envelope\n\nEvery resource endpoint returns a JSON envelope:\n\n```json\n{ \"status\": true, \"message\": \"\", \"result\": { ... } }\n```\n\n`status` is a boolean. On a handled error the HTTP status may still be `200`\nwith `status: false` and a `message` — **always check `status`**, not just the\nHTTP code. (Auth/scope/method failures do use real 4xx codes — see Errors.)\n\n## Sending write payloads\n\nCreate/update endpoints read the resource object from a **`data`** field. Send\nit as a **JSON-encoded string** — this is the universally-supported form and\nthe one the official MCP/SDK uses:\n\n```json\n{ \"data\": \"{\\\"name\\\":\\\"Acme ehf\\\",\\\"kennitala\\\":\\\"1234567890\\\",\\\"email\\\":\\\"acme@example.is\\\"}\" }\n```\n\nCustomer endpoints additionally accept the object nested (`{\"data\":{...}}`) or\nthe fields flat at the top level. The schemas below document the **decoded**\nobject shape in each `data` field.\n\n## The write contract (read before creating anything)\n\n- **VAT code** (`tax`): `S` = 24 %, `AA` = 11 %, `Z` = 0 %.\n- **Unit of measure** (`uom`): `C62` pieces · `HUR` hours · `DAY` days ·\n `KGS` kg · `MTR` m · `LTR` l · `MTK` m² · `MTQ` m³ · `TNE` t · `KWH` kWh ·\n `MIN` minutes · `KTM` km.\n- **Invoice `amount` must equal Σ(line items) + VAT**, rounded to 2 dp — the\n server rejects a mismatch.\n- **Invoice date chain:** `issue_date ≤ due_date ≤ settlement_date`.\n `settlement_date` (eindagi) is **required**.\n- **New inline invoice line** (`add_new: 1`) requires an `item_number`.\n- **`kennitala`**: 10 digits, no dash; validated (mod-11 checksum).\n- **`trading_partner_id`** (e-invoice): the recipient's **bare** kennitala —\n do not prefix the Peppol scheme `0196:`.\n- Cost `how_paid`: `1` Account · `2` Debit · `3` Credit · `4` Owner cash.\n- Customer `output_select` (delivery): `2` e-invoice/XML (needs\n `trading_partner_id`) · `3` email · `4` PDF.\n\n\nContact Support:\n Name: Konto", "type": "text/plain" } } }