{"info":{"_postman_id":"e142af73-4210-46ee-9bd3-2a632f9585e3","name":"Pastes.io- API","description":"

Pastes.io - API for https://pastes.io

\n

pastes.io is a simple and efficient pastebin for mainly code to be distributed neatly and efficiently across the web. Website where you can paste and store any type of text or code snippets online and share it with your friends.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25405096","collectionId":"e142af73-4210-46ee-9bd3-2a632f9585e3","publishedId":"2sAYX2Mirg","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-07-12T23:43:44.000Z"},"item":[{"name":"Get Paste","id":"60d38930-bcaa-41a4-a8d5-68c871f0b532","request":{"method":"GET","header":[],"url":"https://pastes.io/api/pastes/","description":"

Get the paste and its metadata. This can only be used for pastes that are not protected by passwords. If the paste is protected by password, please use the POST version of this API to pass in the password.

\n

URL parameter:

\n
    \n
  1. slug - this is required URL parameter which must be slug of your paste you want to delete. For example, if the paste URL is https://pastes.io/test-42644, then slug is \"test-42644\"
    2. \n
\n

Possible Good API Responses:

\n
{\n    \"success\": {\n        \"title\": \"Test\",\n        \"slug\": \"test-42644\",\n        \"syntax\": \"txt\",\n        \"expire_time\": 1792953990216,\n        \"status\": 2,\n        \"views\": 5,\n        \"extension\": \"txt\",\n        \"created_at\": 1761417919171,\n        \"content\": \"Hello world\",\n        \"url\": \"https://pastes.io/test-42644\"\n    }\n}\n\n

Possible Bad API Responses:

\n
{\n    \"error\": \"Paste not found\"\n}\n{\n    \"error\": \"You are not allowed to access this paste\"\n}\n{\n    \"error\": \"You are not allowed to access private paste\"\n}\n{\n    \"error\": \"Paste is expired\"\n}\n{\n    \"error\": \"Invalid password\"\n}\n\n
","urlObject":{"protocol":"https","path":["api","pastes",""],"host":["pastes","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"60d38930-bcaa-41a4-a8d5-68c871f0b532"},{"name":"Get Raw Paste","id":"fc96859d-59eb-4cc5-97dc-4840514d47f8","request":{"method":"GET","header":[],"url":"https://pastes.io/raw/","description":"

Get the paste's raw data

\n

URL parameter:

\n
    \n
  1. slug - this is required URL parameter which must be slug of your paste you want to delete. For example, if the paste URL is https://pastes.io/test-42644, then slug is \"test-42644\"
    2. \n
\n

Query parameter:

\n
    \n
  1. (Optional) password - provides the password for password protected pastes, such as https://raw.pastesio.com/test-42644?password=secret1234
    2. \n
\n

Header:

\n
    \n
  1. (Optional) x-password - provides the password for password protected pastes. This is more secured than using query parameter since it will not be exposed in the URL.
    2. \n
\n

Possible Good API Responses (Raw content of the paste):

\n
Hello world\n\n

Possible Bad API Responses:

\n
{\n    \"error\": \"Paste not found\"\n}\n{\n    \"error\": \"You are not allowed to access this paste\"\n}\n{\n    \"error\": \"This paste is password protected\"\n}\n{\n    \"error\": \"Paste is expired\"\n}\n{\n    \"error\": \"Invalid password\"\n}\n\n
","urlObject":{"protocol":"https","path":["raw",""],"host":["pastes","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"fc96859d-59eb-4cc5-97dc-4840514d47f8"},{"name":"Get Paste (with password)","id":"3fa6dcda-d353-4f4e-81ff-efe35fd7a5fb","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"password\": \"1234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://pastes.io/api/pastes/","description":"

Include all the following POST body when you request the url:

\n
    \n
  1. password - password of the paste you want requesting (Optional if paste is not password protected)
    2. \n
\n

URL parameter:

\n
    \n
  1. slug - this is required URL parameter which must be slug of your paste you want to delete. For example, if the paste URL is https://pastes.io/test-42644, then slug is \"test-42644\"
    2. \n
\n

Possible Good API Responses:

\n
{\n    \"success\": {\n        \"title\": \"Test\",\n        \"slug\": \"test-42644\",\n        \"syntax\": \"txt\",\n        \"expire_time\": 1792953990216,\n        \"status\": 2,\n        \"views\": 5,\n        \"extension\": \"txt\",\n        \"created_at\": 1761417919171,\n        \"content\": \"Hello world\",\n        \"url\": \"https://pastes.io/test-42644\"\n    }\n}\n\n

Possible Bad API Responses:

\n
{\n    \"error\": \"Paste not found\"\n}\n{\n    \"error\": \"You are not allowed to access this paste\"\n}\n{\n    \"error\": \"You are not allowed to access private paste\"\n}\n{\n    \"error\": \"Paste is expired\"\n}\n{\n    \"error\": \"Invalid password\"\n}\n\n
","urlObject":{"protocol":"https","path":["api","pastes",""],"host":["pastes","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"3fa6dcda-d353-4f4e-81ff-efe35fd7a5fb"},{"name":"Paste Create","id":"1641f9a0-c6a7-4123-ac9e-ce8422e61439","request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {api_key}","description":"

API key

\n"}],"body":{"mode":"raw","raw":"{\r\n \"content\": \"this is new paste\",\r\n \"title\": \"My paste\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://pastes.io/api/paste","description":"

This API requires an API key. You can obtain the API key at https://pastes.io/profile. (👑 PRO membership required). Include the API key in the Authorization header as \"Bearer {api_key}\".

\n

Include all the following POST body when you send the request:

\n
    \n

  1. content - this is a required parameter, containing the content of the paste

    \n
    2. \n

  2. title - this is a required parameter which sets paste title

    \n
    3. \n

  3. syntax - this is optional parameter, value must be valid syntax, such as php, javascript, txt, etc.

    \n
    4. \n

  4. (optional) expire - the expiration time. Default to one month. Valid values are

    \n
      \n

    1. 'N' (Never expire)

      \n
      2. \n

    2. '1M' (1 month)

      \n
      3. \n

    3. '1Y' (1 year)

      \n
      4. \n

    4. '1W' (1 week)

      \n
      5. \n

    5. '2W' (2 weeks)

      \n
      6. \n

    6. '1D' (1 day)

      \n
      7. \n

    7. '1H' (1 hour)

      \n
      8. \n

    8. '10M' (10 minutes)

      \n
      9. \n

    9. 'SD' (Self destroy after read)

      \n
      10. \n
    \n
    5. \n

  5. (optional) password - the password for the paste

    \n
    6. \n
\n

Possible Good API Responses:

\n
{\n    \"success\": {\n        \"messages\": \"Paste successfully created\",\n        \"slug\": \"test-42644\",\n        \"paste_url\": \"http://pastes.io/test-42644\"\n    }\n}\n\n
\n

Possible Bad API Responses:

\n
{\n    \"message\": \"Unauthenticated.\"\n}\n\n
","urlObject":{"protocol":"http","path":["api","paste"],"host":["pastes","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"1641f9a0-c6a7-4123-ac9e-ce8422e61439"},{"name":"Paste Delete","id":"429f4347-e2ac-4278-a857-b20551a4ed26","request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer ","description":"

Bearer {api_key}

\n"}],"body":{"mode":"formdata","formdata":[{"key":"slug","value":"my-paste-123","description":"

Required - Slug of your paste that you want to delete

\n","type":"text"}]},"url":"https://pastes.io/api/pastes/","description":"

This API requires an API key. You can obtain the API key at https://pastes.io/profile. (👑 PRO membership required). Include the API key in the Authorization header as \"Bearer {api_key}\".

\n

URL parameter:

\n
    \n
  1. slug - this is required URL parameter which must be slug of your paste you want to delete. For example, if the paste URL is https://pastes.io/test-42644, then slug is \"test-42644\"
    2. \n
\n

Possible Good API Responses:

\n
{\n    \"success\": \"Paste successfully deleted\"\n}\n\n

Possible Bad API Responses:

\n
{\n    \"message\": \"Unauthenticated.\"\n}\n{\n    \"error\": \"Paste not found\"\n}\n\n
","urlObject":{"protocol":"https","path":["api","pastes",""],"host":["pastes","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"429f4347-e2ac-4278-a857-b20551a4ed26"},{"name":"List my pastes","id":"026fabaa-5045-4d15-8596-cf7a7dfe5904","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[]},"url":"http://pastes.io/api/pastes?q","description":"

This API requires an API key. You can obtain the API key at https://pastes.io/profile. Include the API key in the Authorization header as \"Bearer {api_key}\"

\n

This API allows you to list all your pastes. You can optionally provide the q parameter to filter the pastes

\n

Include all the following GET parameters when you request the url:

\n
    \n
  1. q - this will be the keyword you want to search in your pastes
    2. \n
\n

Possible Good API Responses: (example)

\n
{\n    \"data\": [\n        {\n            \"id\": 201203,\n            \"title\": \"Auto-title Generator with Chat Completions\",\n            \"syntax\": \"php\",\n            \"slug\": \"auto-title-generator-with-chat-completions\",\n            \"created_at\": \"2025-10-24T22:43:16.435Z\",\n            \"password\": null,\n            \"expire_time\": null,\n            \"isOwner\": true,\n            \"views\": 3\n        }\n    ]\n}\n\n
\n

Possible Bad API Responses:

\n
{\n    \"error\": {\n        \"keyword\": [\n            \"The keyword must be at least 2 characters.\"\n        ]\n    }\n}\n{\n    \"error\": \"This feature is disabled\"\n}\n\n
","urlObject":{"protocol":"http","path":["api","pastes"],"host":["pastes","io"],"query":[{"description":{"content":"

Optional - search for keywoard in title

\n","type":"text/plain"},"key":"q","value":null}],"variable":[]}},"response":[],"_postman_id":"026fabaa-5045-4d15-8596-cf7a7dfe5904"}]}