API Documentation

• Authentication
• Rate Limits
• List all pastes
• Create a new paste
• Retrieve a paste
• Delete a paste

Authentication

The PasteCode Public API uses API tokens to authenticate requests. You can get the API Token in your profile. Authentication to the API is performed using the Bearer auth method in the Authorization header. For example, set Authorization header while using cURL:

curl -H "Authorization: Bearer [API_TOKEN]"

Rate Limits

Public API uses rate limits to help manage the sheer volume of requests we receive. The rate limit is characterized by allowing a maximum number of requests within a time interval. For most of our routes, that limit is 10 requests every 60 seconds. However, we also have routes that have custom rate limits. If the endpoint you are using has a custom rate limit, you will find that information in the documentation of that route.

List all pastes

Lists all current pastes in your account

curl --location 'https://pastecode.dev/api/pastes' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_TOKEN'

Example response:

[
    {
        "url": "https://pastecode.dev/s/5EBCYRbWWp",
        "uuid": "5EBCYRbWWp",
        "title": "Untitled",
        "exposure": "public",
        "expiration": "never",
        "isPassword": false,
        "expirationAt": null,
        "createdAt": "2023-08-25T17:05:36.184Z",
        "updatedAt": "2023-08-25T17:05:36.184Z",
        "pasteFiles": [
            {
                "filename": "paste1.sql",
                "syntax": "tsql",
                "language": "Transact-SQL",
                "code": "DELETE FROM CUSTOMERS \r\nWHERE AGE = 25;",
                "createdAt": "2023-08-25T17:05:36.200Z",
                "updatedAt": "2023-08-25T17:05:36.200Z"
            }
        ]
    }
]

Create a new paste

curl --location 'https://pastecode.dev/api/pastes' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_TOKEN' \
--data '{
    "title": "Title",
    "exposure": "public",
    "expiration": "never",
    "pasteFiles": [
        {
            "syntax": "javascript",
            "code": "console.log(1)"
        },
        {
            "syntax": "tsql",
            "code": "DELETE FROM CUSTOMERS \r\nWHERE AGE = 25;"
        }
    ]
}'

Paste body

Exposure

Expiration - Paste will be removed after this time

Languages

Retrieve a paste

curl --location 'https://pastecode.dev/api/pastes/izT9LekwX6' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_TOKEN'

If the password has been set on the paste, then to get the pasteFiles add to request query parameter ?password=value

Example response:

{
    "url": "https://pastecode.dev/s/izT9LekwX6",
    "uuid": "izT9LekwX6",
    "title": "Title",
    "exposure": "public",
    "expiration": "never",
    "isPassword": false,
    "expirationAt": null,
    "createdAt": "2023-09-02T05:34:10.973Z",
    "updatedAt": "2023-09-02T05:34:10.973Z",
    "pasteFiles": [
        {
            "filename": "file1.js",
            "syntax": "javascript",
            "language": "JavaScript",
            "code": "console.log(1)",
            "createdAt": "2023-09-02T05:34:10.989Z",
            "updatedAt": "2023-09-02T05:34:10.989Z"
        }
    ]
}

Delete a paste

curl --location --request DELETE 'https://pastecode.dev/api/pastes/izT9LekwX6' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_TOKEN'

Response:

{
    "message": "success"
}