Create and organize Help Scout Docs knowledge-base collections and articles via the Docs API

Steps

1. Authenticate with HTTP Basic Auth against https://docsapi.helpscout.net/v1/, using your Docs API key as the username and any placeholder value as the password.
2. Create a collection with POST /v1/collections, body {"collection": {"siteId": ..., "name": ..., "visibility": "public"|"private", "order": ..., "description": ...}}; the response is 201 Created with a Location header pointing to the new collection.
3. Create an article with POST /v1/articles, body {"article": {"collectionId": ..., "name": ..., "text": ..., "status": "published"|"notpublished", "categories": [...], "keywords": [...]}}; response is 201 Created with a Location header.
4. List articles in a collection or category via GET /v1/collections/{id}/articles or /v1/categories/{id}/articles, using page, pageSize (max 100), status, sort, and order query params; results return abbreviated ArticleRef objects, not full article bodies.
5. Update an existing article via the Update Article endpoint, or stage in-progress edits with Save Article Draft before publishing.
6. On errors, read the standard error envelope {"code":..., "error":...} and the Correlation-Id response header, which Help Scout support uses to trace requests.