Redeem a workspace code

POST

/workspace-codes/redeem

WorkspaceCodes

Redeem a workspace code for the current authenticated user. The code is submitted in the request body to avoid leaking it into access logs.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Workspace code redeemed successfully

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/workspace-codes/redeem' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "string"
}'

Response Example

{
    "redeemed": true,
    "workspaceCodeId": "string",
    "role": "owner",
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}

Modified at 2026-04-02 15:44:17

Redeem virtual transaction

Get workspace configuration