update docs for simplified project API key auth

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: snopoke

docs/basics.md

@@ -3,21 +3,17 @@ title: Using the API
 ---
 # Using the Task Badger API
 
-## Organization and Project
+## Authentication
 
-API endpoints include both the `organization` and `project` slug. The user authenticating
-the request must have access to both for the request to be accepted.
+API requests must be authenticated using a **Project API Key** provided in the
+`Authorization` header as a Bearer token.
 
-* Organization slug
-    * You can get this by going to 'My Organization'  
-* Project slug
-    * Go to the 'Projects' page. The slug for each project is listed. 
+You can find your API key on the project settings page in the
+[Task Badger dashboard](https://taskbadger.net). A default API key is created
+automatically when you create a new organization.
 
-## Authentication
-
-Requests must be authenticated by providing a bearer token provided
-in the Authentication header. You can generate a token by going to your
-[user profile page](https://taskbadger.net/users/profile/).
+The API key encodes your organization and project, so you don't need to
+configure them separately.
 
 ```linenums="1" hl_lines="2"
 POST https://taskbadger.net/api/{organization}/{project}/tasks/
@@ -26,6 +22,17 @@ Content-type: application/json
 {"name":"demo task","status":"pending"}
 ```
 
+## Organization and Project
+
+API endpoints include both the `organization` and `project` slug. When using
+a Project API Key with the Python SDK or CLI, these are detected automatically
+from the key.
+
+If you need to find them manually:
+
+* **Organization slug** — available on the 'My Organization' page
+* **Project slug** — listed on the 'Projects' page
+
 ## Request bodies
 
 The payload of HTTP POST requests must be specified as JSON. 

docs/cli.md

@@ -88,7 +88,7 @@ Values provided via environment variables override values in the configuration f
 and values provided via the command line override both environment config and the
 configuration file.
 
-Details about the configuration parameters can be found [here](basics.md#organization-and-project)
+Details about authentication can be found [here](basics.md#authentication).
 
 ### Command line arguments
 
@@ -113,24 +113,26 @@ of the API Key.
 
 ### Environment variables
 
-Use the following environment variable names to configure the CLI:
+Use the following environment variable to configure the CLI:
+
+* `TASKBADGER_API_KEY` — Project API key (organization and project are detected automatically)
+
+When using a legacy API key, the following additional variables are required:
 
-* `TASKBADGER_API_KEY`
 * `TASKBADGER_ORG`
 * `TASKBADGER_PROJECT`
 
 ### Configuration file
 
 The CLI includes a convenience command to create the configuration file. Running the `configure`
-command will prompt you for the configuration parameters and save them to the configuration
-file.
+command will prompt you for your API key. If you provide a Project API Key, the organization
+and project are detected automatically.
 
 ```bash
 $ taskbadger configure
 
-Organization slug: my-org 
-Project slug: project-x 
-API Key: XYZ.ABC 
+API Key: YOUR_API_KEY
+Project key detected — organization: my-org, project: project-x
 
 Config written to ~/.config/taskbadger/config
 ```

docs/python-celery.md

@@ -22,9 +22,7 @@ import taskbadger
 from taskbadger.systems import CelerySystemIntegration
 
 taskbadger.init(
-    organization_slug="my-org",
-    project_slug="my-project",
-    token="***",
+    token="YOUR_API_KEY",
     systems=[CelerySystemIntegration()],
     tags={"environment": "production"}
 )

docs/python.md

@@ -18,23 +18,23 @@ The SDK must be configured before you can use it to interact with the APIs.
 import taskbadger
 
 taskbadger.init(
-    organization_slug="my-org",
-    project_slug="my-project",
-    token="***",
+    token="YOUR_API_KEY",
     tags={"environment": "production"},
 )
 ```
 
-Details about the slug configuration parameters can be found [here](basics.md#organization-and-project).
+When using a Project API Key, the organization and project are detected
+automatically from the key. You can find your API key on the project settings
+page in the [Task Badger dashboard](https://taskbadger.net).
 
 | Name              | Description                                                                                               |
 |-------------------|-----------------------------------------------------------------------------------------------------------|
-| organization_slug | The organization identifier.                                                                              |
-| project_slug      | The project identifier.                                                                                   |
-| token             | API authentication token.                                                                                 |
+| token             | Project API key. The organization and project are extracted from the key automatically.                    |
 | tags              | Global tags which are added to all tasks.                                                                 |
 | systems           | System integrations such as [Celery](python-celery.md)                                                    |
 | before_create     | A function that is called before a task is created. See [Before Create Callback](#before-create-callback) |
+| organization_slug | The organization identifier. Only required for legacy API keys.                                           |
+| project_slug      | The project identifier. Only required for legacy API keys.                                                |
 
 If you attempt to use the SDK without configuring it you will get an error. To avoid this you can use the
 [safe functions](#safe-functions) which will log any errors to the `taskbadger` logger.

docs/quick.md

@@ -7,14 +7,9 @@ Let's discover **Task Badger in less than 5 minutes**.
 
 ## Setup
 
-In order to use the API you will need the following details:
-
-* Organization slug
-    * You can get this by going to 'My Organization'  
-* Project slug
-    * Go to the 'Projects' page. The slug for each project is listed. 
-* API Key
-    * Create one on your Profile page
+To get started you will need a **Project API Key**. You can find this on
+the project settings page in the [Task Badger dashboard](https://taskbadger.net).
+A default key is created automatically when you create a new organization.
 
 
 ## Montior Celery Tasks
@@ -29,9 +24,7 @@ from taskbadger.systems.celery import CelerySystemIntegration
 app = Celery('hello', broker='amqp://guest@localhost//')
 
 taskbadger.init(
-    organization_slug="my-org",
-    project_slug="my-project",
-    token="***",
+    token="YOUR_API_KEY",
     tags={"environment": "production"},
     systems=[CelerySystemIntegration(record_task_args=True)]
 )
@@ -55,11 +48,10 @@ $ python3 -m pip install taskbadger
 
 $ taskbadger configure
 
-Organization slug: my-org 
-Project slug: project-x 
-API Key: XYZ.ABC
+API Key: YOUR_API_KEY
+Project key detected — organization: my-org, project: project-x
 
-Config written to ~/.config/taskbadger/confi
+Config written to ~/.config/taskbadger/config
 ```
 
 ### Use the CLI to run and monitor the command
@@ -94,21 +86,20 @@ See more about the [CLI](cli.md).
     import taskbadger
 
     taskbadger.init(
-        organization_slug="my-org",
-        project_slug="my-project",
-        token="***",
+        token="YOUR_API_KEY",
         tags={"environment": "production"},
     )
     ```
 
 === "Shell"
 
-    Export the configuration parameters:
+    Export the configuration parameters. The organization and project slugs
+    can be found on the project settings page alongside your API key.
 
     ```shell
     export ORG="my-org"
     export PROJECT="my-project"
-    export API_KEY="***"
+    export API_KEY="YOUR_API_KEY"
     ```
 
 ### Creating a task