Submit a new Declaration to registries
Submit a new Declaration to the CommonsDB registry. The declaration must include:
- JWT signature with embedded JWK in the header (ES256 algorithm)
- TSA signature with timestamp request (TSQ) and response (TSR)
- Schema and Context URLs pointing to valid CommonsDB schemas (minimum version 0.2.0)
- Timestamp within 60 seconds of server time
- Valid ISCC code in format
ISCC:XXXXXXX(55 character alphanumeric code) - Valid rightsStatement (if commonsDbRegistry is provided) - must be a Creative Commons or Public Domain license URL
Headers
Authorizationstring · requiredBearer token for authentication (e.g.,
Bearer <your-api-key>)
Request Body
signaturestring · pattern:^[A-Za-z0-9_-]+\.[A-…· requiredJWT signature of the declaration metadata. Must use ES256 algorithm with JWK embedded in the header.
tsaSignatureobject · requiredTimestamp Authority signature containing the timestamp request and response
declarationMetadataobject · required
commonsDbRegistrySignaturestring · pattern:^[A-Za-z0-9_-]+\.[A-…JWT signature of the commonsDbRegistry metadata. Required when commonsDbRegistry is provided.
commonsDbRegistryTsaSignatureobjectTSA signature for commonsDbRegistry. Required when commonsDbRegistry is provided.
Responses
Declaration accepted and pending processing
rayIdstringUnique request identifier for tracking
messagestring · enumStatus message indicating the declaration was accepted
Enum values:accepted and pendingaccepted and pending, tracking may be delayedenvstringEnvironment where the declaration was processed
isccstringISCC code of the submitted declaration
cidV1stringCIDv1 identifier generated for the declaration. Use this to track status via
/v1/status/{identifier}endpoint.versionstringAPI version