Skip to main content

Build your first Proset API request

In this tutorial, we will create a developer API key and use it to make one request to the Proset API. When we finish, we will have confirmed that the API can read data from our own account.

We will use the command line, but the same steps apply to any tool that can send an HTTP request.

Before we start​

Make sure that:

  • you are signed in to Proset;
  • you have the app open, on a device or in a browser; and
  • you can open a terminal or another tool for sending requests.

The developer API is available to every signed-in user at no additional cost.

Open the developer settings​

  1. Open Settings.
  2. Open Developer.

The screen shows two addresses you can connect to:

  • REST API — the address for making direct requests;
  • MCP server — the address for connecting an AI assistant.

Create an API key​

  1. Select Create key.
  2. Choose an expiry. The default is 90 days.
  3. Select Create.

Proset shows the full key once. Copy it now and store it somewhere safe. Proset keeps only a one-way hash, so it cannot show the key again.

Make your first request​

Open a terminal and run:

curl https://proset.ai/api/v1/me \
  -H "Authorization: Bearer YOUR_KEY"

Replace YOUR_KEY with the key you copied.

The response is a short piece of JSON that describes your account, your plan, and your current usage. If you see your own details, the request succeeded.

Confirm the result​

The response proves three things:

  1. The key is valid.
  2. The request reached Proset.
  3. The API returned data from your own account only.

If the response instead shows invalid_api_key or expired_api_key, create a new key and try again.

Go further​

You have completed the core path. Now you can:

To understand when to choose the REST API or the MCP server, read Why use the developer API and MCP server.