Create Api Key
Get an API key by signing the user in through their browser; the one call that takes no key.
- Make a PKCE pair: code_verifier, 43 to 128 random characters of A-Z, a-z, 0-9, -, ., _ or ~, and code_challenge, its SHA-256 digest in base64url without padding. Make a random state.
- Listen for one request on a free port of 127.0.0.1; redirect_uri is exactly http://127.0.0.1:<port>/callback, with no query.
- Open the authorize page in the user's browser: https://app.versionstory.com/developer/authorize. Add the query client_name (what you are, such as "Claude Code on <hostname>", which becomes the key's name), redirect_uri, code_challenge, code_challenge_method=S256 and state. The user signs in or registers and allows the request; the browser then calls redirect_uri with code and state, or with error=access_denied when they decline. Check that state matches.
- While the browser waits on redirect_uri, send code, code_verifier and redirect_uri to this call (within five minutes), at https://api.versionstory.com. The answer carries api_key, once: store it where the user's secrets live and never print it.
- Answer the browser with a redirect to the authorize page's host at /developer/authorize/complete?result=granted, or result=denied after error=access_denied, or result=failed, which tells the user they are done.
post/v1/api-keys
Request
- Base URLhttps://api.versionstory.com (the document declares no server; this is the origin it was published from)
- URLhttps://api.versionstory.com/v1/api-keys
- Authnone declared
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.