### Qline Error Format Example

Source: https://www.instapaper.com/developers/v1/full-api

Shows the structure for error messages returned in the deprecated qline format.

```text
type=error&error_code=1240&message=Invalid%20URL%20specified
```

--------------------------------

### Verify Credentials Response

Source: https://www.instapaper.com/developers/v1/full-api

Example of the output when verifying user credentials, returning a JSON array containing a user object.

```json
[{"type":"user","user_id":54321,"username":"TestUserOMGLOL"}]
```

--------------------------------

### Qline Format Example

Source: https://www.instapaper.com/developers/v1/full-api

Illustrates the structure of data returned in the deprecated qline format, where array items are encoded as URL query-string-like lines separated by newlines.

```text
type=user&user_id=543210&username=TestUserOMGLOL
type=bookmark&bookmark_id=1234&url=http%3A%2F%2Fwww.example.com%2Fpage1.html&title=Example%20page%201&description=An%20example%20page.
type=bookmark&bookmark_id=1235&url=http%3A%2F%2Fwww.example.com%2Fpage2.html&title=Example%20page%202&description=Another%20example%20page.
type=bookmark&bookmark_id=1236&url=http%3A%2F%2Fwww.example.com%2Fpage3.html&title=Example%20page%203&description=Yet%20another%20example%20page.
```

--------------------------------

### Example API Output (JSON)

Source: https://www.instapaper.com/developers/v1/full-api

This is an example of the JSON output format for Instapaper API responses, showcasing different item types like user, bookmark, and highlight.

```json
[
    {
        "type":"user",
        "user_id":543210,
        "username":"TestUserOMGLOL"
    },
    {
        "type":"bookmark",
        "bookmark_id":1234,
        "url":"http:\/\/www.example.com\/page1.html",
        "title":"Example page 1",
        "description":"An example page.",
        "tags": [{"id": 12, "name": "Example Tag"}]
    },
    {
        "type":"bookmark",
        "bookmark_id":1235,
        "url":"http:\/\/www.example.com\/page2.html",
        "title":"Example page 2",
        "description":"Another example page."
    },
    {
        "type":"highlight",
        "highlight_id":42,
        "bookmark_id":1234,
        "text":"example page",
        "position":0,
        "time":1394470555
    }
]


```

--------------------------------

### OAuth Access Token Response

Source: https://www.instapaper.com/developers/v1/full-api

Example of the response format for obtaining an OAuth access token, which is a single-line qline-like output containing the token and secret.

```text
oauth_token=aabbccdd&oauth_token_secret=efgh1234
```

--------------------------------

### Example API Error Output (JSON)

Source: https://www.instapaper.com/developers/v1/full-api

This is an example of how errors are returned by the Instapaper API in JSON format, including an error code and a descriptive message.

```json
[{"type":"error", "error_code":1240, "message":"Invalid URL specified"}]

```

--------------------------------

### Get Bookmark Text

Source: https://www.instapaper.com/developers/v1/full-api

Returns the specified bookmark's processed text-view HTML, which is always `text/html` encoded as UTF-8. This endpoint is for personal use only.

```APIDOC
## GET /api/1/bookmarks/get_text

### Description
Returns the specified bookmark's processed text-view HTML, which is always `text/html` encoded as UTF-8. This endpoint is for personal use only. All other applications should use the Instaparser API to extract article content.

### Method
GET

### Endpoint
/api/1/bookmarks/get_text

### Parameters
#### Query Parameters
- **bookmark_id** (string) - Required - The ID of the bookmark.

### Response
#### Success Response (200)
- HTML with an HTTP 200 OK status, not the standard API output structures.
```

--------------------------------

### Get OAuth Access Token

Source: https://www.instapaper.com/developers/v1/full-api

Obtains an OAuth access token for a user by providing their authentication credentials.

```APIDOC
## POST /api/1/oauth/access_token

### Description
Gets an OAuth access token for a user.

### Method
POST

### Endpoint
/api/1/oauth/access_token

### Parameters
#### Header Parameters
- **x_auth_username** (string) - Required - The user's username.
- **x_auth_password** (string) - Required - The user's password, if the account has one.
- **x_auth_mode** (string) - Required - Must be the value "client_auth".

### Response
#### Success Response (200)
- **oauth_token** (string) - The OAuth access token.
- **oauth_token_secret** (string) - The OAuth access token secret.

### Response Example
```
oauth_token=aabbccdd&oauth_token_secret=efgh1234
```
```

--------------------------------

### Basic Bookmark IDs for 'have' Parameter

Source: https://www.instapaper.com/developers/v1/full-api

Provide a comma-separated list of bookmark IDs that the client already possesses. Instapaper will omit these from the output.

```text
12345,12346,12347
```

--------------------------------

### Add Folder

Source: https://www.instapaper.com/developers/v1/full-api

Creates an organizational folder.

```APIDOC
## POST /api/1/folders/add

### Description
Creates an organizational folder.

### Method
POST

### Endpoint
/api/1/folders/add

### Parameters
#### Query Parameters
- **title** (string) - Required - The title of the new folder.

### Response
#### Success Response (200)
- The newly created folder.
```

--------------------------------

### Create Highlight

Source: https://www.instapaper.com/developers/v1/full-api

Create a new highlight for a specific bookmark. Non-subscribers are limited to 5 highlights per month.

```APIDOC
## POST /api/1.1/bookmarks/<bookmark-id>/highlight

### Description
Create a new highlight for a specific bookmark. HTML tags in the `text` parameter should be unescaped. Non-subscribers are limited to 5 highlights per month.

### Method
POST

### Endpoint
/api/1.1/bookmarks/<bookmark-id>/highlight

### Parameters
#### Path Parameters
- **bookmark-id** (string) - Required - The ID of the bookmark.
#### Query Parameters
- **text** (string) - Required - The text for the highlight.
- **position** (integer) - Optional - The 0-indexed position of text in the content. Defaults to 0.

### Response
#### Success Response (200)
- The created highlight.
```

--------------------------------

### Bookmark IDs with Hashes, Progress, and Timestamp for 'have' Parameter

Source: https://www.instapaper.com/developers/v1/full-api

Provide bookmark IDs with hashes, reading progress (0.0-1.0), and the timestamp of the progress recording. Instapaper will update bookmarks if the server's information is less recent.

```text
12345:OjMuzFp6:0.5:1288584076
```

--------------------------------

### Qline Parsing Pseudocode

Source: https://www.instapaper.com/developers/v1/full-api

Provides pseudocode for parsing the deprecated qline format, demonstrating how to split lines and key-value pairs, and URL-decode values.

```pseudocode
objects = {}
for each line in input.split("\n"):
    attributes = {}
    for each pair in line.split("&"):
        parts = pair.split("=");
        attributes[parts[0]] = url_decode(parts[1]);

    if (attributes[type] is set) objects.append(attributes)

return objects
```

--------------------------------

### Bookmarks List JSON Output

Source: https://www.instapaper.com/developers/v1/full-api

Illustrates the JSON structure for the bookmarks list endpoint, including user information, bookmarks, highlights, and deleted IDs. Note that highlight text HTML is returned unescaped.

```json
{
    "user":{<user object>},
    "bookmarks":[{<bookmark 1>}, ... ],
    "highlights":[{<highlight 1>}, ... ],
    "delete_ids":[<list of deleted bookmark IDs>]
}
```

--------------------------------

### Move Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Moves the specified bookmark to a user-created folder.

```APIDOC
## POST /api/1/bookmarks/move

### Description
Moves the specified bookmark to a user-created folder.

### Method
POST

### Endpoint
/api/1/bookmarks/move

### Parameters
#### Query Parameters
- **bookmark_id** (string) - Required - The ID of the bookmark to move.
- **folder_id** (string) - Required - The ID of the destination folder.

### Response
#### Success Response (200)
- The modified bookmark on success.
```

--------------------------------

### Set Folder Order

Source: https://www.instapaper.com/developers/v1/full-api

Re-orders a user's folders by providing a comma-separated string of folder IDs and their desired positions. All folders must be included for consistent ordering. Invalid or missing IDs/positions are ignored.

```text
100:1,200:2,300:3
```

```text
100:3,200:2,300:1
```

```text
300:1,100:3,200:2
```

--------------------------------

### List Highlights

Source: https://www.instapaper.com/developers/v1/full-api

List highlights for a specific bookmark.

```APIDOC
## GET /api/1.1/bookmarks/<bookmark-id>/highlights

### Description
List highlights for a specific bookmark. HTML in highlight text is returned unescaped through the API.

### Method
GET

### Endpoint
/api/1.1/bookmarks/<bookmark-id>/highlights

### Parameters
#### Path Parameters
- **bookmark-id** (string) - Required - The ID of the bookmark.

### Response
#### Success Response (200)
- An array of highlights for the specified bookmark.
```

--------------------------------

### List Folders

Source: https://www.instapaper.com/developers/v1/full-api

Retrieves a list of the account's user-created folders. This only includes organizational folders and does not include RSS-feed folders or starred-subscription folders.

```APIDOC
## GET /api/1/folders/list

### Description
Retrieves a list of the account's user-created folders. This only includes organizational folders and does not include RSS-feed folders or starred-subscription folders.

### Method
GET

### Endpoint
/api/1/folders/list

### Parameters
None.

### Response
#### Success Response (200)
- A list of the account's user-created folders.
```

--------------------------------

### Verify Credentials

Source: https://www.instapaper.com/developers/v1/full-api

Verifies the currently logged-in user's credentials and returns user information.

```APIDOC
## GET /api/1/account/verify_credentials

### Description
Returns the currently logged in user.

### Method
GET

### Endpoint
/api/1/account/verify_credentials

### Response
#### Success Response (200)
- **type** (string) - The type of the object, expected to be "user".
- **user_id** (integer) - The unique identifier for the user.
- **username** (string) - The username of the user.

### Response Example
```json
[
  {
    "type": "user",
    "user_id": 54321,
    "username": "TestUserOMGLOL"
  }
]
```
```

--------------------------------

### Unstar Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Un-stars the specified bookmark.

```APIDOC
## POST /api/1/bookmarks/unstar

### Description
Un-stars the specified bookmark.

### Method
POST

### Endpoint
/api/1/bookmarks/unstar

### Parameters
#### Query Parameters
- **bookmark_id** (string) - Required - The ID of the bookmark to unstar.

### Response
#### Success Response (200)
- The modified bookmark on success.
```

--------------------------------

### Set Folder Order

Source: https://www.instapaper.com/developers/v1/full-api

Re-orders a user's folders.

```APIDOC
## POST /api/1/folders/set_order

### Description
Re-orders a user's folders.

### Method
POST

### Endpoint
/api/1/folders/set_order

### Parameters
#### Query Parameters
- **order** (string) - Required - A set of `folder_id:position` pairs joined by commas, where the position is a positive integer 32 bits or less. Example input: `100:1,200:2,300:3`.

### Response
#### Success Response (200)
- The user's re-ordered folder list.
```

--------------------------------

### Archive Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Moves the specified bookmark to the Archive.

```APIDOC
## POST /api/1/bookmarks/archive

### Description
Moves the specified bookmark to the Archive.

### Method
POST

### Endpoint
/api/1/bookmarks/archive

### Parameters
#### Query Parameters
- **bookmark_id** (string) - Required - The ID of the bookmark to archive.

### Response
#### Success Response (200)
- The modified bookmark on success.
```

--------------------------------

### Bookmark IDs with Hashes for 'have' Parameter

Source: https://www.instapaper.com/developers/v1/full-api

Include bookmark IDs combined with their respective hashes. Instapaper will omit these bookmarks unless their metadata has changed.

```text
12345:OjMuzFp6,12346:0n4ONgYs,12347:YXo82wTR
```

--------------------------------

### List Bookmarks

Source: https://www.instapaper.com/developers/v1/full-api

Lists the user's unread bookmarks and can synchronize reading positions. Supports filtering by folder and tag.

```APIDOC
## GET /api/1/bookmarks/list

### Description
Lists the user's unread bookmarks, and can also synchronize reading positions.

### Method
GET

### Endpoint
/api/1/bookmarks/list

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - A number between 1 and 500, default 25.
- **folder_id** (string) - Optional - Possible values are `unread` (default), `starred`, `archive`, or a `folder_id` value from `/api/1.1/folders/list`.
- **tag** (string) - Optional - Tag name for list of bookmarks. Only used when folder_id is not provided.
- **have** (string) - Optional - A concatenation of `bookmark_id` values that the client already has from the specified folder.
- **highlights** (string) - Optional - A '-' delimited list of highlight IDs that the client already has from the specified bookmarks.

### Response
#### Success Response (200)
- **user** (object) - User object.
- **bookmarks** (array) - An array of bookmark objects.
- **highlights** (array) - An array of highlight objects.
- **delete_ids** (array) - A list of deleted bookmark IDs.

### Response Example
```json
{
    "user":{<user object>},
    "bookmarks":[{<bookmark 1>}, ... ],
    "highlights":[{<highlight 1>}, ... ],
    "delete_ids":[<list of deleted bookmark IDs>]
}
```

**Warning:** HTML in highlight text is returned unescaped through the API.
```

--------------------------------

### Add Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Adds a new unread bookmark to the user's account. This can include a URL, title, description, folder, and tags. Optionally, full HTML content can be supplied for pages Instapaper cannot crawl.

```APIDOC
## POST /api/1/bookmarks/add

### Description
Adds a new unread bookmark to the user's account. If the URL already exists, it will be moved to the top of the Unread list and updated with new details.

### Method
POST

### Endpoint
/api/1/bookmarks/add

### Parameters
#### Query Parameters
- **url** (string) - Required, except when using private sources. The URL of the item to bookmark.
- **title** (string) - Optional. The title of the item. If omitted, Instapaper will look it up.
- **description** (string) - Optional. A brief, plaintext description or summary of the article.
- **folder_id** (integer) - Optional. The ID of the folder to save the bookmark in.
- **resolve_final_url** (integer) - Optional, default `1`. Set to `1` to resolve redirects, `0` otherwise.
- **archived** (integer) - Optional, default `0`. Set to `1` to archive the item while adding.
- **tags** (array) - Optional. JSON array of tags with format `[{'name': 'Tag Name'}]`.
- **content** (string) - Optional. The full HTML content of the page, used for pages Instapaper cannot crawl.
- **is_private_from_source** (string) - Optional. Set to a non-empty string to mark the bookmark as private. Requires `content` parameter.

### Request Example
```json
{
  "url": "http://example.com",
  "title": "Example Domain",
  "description": "This is a sample description.",
  "folder_id": 123,
  "resolve_final_url": 1,
  "archived": 0,
  "tags": [{"name": "example"}],
  "content": "<html><body><h1>Example</h1></body></html>",
  "is_private_from_source": "email"
}
```

### Response
#### Success Response (200)
- **bookmark** (object) - The bookmark object on success.

#### Response Example
```json
{
  "bookmark": {
    "id": 12345,
    "type": "bookmark",
    "url": "http://example.com",
    "title": "Example Domain",
    "description": "This is a sample description.",
    "created": 1678886400,
    "added_timestamp": 1678886400,
    "media_type": "website",
    "is_private": 0,
    "private_source": "",
    "archive_timestamp": null,
    "folder_id": 123,
    "tags": ["example"]
  }
}
```

### Error Handling
- **1220: Domain requires full content to be supplied** - The domain requires the `content` parameter.
- **1221: Domain has opted out of Instapaper compatibility** - The publisher does not permit Instapaper usage for this domain.
```

--------------------------------

### Unarchive Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Moves the specified bookmark to the top of the Unread folder.

```APIDOC
## POST /api/1/bookmarks/unarchive

### Description
Moves the specified bookmark to the top of the Unread folder.

### Method
POST

### Endpoint
/api/1/bookmarks/unarchive

### Parameters
#### Query Parameters
- **bookmark_id** (string) - Required - The ID of the bookmark to unarchive.

### Response
#### Success Response (200)
- The modified bookmark on success.
```

--------------------------------

### JSONP Callback for Instapaper API

Source: https://www.instapaper.com/developers

Use this format when passing a Javascript function name as the `jsonp` parameter to the Add or Authenticate methods to receive results as JSON.

```javascript
callbackName({"status":200});
```

--------------------------------

### Authenticate User

Source: https://www.instapaper.com/developers/v1/simple-api

This method validates an Instapaper username and password. It's useful for checking credentials without adding a URL.

```APIDOC
## POST /api/authenticate

### Description
Validates Instapaper credentials.

### Method
POST

### Endpoint
https://www.instapaper.com/api/authenticate

### Parameters
#### Query Parameters
- **username** (string) - Required - The Instapaper username.
- **password** (string) - Required - The Instapaper password.
- **jsonp** (string) - Optional - Callback for JSONP requests.

### Request Example
```
https://www.instapaper.com/api/authenticate?username=YOUR_USERNAME&password=YOUR_PASSWORD
```

### Response
#### Success Response (200)
- **Status Code**: 200 OK

#### Error Responses
- **Status Code**: 403 Invalid username or password.
- **Status Code**: 500 The service encountered an error.
```

--------------------------------

### JSONP Add Response with URL

Source: https://www.instapaper.com/developers/v1/simple-api

If the Add method returns a 201 status, the JSONP response will include a `url` field indicating the added URL. This is useful for confirming the added content.

```javascript
callbackName({"status":201,"url":"whatever-you-sent"});

```

--------------------------------

### Parameter Encoding

Source: https://www.instapaper.com/developers/v1/simple-api

It is crucial to properly encode parameters when making API requests. Failure to do so, especially with credentials, can lead to errors.

```APIDOC
## Parameter Encoding Guidelines

### Description
Instapaper API requires parameters to be URL-encoded. This applies to both GET query strings and POST request bodies.

### Recommendation
If you are crafting your GET query-string or POST request-body manually, ensure that all values are properly URL-encoded to prevent issues, particularly with credentials.
```

--------------------------------

### JSONP Support for API Calls

Source: https://www.instapaper.com/developers/v1/simple-api

Instapaper API supports JSONP for receiving results as JSON to a specified callback function. Pass a valid Javascript function name as the `jsonp` parameter to Add or Authenticate endpoints.

```APIDOC
## JSONP Response Format

### Description
When using the `jsonp` parameter, the API returns Javascript with an HTTP 200 status code.

### Response Example (Standard)
```javascript
callbackName({"status":200});
```

### Response Example (Add Endpoint with URL)
When the Add endpoint returns a 201 status, a `url` value is also included.
```javascript
callbackName({"status":201,"url":"whatever-you-sent"});
```

### Note
Any of the possible `status` values from the Add or Authenticate methods may be returned.
```

--------------------------------

### Authenticate User

Source: https://www.instapaper.com/developers

This method validates an Instapaper username and password. It's useful for checking credentials before performing other actions.

```APIDOC
## POST /api/authenticate

### Description
Validates an Instapaper username and password. Useful for checking credentials without adding a URL.

### Method
POST

### Endpoint
https://www.instapaper.com/api/authenticate

### Parameters
#### Query Parameters
- **username** (string) - Required - The Instapaper username.
- **password** (string) - Required - The Instapaper password. If the account does not have a password, any value works.
- **jsonp** (string) - Optional - Callback function name for JSONP requests.

Authentication can also be done via HTTP Basic Auth using the username and password.

### Response
#### Success Response (200)
OK

#### Error Responses
- **403** : Invalid username or password.
- **500** : The service encountered an error. Please try again later.
```

--------------------------------

### Star Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Stars a specified bookmark. This action modifies the bookmark's status.

```APIDOC
## POST /api/1/bookmarks/star

### Description
Stars the specified bookmark.

### Method
POST

### Endpoint
/api/1/bookmarks/star

### Parameters
#### Query Parameters
- **bookmark_id** (integer) - Required. The ID of the bookmark to star.

### Response
#### Success Response (200)
- **bookmark** (object) - The modified bookmark on success.

#### Response Example
```json
{
  "id": 12345,
  "type": "bookmark",
  "url": "http://example.com",
  "title": "Example Domain",
  "description": "This is a sample description.",
  "created": 1678886400,
  "added_timestamp": 1678886400,
  "media_type": "website",
  "is_private": 0,
  "private_source": "",
  "archive_timestamp": null,
  "folder_id": null,
  "tags": [],
  "starred": 1
}
```
```

--------------------------------

### Add URL to Instapaper

Source: https://www.instapaper.com/developers

Adds a URL to the user's Instapaper account. This is the primary function of the Simple API.

```APIDOC
## POST /api/add

### Description
Adds a URL to an Instapaper account. If the URL already exists, it will be marked unread and moved to the top of the list.

### Method
POST

### Endpoint
https://www.instapaper.com/api/add

### Parameters
#### Query Parameters
- **username** (string) - Required - The Instapaper username.
- **password** (string) - Required - The Instapaper password. If the account does not have a password, any value works.
- **url** (string) - Required - The URL to add to Instapaper.
- **title** (string) - Optional - Plain text, UTF-8. If omitted, Instapaper will crawl the URL to detect a title.
- **selection** (string) - Optional - Plain text, UTF-8. A description for the item, e.g., the source text.
- **redirect** (string) - Optional - If set to `close`, displays a "Saved!" notification that attempts to close its own window.
- **jsonp** (string) - Optional - Callback function name for JSONP requests.

Authentication can also be done via HTTP Basic Auth using the username and password.

### Response
#### Success Response (201)
This URL has been successfully added to this Instapaper account.

**Response Headers**
- **Content-Location** : The saved URL for the newly created item.
- **X-Instapaper-Title** : The saved title for the page.

#### Error Responses
- **400** : Bad request or exceeded the rate limit. Likely missing a required parameter like `url`.
- **403** : Invalid username or password.
- **500** : The service encountered an error. Please try again later.
```

--------------------------------

### JSONP Response with URL on 201 Status

Source: https://www.instapaper.com/developers

When the Add method returns a 201 status, a `url` value is included to indicate the URL that was added. This is also returned via JSONP.

```javascript
callbackName({"status":201,"url":"whatever-you-sent"});
```

--------------------------------

### Update Read Progress

Source: https://www.instapaper.com/developers/v1/full-api

Updates the user's reading progress on a single article. This functionality is also available via the 'have' parameter in the /api/1.1/bookmarks/list operation, but this method allows for separate calls.

```APIDOC
## POST /api/1/bookmarks/update_read_progress

### Description
Updates the user's reading progress on a single article.

### Method
POST

### Endpoint
/api/1/bookmarks/update_read_progress

### Parameters
#### Request Body
- **bookmark_id** (integer) - Required - The bookmark to update.
- **progress** (float) - Required - The user's progress, as a floating-point number between 0.0 and 1.0, defined as the top edge of the user's current viewport, expressed as a percentage of the article's total length.
- **progress_timestamp** (integer) - Required - The Unix timestamp value of the time that the progress was recorded.

### Response
#### Success Response (200)
- The modified bookmark on success.
```

--------------------------------

### Delete Highlight

Source: https://www.instapaper.com/developers/v1/full-api

Delete a highlight.

```APIDOC
## POST /api/1.1/highlights/<highlight-id>/delete

### Description
Delete a highlight.

### Method
POST

### Endpoint
/api/1.1/highlights/<highlight-id>/delete

### Parameters
#### Path Parameters
- **highlight-id** (string) - Required - The ID of the highlight to delete.

### Response
#### Success Response (200)
- None.
```

--------------------------------

### Delete Folder

Source: https://www.instapaper.com/developers/v1/full-api

Deletes the folder and moves any articles in it to the Archive.

```APIDOC
## POST /api/1/folders/delete

### Description
Deletes the folder and moves any articles in it to the Archive.

### Method
POST

### Endpoint
/api/1/folders/delete

### Parameters
#### Query Parameters
- **folder_id** (string) - Required - The ID of the folder to delete.

### Response
#### Success Response (200)
- An empty array on success.
```

--------------------------------

### Add URL to Instapaper

Source: https://www.instapaper.com/developers/v1/simple-api

Adds a URL to an Instapaper account. If the URL already exists, it will be marked unread and moved to the top of the list.

```APIDOC
## POST /api/add

### Description
Adds a URL to an Instapaper account.

### Method
POST

### Endpoint
https://www.instapaper.com/api/add

### Parameters
#### Query Parameters
- **username** (string) - Required - The Instapaper username.
- **password** (string) - Required - The Instapaper password.
- **url** (string) - Required - The URL to add.
- **title** (string) - Optional - Plain text title of the URL. If omitted, Instapaper will crawl the URL to detect a title.
- **selection** (string) - Optional - Plain text selection from the URL, used as a description.
- **redirect** (string) - Optional - If set to `close`, displays a "Saved!" notification that attempts to close its own window.
- **jsonp** (string) - Optional - Callback for JSONP requests.

### Request Example
```
https://www.instapaper.com/api/add?username=YOUR_USERNAME&password=YOUR_PASSWORD&url=http://example.com&title=Example%20Title&selection=This%20is%20a%20selection.
```

### Response
#### Success Response (201)
- **Status Code**: 201 Created. The URL has been successfully added.
- **Content-Location** (header) - The saved URL.
- **X-Instapaper-Title** (header) - The saved title.

#### Error Responses
- **Status Code**: 400 Bad request or exceeded the rate limit. Missing required parameter.
- **Status Code**: 403 Invalid username or password.
- **Status Code**: 500 The service encountered an error.
```

--------------------------------

### JSONP Callback Response

Source: https://www.instapaper.com/developers/v1/simple-api

When using the `jsonp` parameter, the API returns a Javascript snippet with a 200 status code. Ensure your callback function can handle this format.

```javascript
callbackName({"status":200});

```

--------------------------------

### Delete Bookmark

Source: https://www.instapaper.com/developers/v1/full-api

Permanently deletes a specified bookmark. This action is irreversible and distinct from archiving.

```APIDOC
## POST /api/1/bookmarks/delete

### Description
Permanently deletes the specified bookmark. This is not the same as archiving.

### Method
POST

### Endpoint
/api/1/bookmarks/delete

### Parameters
#### Query Parameters
- **bookmark_id** (integer) - Required. The ID of the bookmark to delete.

### Response
#### Success Response (200)
- An empty array on success.

#### Response Example
```json
[]
```
```

--------------------------------

### JSONP Response Format

Source: https://www.instapaper.com/developers

When using the `jsonp` parameter, the API returns a JavaScript response with an HTTP 200 status code. The response includes a callback function with a JSON object containing a status.

```APIDOC
## JSONP Response

### Description
Receives results as JSON to a specified callback function by passing a valid Javascript function name as the `jsonp` parameter to Add or Authenticate.

### Method
GET or POST (for Add or Authenticate)

### Endpoint
`/api/add` or `/api/authenticate` (with `jsonp` parameter)

### Parameters
#### Query Parameters
- **jsonp** (string) - Required - A valid Javascript function name for the callback.

### Response
#### Success Response (200)
- **status** (integer) - The status code of the operation.

### Response Example (200)
```javascript
callbackName({"status":200});
```

#### Success Response (201 - for Add)
- **status** (integer) - The status code of the operation.
- **url** (string) - The URL that was added.

### Response Example (201)
```javascript
callbackName({"status":201,"url":"whatever-you-sent"});
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.