// Metadata created by nebel

[id="registry-artifact-metadata_{context}"]
= {registry} artifact metadata

[role="_abstract"]
When an artifact is added to {registry}, a set of metadata properties is created and stored. This metadata consists of system-generated or user-generated properties that are read-only, and editable properties that you can update after the artifact is created.

.{registry} system-generated metadata
[.table-expandable,width="100%",cols="1,1,2",options="header"]
|===
|Property
|Type
|Description
|`createdOn`
|date
|The date and time when the artifact was created, for example, `2023-10-11T14:15:28Z`.
|`globalId`
|integer
|Globally unique identifier of an artifact version in {registry}. For example, a global ID of `1` is assigned to the first artifact version created in {registry}.
|`modifiedBy`
|string
|The name of the user who modified the artifact.
|`modifiedOn`
|date
|The date and time at which the artifact was modified, for example, `2023-10-11T14:15:28Z`.
|===


.{registry} user-provided or system-generated metadata
[.table-expandable,width="100%",cols="1,1,2",options="header"]
|===
|Property
|Type
|Description
|`groupId`
|string
|Unique identifier of an artifact group in {registry}, for example, `development` or `production`. When creating an artifact by using the {registry} web console, if you do not provide a group ID, this is set to `default`. You must provide a group ID when using the Apicurio Registry REST API, Java client, or Maven plug-in. 
|`artifactId`
|string
|Unique identifier of an artifact in {registry}. You can provide an artifact ID or use the UUID generated by {registry}, for example, `8d168cad-1865-4e6c-bb7e-04e8be005bea`. Different versions of an artifact use the same artifact ID, but have different global IDs.
|`artifactType`
|ArtifactType
|The supported artifact type, for example, `AVRO`, `OPENAPI`, or `PROTOBUF`.
|===


.{registry} editable metadata
[.table-expandable,width="100%",cols="1,1,2",options="header"]
|===
|Property
|Type
|Description
|`name`
|string
|Optional human-readable name of the artifact, for example, `My first Avro schema`.
|`description`
|string
|Optional meaningful description of the artifact, for example, `This is a simple OpenAPI for testing`.
|`labels`
| map
|Optional list of user-defined name-value pairs associated with the artifact. The name and value must be strings, for example, `my-key` and `my-value`.
|`owner`
|string
|The name of the user who owns the artifact.
|===

.Updating artifact metadata
* You can use the {registry} REST API or web console to update the set of editable metadata properties.

[role="_additional-resources"]
.Additional resources
For more details, see the `/groups/\{groupId\}/artifacts/\{artifactId\}` endpoint in the {registry-rest-api}.
