xi.pe

Store UTF-8 text at xi.pe and get back a short URL anyone can read. Use it when text has to leave the conversation: someone asks for a shareable link to text you already have -- 'share this', 'give me a URL for it'; something a human needs to read would flood the chat inline -- a long diff, a stack trace, a generated config, a report; or something has to reach another agent, session or machine that does not share your filesystem. Maximum 2 MiB (2,097,152 bytes); larger is rejected, not truncated. Returns url, code, delete_token, size and expires. The delete_token is shown once and is the only way to delete the paste -- pass it to the user verbatim if a human is in the loop. If you are outputting markdown for human reading, highly consider adding ?md to the link you hand back to make it more readable.

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "the UTF-8 text to store. Maximum 2 MiB (2,097,152 bytes), counted as UTF-8 bytes rather than characters. Oversize is rejected with no truncation. No line-length or line-count limit."
    },
    "ttl": {
      "type": "string",
      "description": "how long the paste should live: a number followed by m, h or d (for example 30m, 6h, 3d). Defaults to the 7 day maximum. Cannot be longer than 7d."
    },
    "long": {
      "type": "boolean",
      "description": "use a 23-character code instead of the default 6. Worth it when a lucky guess would actually matter -- credentials, private logs, anything with real consequences if a stranger landed on it."
    }
  },
  "required": [
    "content"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "the URL of the new paste"
    },
    "code": {
      "type": "string",
      "description": "the paste's code"
    },
    "delete_token": {
      "type": "string",
      "description": "the only capability that can delete this paste. Shown once -- surface it verbatim."
    },
    "size": {
      "type": "integer",
      "description": "stored size in bytes"
    },
    "expires": {
      "type": "string",
      "description": "RFC 3339 timestamp after which the paste is gone"
    }
  },
  "required": [
    "url",
    "code",
    "delete_token",
    "size",
    "expires"
  ],
  "additionalProperties": false
}

Delete a xi.pe paste before it expires. Requires the delete_token returned when it was created; there is no other way to prove ownership.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "the paste's code (6 characters, or 23 if created with long), or its full xi.pe URL"
    },
    "delete_token": {
      "type": "string",
      "description": "the delete_token returned when the paste was created"
    }
  },
  "required": [
    "code",
    "delete_token"
  ],
  "additionalProperties": false
}

Fetch the text of an existing xi.pe paste -- including one a user or another agent just handed you. Accepts either the code or the full URL. If you pass the URL on to a human and the text is Markdown, append ?md: it renders headings, tables and ```mermaid diagrams.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "the paste's code (6 characters, or 23 if created with long), or its full xi.pe URL"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}