> For the complete documentation index, see [llms.txt](https://docs.junkipedia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.junkipedia.org/getting-started/setting-up-tiplines/configuring-tipline-properties/hosting-an-api-tipline.md).

# Hosting An API Tipline

An API tipline receives tip sent via HTTP request to the tipline's API endpoint. Use the following instructions to complete the process of [Configuring Tipline Properties](/getting-started/setting-up-tiplines/configuring-tipline-properties.md).

If modifying an existing tipline, click the edit link associated with the desired tipline as shown on [the "Manage Tiplines" Page](/getting-started/setting-up-tiplines.md#the-manage-tiplines-page). It will bring up an "Edit Tipline" form similar to the one shown below. If you are in the process of creating a new tipline, you may already see a [form called "New Tipline"](/getting-started/setting-up-tiplines/creating-a-new-tipline.md#the-new-tipline-form) which is similar and will serve the same purpose.

<figure><img src="/files/09ZC0AZdKOxcqX6nNNKz" alt=""><figcaption></figcaption></figure>

#### Choose A Name

The name you provide will distinguish this tipline from others listed on [the "Manage Tiplines" page for your organization](/getting-started/setting-up-tiplines.md#the-manage-tiplines-page).

#### Identifier

Choose an alphanumeric name to represent your tipline which you will then use with the POST /submissions/{tiplineIdentifier} endpoint.

#### Heading

Leave this field blank for this type of tipline.

#### Custom Response

Leave this field blank for this type of tipline.

#### Custom Merged Response

Leave this field blank for this type of tipline.

#### Redirect URL

Leave this field blank for this type of tipline.

#### Tipline Type

Use the pulldown menu to select "API".

#### Include this tipline in your Address Card and QR code?

Leave this box unchecked for this type of tipline.

#### Enabled

Check this box to enable the tipline or uncheck to temporarily deactivate it.

#### Anonymous submissions require approval

Check this box to hold tips for approval when the source of the tip is not identified as a member of your organization.

#### Real submissions require approval

Check this box to hold all tips for approval.

#### Multi-part merge submissions

Leave this box unchecked for this type of tipline.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.junkipedia.org/getting-started/setting-up-tiplines/configuring-tipline-properties/hosting-an-api-tipline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.