Skip to content

REST API reference ​

REST API of the OpenArtifact artifact repository manager.

This reference is generated from the embedded OpenAPI document internal/api/openapi.json and lists 287 endpoints in 28 tags. Authentication, token kinds, CSRF handling and worked examples are in the REST API guide.

Security ​

Unless an endpoint says otherwise, a request must satisfy one of: bearerAuth or cookieAuth.

SchemeTypeDetailsDescription
bearerAuthhttpscheme bearerBearer token authentication
cookieAuthapiKeyoa_session in cookieSession cookie set by POST /api/v1/auth/login. State-changing requests (POST, PUT, PATCH, DELETE) must also send the value of the readable oa_csrf cookie in the X-CSRF-Token header.

Servers ​

  • /: Current server

Endpoints by tag ​

TagEndpointsDescription
Admin50-
AI7-
Audit2-
Authentication8-
Backup5-
Branding7-
Bundles18-
Cleanup8-
Declarative3-
Dependency-Track9-
Documentation3-
Federation9-
GPG7-
Groups10-
Packages12-
Permissions8-
Projects30-
Repositories66-
SBOM15-
Scanning32-
Search1-
SSO13-
Storage25-
System5-
Tokens9-
Trash6-
Users9-
Webhooks9-

Schemas ​

All 150 named request and response objects are on the schemas page.

Free software under the AGPL-3.0-or-later.