Current source preview reference
GET /v1/auth/ide/browser-invitations/{invitation_id}/membership
Wait for ide browser membership. Permissions, parameters, responses and examples.
Read pinned handler: apps/api/kodesec_api/auth.py:2765
Wait for ide browser membership
Wait once for one IDE-issued browser invitation to become durable.
Source preview; no stable third-party integration promise. This page makes no request to a local installation.
Authority
Exact active IDE capability with browser:invite. Handler requires IDE authority; a browser session alone is insufficient.
Parameters and headers
| Name | Location | Contract |
|---|---|---|
invitation_id | path Required | string Schema |
Request body
No typed JSON body is declared by this handler. That does not rule out source-level request parsing; inspect the pinned implementation, especially for internal connector protocols.
Responses
| Status | Meaning and declared shape |
|---|---|
200 | Successful Response application/json · IdeBrowserInvitationPendingResponse | IdeBrowserInvitationActiveResponse | IdeBrowserInvitationMissingResponse |
400 | Exact host, malformed request or URL credential refusal application/json · object |
401 | Missing or invalid membership application/json · object |
403 | Exact origin, CSRF or route authority refusal application/json · object |
404 | Refresh the collection and verify the resource identity before retrying. See source-linked error catalog. |
422 | Validation Error application/json · HTTPValidationError |
429 | Authentication rate or connection limit application/json · object |
An empty or broad schema preserves the source contract. It is not a promise of an empty response.
Source-linked errors
Literal HTTP errors in this handler and same-file helper call graph, plus control middleware. Dynamic and cross-module failures may add other errors; source links are authoritative.
3 source error observations
| Status | Source detail | Recovery |
|---|---|---|
| 404 ↗ | browser invitation not found | Refresh the collection and verify the resource identity before retrying. |
| 404 ↗ | browser invitation not found | Refresh the collection and verify the resource identity before retrying. |
| 404 ↗ | browser invitation not found | Refresh the collection and verify the resource identity before retrying. |
Synthetic examples
These examples validate declared JSON shapes and formats. They contain no real installation data and do not prove runtime admission, cross-field validation, authority or successful work.
Response 200 JSON
{
"expires_at": "2026-01-01T00:00:00Z",
"invitation_id": "AAAAAAAAAAAAAAAAAAAAAAAA",
"purpose": "integrated_dashboard"
}All referenced models remain in its components section. Browse control model definitions.