POST /public/v1/workspace-grants

Grant a user's API key visibility into a workspace without a workspace membership. The granted user gains MEMBER-level access on grant-aware Public API endpoints (workspace listing and endpoints resolving scope through the shared workspace-scope helpers); remaining endpoints are being rolled onto the grant-aware path. Requires an OWNER or ADMIN membership on the target workspace (or a workspace key for it) — a key can never grant itself access.

POST /public/v1/workspace-grants

API key in header x-api-key

curl --request POST \
  --url 'https://api.joinvalley.co/public/v1/workspace-grants' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "grant": {
      "user_id": "user_01JXY9AZK4KV",
      "user_email": "[email protected]",
      "workspace_id": "workspace_01JXY9AZK4KV",
      "granted_by_user_id": "granted_by_user_01JXY9AZK4KV",
      "created_at": "2026-01-01T12:00:00Z"
    }
  }
}

Default Response

Body

required application/json

workspace_id string required

user_email string · email required

Body

Responses