Read the caller's workspace choice for an OAuth client
Returns the workspace the caller last selected for the given OAuth client, or null when they have never chosen one. Scoped to the authenticated caller's own preferences; one user's choice is never visible to another.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/me/oauth-client-workspace-preferences/string"{ "data": { "oauthClientId": "string", "workspaceId": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Acknowledge What's New releases up to a release id
Moves the caller's watermark for a channel forward to the given release and returns the resulting state. Naturally idempotent: the watermark only ever moves forward, so replaying an ack is a no-op.
Set the caller's workspace choice for an OAuth client
Records which workspace an OAuth client should use for the caller, replacing any previous choice for that client. Naturally idempotent: the row is upserted per caller and client. The caller must be a member of the target workspace, otherwise the request is denied. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.