Skip to main content

List my projects

GET /v1/projects
devhttps://api.sandbox.ovok.com

Every FHIR Project the caller has a ProjectMembership on. Each entry carries an admin flag (project-admin status for the caller) and an internal flag (Ovok-managed tenant, hidden from billing).

Use this to render a tenant switcher in your dashboard — the sub-project hierarchy is exposed via GET /v1/internal/sub-project (internal API).

Example

curl '<APP_BASE_URL>/v1/projects' \
-H 'Authorization: Bearer <token>'

Responses

CodeDescription
200Success.
400The request could not be operated by the server.
401The resource owner or authorization server denied the request.
404The requested resource could not be found.
422The request could not be validated by the server.
500The server encountered an unexpected condition. Please try again later.

200ProjectListResponseDto (application/json)

All Medplum projects the caller is a member of.

  • projects: object[] (required)
    • id: string (required)
    • name: string (required)
    • slug: string (required)
    • parentProjectId: string (required)
    • isAdmin: boolean (required)
    • isInternal: boolean (required)