{ "info": { "_postman_id": "2d02853b-a1dd-48db-9b33-388df3d5d60a", "name": "Archil Control Plane API Tokens API", "description": "The Archil Control Plane API provides programmatic access to manage disks,\nmounts, and API keys in the Archil distributed filesystem platform.\n\nAPI keys authenticate requests to this control plane and are scoped to\nyour account. They are distinct from *disk tokens*, which are per-disk\ncredentials used by clients when mounting a disk.\n\n## Authentication\n\nAll endpoints require an API key:\n\n```\nAuthorization: {API_KEY}\n```\n\nCreate API keys in the [Archil Console](https://console.archil.com) or via the API.\n\n## Response Format\n\nAll responses use a consistent envelope:\n\n```json\n{\n \"success\": true,\n \"data\": { ... }\n}\n```\n\nOr on error:\n\n```json\n{\n \"success\": false,\n \"error\": \"Error message\"\n}\n```\n\n\nContact Support:\n Email: support@archil.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:04:35.000Z", "updatedAt": "2026-07-28T01:04:35.000Z", "lastUpdatedBy": "35240", "uid": "35240-2d02853b-a1dd-48db-9b33-388df3d5d60a" }, "item": [ { "name": "api", "item": [ { "name": "tokens", "item": [ { "name": "{id}", "item": [ { "name": "Delete API token", "id": "3ae58002-6888-4a85-b798-35c085e0e5c9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/tokens/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens", ":id" ], "variable": [ { "id": "937eee3e-82a2-4092-9ae4-1b83e0f322f5", "key": "id", "value": "", "description": "(Required) The token ID (hash)" } ] }, "description": "Revokes and deletes an API token." }, "response": [ { "id": "35753341-d748-4993-bcd5-be54a24d4c91", "name": "Token deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"data\": {\n \"message\": \"\"\n }\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-35753341-d748-4993-bcd5-be54a24d4c91" }, { "id": "8f59cdb2-10d9-463b-b754-9b8db2978593", "name": "Invalid or missing authentication credentials", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-8f59cdb2-10d9-463b-b754-9b8db2978593" }, { "id": "a8f95376-2bb7-40c1-a1ce-c58ba761babe", "name": "Resource not found", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-a8f95376-2bb7-40c1-a1ce-c58ba761babe" }, { "id": "87829165-ac86-40b4-9eac-04f163f953d9", "name": "Internal server error", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-87829165-ac86-40b4-9eac-04f163f953d9" } ], "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-3ae58002-6888-4a85-b798-35c085e0e5c9" } ], "id": "0839e918-0de7-4b69-8b81-df6b0da92a91", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-0839e918-0de7-4b69-8b81-df6b0da92a91" }, { "name": "List API tokens", "id": "90f5ddc2-1abf-4e40-b991-84b5c8a1adbf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/tokens?limit=50&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ], "query": [ { "description": "Maximum number of items to return", "key": "limit", "value": "50" }, { "description": "Pagination cursor from a previous response", "key": "cursor", "value": "" } ] }, "description": "Returns all API tokens for the authenticated account." }, "response": [ { "id": "b0f6aae1-7f1d-4316-9528-58e6edbaecb2", "name": "List of API tokens", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens?limit=50&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ], "query": [ { "description": "Maximum number of items to return", "key": "limit", "value": "50" }, { "description": "Pagination cursor from a previous response", "key": "cursor", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"data\": {\n \"tokens\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"tokenSuffix\": \"\",\n \"createdAt\": \"\",\n \"lastUsedAt\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"tokenSuffix\": \"\",\n \"createdAt\": \"\",\n \"lastUsedAt\": \"\"\n }\n ]\n }\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-b0f6aae1-7f1d-4316-9528-58e6edbaecb2" }, { "id": "daf66bfd-ee5b-43ba-b632-25d81b87200c", "name": "Invalid or missing authentication credentials", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens?limit=50&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ], "query": [ { "description": "Maximum number of items to return", "key": "limit", "value": "50" }, { "description": "Pagination cursor from a previous response", "key": "cursor", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-daf66bfd-ee5b-43ba-b632-25d81b87200c" }, { "id": "1ea25139-e72f-4735-bcd9-cfa5b04fee57", "name": "Internal server error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/api/tokens?limit=50&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ], "query": [ { "description": "Maximum number of items to return", "key": "limit", "value": "50" }, { "description": "Pagination cursor from a previous response", "key": "cursor", "value": "" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-1ea25139-e72f-4735-bcd9-cfa5b04fee57" } ], "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-90f5ddc2-1abf-4e40-b991-84b5c8a1adbf" }, { "name": "Create API token", "id": "01c95f7d-4b06-4576-95f6-e50a56197436", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ] }, "description": "Creates a new API token for programmatic access. The full token value\nis only returned once at creation time.\n" }, "response": [ { "id": "bb2aa455-9046-406f-a618-b34e8543e115", "name": "Token created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"data\": {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"tokenSuffix\": \"\",\n \"createdAt\": \"\",\n \"lastUsedAt\": \"\",\n \"token\": \"\"\n }\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-bb2aa455-9046-406f-a618-b34e8543e115" }, { "id": "8c8ab428-403b-4dfd-a6df-96d09f255804", "name": "Validation error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-8c8ab428-403b-4dfd-a6df-96d09f255804" }, { "id": "a73b45b1-547a-47b5-8870-2c0f12571220", "name": "Invalid or missing authentication credentials", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-a73b45b1-547a-47b5-8870-2c0f12571220" }, { "id": "9028a9d6-b3b7-4798-b6c1-343f6d8017cf", "name": "Internal server error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "tokens" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"success\": \"\",\n \"error\": \"\"\n}", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-9028a9d6-b3b7-4798-b6c1-343f6d8017cf" } ], "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-01c95f7d-4b06-4576-95f6-e50a56197436" } ], "id": "69328809-4d62-4ce5-8195-6a51247f9a00", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-69328809-4d62-4ce5-8195-6a51247f9a00" } ], "id": "a6a7dafa-4490-4dd4-9f37-b096b082e489", "createdAt": "2026-07-28T01:04:36.000Z", "updatedAt": "2026-07-28T01:04:36.000Z", "uid": "35240-a6a7dafa-4490-4dd4-9f37-b096b082e489" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://control.green.us-east-1.aws.prod.archil.com" } ] }