From eee453f727041f21b6c2bfb5a1bcc503ce1e0a98 Mon Sep 17 00:00:00 2001 From: Jonathan Payne Date: Wed, 14 Oct 2026 08:48:50 -0400 Subject: [PATCH] OpenConceptLab/ocl_online#224 | Org ids are unique regardless of case; document concept /parents/ and /children/ Describes the API as of OpenConceptLab/oclapi2#943: merge with its deploy. Co-Authored-By: Claude Opus 5.5 --- docs/source/oclapi/apireference/concepts.md | 14 ++++++++++++++ docs/source/oclapi/apireference/orgs.md | 2 +- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/source/oclapi/apireference/concepts.md b/docs/source/oclapi/apireference/concepts.md index 34a0273..69adc93 100644 --- a/docs/source/oclapi/apireference/concepts.md +++ b/docs/source/oclapi/apireference/concepts.md @@ -582,6 +582,20 @@ Status: 200 OK +## List parents or children of a concept +* List the concepts that are the parents, or the children, of a concept in its source's hierarchy, where an optional `:sourceVersion` is a source version ID +``` +GET /orgs/:org/sources/:source/[:sourceVersion/]concepts/:concept/parents/ +GET /orgs/:org/sources/:source/[:sourceVersion/]concepts/:concept/children/ +GET /users/:user/sources/:source/[:sourceVersion/]concepts/:concept/parents/ +GET /users/:user/sources/:source/[:sourceVersion/]concepts/:concept/children/ +GET /user/sources/:source/[:sourceVersion/]concepts/:concept/parents/ +GET /user/sources/:source/[:sourceVersion/]concepts/:concept/children/ +``` +* Notes + * Only concepts the requester can view are listed: a parent or child in another source is listed only if the requester can view that source. + * These lists aren't searchable: `q` and other search parameters are ignored. To search a source's concepts, use [List concepts in a source](#list-concepts-in-a-source). + ## Get a single concept name * Get a single concept name ``` diff --git a/docs/source/oclapi/apireference/orgs.md b/docs/source/oclapi/apireference/orgs.md index f580731..eeecc1a 100644 --- a/docs/source/oclapi/apireference/orgs.md +++ b/docs/source/oclapi/apireference/orgs.md @@ -86,7 +86,7 @@ GET /user/orgs/ POST /orgs/ ``` * Input - * **id** (required) string + * **id** (required) string - unique regardless of letter case: an id that differs from an existing organization's only in case (e.g. `my-org` when `My-Org` exists) returns `400 Bad Request` * **name** (required) string * **company** (optional) string * **website** (optional) string