Skip to main content

API Collections

An API Collection is a logical grouping of API endpoints within an API Service. It represents a set of related API operations.
Entity schema follows the OpenMetadata Standard.

Entity Hierarchy

API Collections belong to an API Service and contain API Endpoints:
APIService
└── APICollection (this page)
    └── APIEndpoint

Fully Qualified Name

The FQN format for an API collection is:
service.collectionName
For example: sample_api_service.pet

API Endpoints

MethodEndpointDescription
PUT/v1/apiCollectionsCreate or update an API collection
POST/v1/apiCollectionsCreate an API collection (POST variant)
GET/v1/apiCollectionsList API collections
GET/v1/apiCollections/{id}Get by ID
GET/v1/apiCollections/name/{fqn}Get by FQN
PATCH/v1/apiCollections/{id}Update by ID
PATCH/v1/apiCollections/name/{fqn}Update by name
DELETE/v1/apiCollections/{id}Delete by ID
DELETE/v1/apiCollections/name/{fqn}Delete by name
PUT/v1/apiCollections/restoreRestore soft-deleted API collection
GET/v1/apiCollections/{id}/versionsList versions
GET/v1/apiCollections/{id}/versions/{version}Get specific version