Skip to content

feat: api docs for envs / apps / access#213

Merged
nimish-ks merged 29 commits into
mainfrom
feat--apis--envs-apps-access
May 28, 2026
Merged

feat: api docs for envs / apps / access#213
nimish-ks merged 29 commits into
mainfrom
feat--apis--envs-apps-access

Conversation

@rohan-chaturvedi
Copy link
Copy Markdown
Member

companion pr for phasehq/console#798

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Mar 13, 2026

Deploying phase-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 368aa06
Status:⚡️  Build in progress...

View logs

Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
…, owner immutability, identity_key preconditions, role delete codes, invite validation, error status codes)
…field, use camelCase in role response examples, link to access-control/roles for resource list, drop user-facing 'soft-delete' language
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
@rohan-chaturvedi rohan-chaturvedi force-pushed the feat--apis--envs-apps-access branch from 660525f to 1f1dc26 Compare May 12, 2026 09:59
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
…nt folder field, drop trailing-space Bearer token, replace io/ioutil with io
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
…expires_in (priority + ISO-8601 with timezone)
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
…s, point Members page to Invites for new-member flow
… requires invitee identity key (post-acceptance only)
rohan-chaturvedi and others added 2 commits May 25, 2026 19:56
Signed-off-by: rohan <rohan.chaturvedi@protonmail.com>
…h backend

After re-validation against `phasehq/console@api--apps-envs-accounts`:

- Roles POST/PUT examples shipped `"global_access": false`, but the
  server rejects any `global_access` / `globalAccess` under `permissions`
  with `400 Bad Request` (`backend/api/views/roles.py:58`, allowed_keys =
  {"permissions", "app_permissions"}). Removed the rejected key from
  both cURL + Python examples and rewrote the Required-fields /
  PUT-body descriptions to match. The Note block at the top of the
  page (line 60) already said only `permissions` + `app_permissions`
  are accepted, so the page is now internally consistent.

- DELETE Service Account paragraph said revoked tokens return
  `403 Forbidden`. Actual behaviour is `401 Unauthorized` with
  `{"error": "Token expired or deleted"}`
  (`backend/api/auth.py:88-89` raises `AuthenticationFailed`, which DRF
  maps to 401). Matches the sibling DELETE Token paragraph and
  `errors.mdx` line 40.

Related: phasehq/console#798, PH-618
rohan-chaturvedi and others added 2 commits May 28, 2026 13:21
…fixes

docs(rest): align Roles 'global_access' usage and DELETE-SA token-invalidation status with backend
@nimish-ks nimish-ks merged commit 2ecf358 into main May 28, 2026
1 check was pending
@nimish-ks nimish-ks deleted the feat--apis--envs-apps-access branch May 28, 2026 08:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants