An attachment object is identified by two elements:

  1. Its server URI.
  2. Its path on the server URI.

The server URI is defined as the scheme and the authority in URI notation; the attachment path concides with the path in URI notation:

 \_/   \_________/\______________/
  |         |             |
scheme  authority        path

Attachments can be uploaded using the upload API.

    "$schema": "",
    "id": "",
    "title": "attachment",
    "description": "An attachment/artifact JSON schema",
    "type": "object",
    "properties": {
        "server_uri": {
            "type": "string",
            "description": "The URI of the server that is hosting this attachment"
        "path": {
            "type": "string",
            "description": "The path on the server that identifies this attachment"
    "required": ["path"]


  • server_uri: If this field is not specified, it will default to