---
title: "Quickstart"
description: "Discover and invoke one enabled Tooluse.net operation."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

<h2 id="prerequisites">Prerequisites</h2>
<ul>
<li>An application ID such as <code>app_&lt;32-lowercase-hex&gt;</code>.</li>
<li>An enabled operation in that application.</li>
<li>An unexpired application Agent key stored as <code>TOOLUSE_API_KEY</code>.</li>
</ul>
<p>Discover allowed operations</p><pre><code class="language-bash">curl https://api.tooluse.net/v1/agent/applications/app_&lt;32-lowercase-hex&gt;/operations \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"</code></pre><p>Choose one operation</p><p>Read its <code>id</code> and <code>inputSchema</code>. The schema is the request body contract.</p><p>Invoke it once</p><pre><code class="language-bash">curl -X POST \
  https://api.tooluse.net/v1/agent/applications/app_&lt;32-lowercase-hex&gt;/operations/&lt;operation-id&gt;/invoke \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-20260921-01" \
  -d '{"text":"Hello from Tooluse.net"}'</code></pre><p>Send the operation input object directly. Do not wrap it in an <code>input</code> property.</p><p>Read an asynchronous receipt</p><p>If the invocation returns <code>202</code>, use its invocation ID:</p><pre><code class="language-bash">curl https://api.tooluse.net/v1/agent/applications/app_&lt;32-lowercase-hex&gt;/invocations/&lt;invocation-id&gt; \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"</code></pre>
<h2 id="you-should-see">You should see</h2>
<p>Discovery returns <code>operations</code>; invocation returns either a completed service result (<code>200</code>) or an accepted native execution (<code>202</code>). Reusing the same idempotency key returns the recorded invocation instead of dispatching a second effect.</p>
<h2 id="next-step">Next step</h2>
<p><a href="/reference/api#agent-operations-and-actions">Learn how operation discovery and schemas work</a>.</p>

Source: https://help.tooluse.net/getting-started/quickstart/index.mdx