v1

latestOpenAPI 3.0.02026-07-1717466209.0 KB
Publish projects

Publish single external resource

Publish a single external resource (documentation file) to a NADA catalog. catalog_id in the body must match the catalog connection used for publishing. The optional trailing path segment matches the client URL pattern; the catalog is taken from the JSON body (catalog_id).

post/publish/external_resource/{sid}/{catalog_connection_id}

Path parameters

sidstring required

Project ID or IDNO

catalog_connection_idinteger required

Catalog connection ID (same as catalog_id in body; echoed in URL by clients)

Request body

resource_idinteger required

Resource ID to publish

catalog_idinteger required

Catalog connection ID (must match path catalog_connection_id when both are used)

sidstring

Project ID (optional; echoed by some clients; path sid is authoritative)

overwrite'yes' | 'no'

Sent to NADA on the resource payload as overwrite. When yes, replaces an existing resource with the same identity in the catalog.

Response

Resource published successfully

resourceobject

Resource metadata response

resource_uploadobject

Resource file upload response (if file was uploaded)