{"id":23977,"date":"2026-07-13T09:14:13","date_gmt":"2026-07-13T03:44:13","guid":{"rendered":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/?post_type=article&#038;p=23977"},"modified":"2026-08-12T14:13:20","modified_gmt":"2026-08-12T08:43:20","slug":"api-key-generation","status":"publish","type":"article","link":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/","title":{"rendered":"API Key Generation"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>An API key is a secure token that lets you authenticate your requests to the Nimble REST APIs. Using this key, you can programmatically access Nimble data \u2014 such as Users, Projects, and Team Members \u2014 from your own applications or integration tools, without signing in through the web interface each time.<\/p>\n<p>You generate the key from the <strong>API Key Generation<\/strong> screen, set an expiry date for it, and then use it to authorize your API calls.<\/p>\n<h2>Navigation<\/h2>\n<p>In the left panel, select <strong>Account Space<\/strong>. Then, from the top panel, go to <strong>Administration<\/strong> and select <strong>API Key Generation<\/strong>.<\/p>\n<p><a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/admin-menu2-masked.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/admin-menu2-masked.png\" alt=\"Navigate to Account Space, Administration, API Key Generation\" \/><\/a><\/p>\n<h2>Generate an API Key<\/h2>\n<p>The API Key Generation screen opens with an <strong>Expiry date<\/strong> field and the <strong>Generate API Key<\/strong> button.<\/p>\n<p><a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-01-screen.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-01-screen.png\" alt=\"API Key Generation screen\" \/><\/a><\/p>\n<ol>\n<li>Click the <strong>Expiry date<\/strong> field and select the date on which you want the key to stop working. The key remains valid until the end of this date.<a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-02-date.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-02-date.png\" alt=\"Select an expiry date for the API key\" \/><\/a><\/li>\n<li>Click <strong>Generate API Key<\/strong>.<\/li>\n<li>Your new personal access API key is generated and displayed. Click the <strong>Copy<\/strong> icon next to the key and store it in a safe place.<a href=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-03-generated-masked.png\"><img decoding=\"async\" style=\"max-width: 100%; height: auto; border: 1px solid #ddd;\" src=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-content\/uploads\/2026\/07\/apikey-03-generated-masked.png\" alt=\"API key generated with a Copy icon\" \/><\/a><\/li>\n<\/ol>\n<h2>How It Works<\/h2>\n<p>The generated key is shown <strong>only once<\/strong>, at the time of generation. For security, Nimble does not store or display it again \u2014 so make sure you copy and save it before leaving the screen. If you lose the key, generate a new one.<\/p>\n<p>The key stays active until the <strong>expiry date<\/strong> you set. After that date, any request made with the key is rejected, and you need to generate a new key to continue.<\/p>\n<h2>Use the API Key with the Nimble REST APIs<\/h2>\n<p>Once you have your API key, you can use it to explore and run the Nimble REST APIs from the interactive API documentation (Swagger) page:<\/p>\n<p><a target=\"_blank\" href=\"https:\/\/nimble.digite.com\/apidocs\/v2\/saas\/\" rel=\"noopener\">https:\/\/nimble.digite.com\/apidocs\/v2\/saas\/<\/a><\/p>\n<p>The Swagger page lists all available APIs \u2014 such as User, Project, and Team Members \u2014 and lets you try them directly from the browser. To use it:<\/p>\n<ol>\n<li>Open the Swagger page using the link above.<\/li>\n<li>Click <strong>Authorize<\/strong> and paste the API key you copied from Nimble. This authenticates all the requests you make from this page.<\/li>\n<li>Expand the API you want to use (for example, <strong>Users<\/strong>) and select the specific endpoint.<\/li>\n<li>Click <strong>Try it out<\/strong>, fill in any required parameters, and click <strong>Execute<\/strong>.<\/li>\n<li>Review the response returned by Nimble, including the request URL, response body, and status code.<\/li>\n<\/ol>\n<p>This makes it easy to test how each API behaves before using it in your own application or integration.<\/p>\n<h2>Integration Levels<\/h2>\n<p>Nimble supports integration at two levels:<\/p>\n<ul>\n<li><strong>System-level integration<\/strong> \u2014 managed centrally and not tied to an individual user.<\/li>\n<li><strong>Project-level integration<\/strong> \u2014 specific to a project&#8217;s configuration.<\/li>\n<\/ul>\n<p>The REST APIs and the API key you generate here are used to build these integrations. Additional integration capabilities are planned for future releases.<\/p>\n<h2>Important Points<\/h2>\n<ul>\n<li>The API key is displayed only once. Copy and store it securely as soon as it is generated.<\/li>\n<li>The key is a personal access key \u2014 it carries your access permissions, so treat it like a password and do not share it.<\/li>\n<li>Set an appropriate expiry date. Once the key expires, generate a new one to continue accessing the APIs.<\/li>\n<li>Use the key only over secure (HTTPS) connections when calling the Nimble REST APIs.<\/li>\n<\/ul>\n<div class=\"helpful-block-content wth-theme-thumbs\" data-title=\"\" >\n<ul>\n<li><span class=\"wth-title\">Was this helpful?<\/span><\/li>\n<li><a data-post=\"23977\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/\" data-post-title=\"API Key Generation\" data-response=\"1\" href=\"#\" class=\"wth-green-btn icon-thumbsup\">Yes<\/a>&nbsp; &nbsp;<a data-response=\"0\" data-post=\"23977\" data-post-url=\"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/article\/api-key-generation\/\" data-post-title=\"API Key Generation\" href=\"#\" class=\"wth-red-btn icon-thumbsdown\">No<\/a><\/li>\n<\/ul>\n<\/div>","protected":false},"author":4,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","multi-rating":{"mr_rating_results":[]},"_links":{"self":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977"}],"collection":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/comments?post=23977"}],"version-history":[{"count":5,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977\/revisions"}],"predecessor-version":[{"id":24068,"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/article\/23977\/revisions\/24068"}],"wp:attachment":[{"href":"https:\/\/www.nimblework.com\/knowledge-base\/nimble\/wp-json\/wp\/v2\/media?parent=23977"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}