{"_id":"59c057ffa4a6210010294c17","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":19,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59c035e42126e10028effb12","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-18T21:08:52.843Z","from_sync":false,"order":9,"slug":"clients-api","title":"Clients API"},"user":"58cc41f21751ce2f003be3b7","__v":2,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-18T23:34:23.807Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"post","examples":{"codes":[]},"results":{"codes":[]},"settings":"59a74f2dcce3a7002729229b","auth":"required","params":[{"_id":"59c057ffa4a6210010294c19","ref":"","in":"body","required":false,"desc":"","default":"","type":"string","name":"description"},{"_id":"59c057ffa4a6210010294c18","ref":"","in":"path","required":true,"desc":"","default":"","type":"string","name":"id"}],"url":"/:id/tokens"},"isReference":false,"order":6,"body":"# Details\n\nCreate a client token.\n\nAn account token or server token may be used to run this endpoint.\n\n# Parameters\n\n## path\n\n- id (required): The ID of the [client](https://docs.droplit.io/docs/containers#section-clients).\n\n## body\n\n- description (optional): The description of the client token.\n\n# Responses\n\n## 201\n\n```\n{\n    \"createdAt\": \"YYYY-MM-DD HH:MM:SS ENCODED\",\n    \"id\": \"CLIENT-ID\",\n    \"token\": \"TOKEN\"\n}\n```\n\n## 400\n\n- __Client Invalid:__ The standard error structure defines this error as invalid parameters, with an invalid ID. In this context, it means that the ID given for a client is invalid.\n\n## 404\n\n- __Client Not Found:__ This error means that a client with the given ID was not found. This is distinct from an invalid client ID being specified; this means that the client ID once existed, but no longer does.\n\n# Examples\n\n## HTTP\n\n```\nPOST https://ioe.droplit.io/api/clients/CLIENT-ID/tokens HTTP/1.1\nauthorization: TOKEN\ncontent-type: application/json\n{\n    \"description\": \"TOKEN-DESCRIPTION\"\n}\n```\n\n## Droplit Console\n\n```\ndroplit token create --clientId CLIENT-ID\n```","excerpt":"","slug":"clients-tokens-create","type":"endpoint","title":"Create a client token."}

postCreate a client token.


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string

Body Params

description:
string

Documentation

# Details Create a client token. An account token or server token may be used to run this endpoint. # Parameters ## path - id (required): The ID of the [client](https://docs.droplit.io/docs/containers#section-clients). ## body - description (optional): The description of the client token. # Responses ## 201 ``` { "createdAt": "YYYY-MM-DD HH:MM:SS ENCODED", "id": "CLIENT-ID", "token": "TOKEN" } ``` ## 400 - __Client Invalid:__ The standard error structure defines this error as invalid parameters, with an invalid ID. In this context, it means that the ID given for a client is invalid. ## 404 - __Client Not Found:__ This error means that a client with the given ID was not found. This is distinct from an invalid client ID being specified; this means that the client ID once existed, but no longer does. # Examples ## HTTP ``` POST https://ioe.droplit.io/api/clients/CLIENT-ID/tokens HTTP/1.1 authorization: TOKEN content-type: application/json { "description": "TOKEN-DESCRIPTION" } ``` ## Droplit Console ``` droplit token create --clientId CLIENT-ID ```

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}